פעילות

הצהרת יחסי תלות

כדי להוסיף תלות בפעילות, עליכם להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים הנדרשים בקובץ build.gradle של האפליקציה או המודול:

dependencies {
    def activity_version = "1.9.2"

    // Java language implementation
    implementation "androidx.activity:activity:$activity_version"
    // Kotlin
    implementation "androidx.activity:activity-ktx:$activity_version"
}

dependencies {
    val activity_version = "1.9.2"

    // Java language implementation
    implementation("androidx.activity:activity:$activity_version")
    // Kotlin
    implementation("androidx.activity:activity-ktx:$activity_version")
}

למידע נוסף על יחסי תלות, אפשר לעיין במאמר הוספת יחסי תלות של build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גרסה 1.10

גרסה 1.10.0-alpha03

30 באוקטובר 2024

התכונות androidx.activity:activity:1.10.0-alpha03, androidx.activity:activity-compose:1.10.0-alpha03 וגם androidx.activity:activity-ktx:1.10.0-alpha03 משוחררות. גרסת 1.10.0-alpha03 כוללת את ההוספות האלה.

שינויים ב-API

• נוספה רכיב LocalActivity חדש ברמת האפליקציה שמספק את Activity להיקף הנוכחי, וכך מבטלת את הצורך של המפתחים לקבל Activity מה-LocalContext. הוא כולל גם כלל חדש לזיהוי שגיאות בקוד (lint) שבודק מתי מתבצע הטמעה שגויה של LocalContext ל-Activity. (I7746a, ‏ b/283009666)

תיקוני באגים

• מפעילות 1.9.3: PredictiveBackHandler לא יפעיל יותר את קריאת החזרה שלו אחרי שהמתאם יושבת. הפעולה הזו תפתור בעיה שבה הטקסט NavHost בכתיבת הניווט יציג IndexOutOfBoundsException. (I3f75e, ‏ b/365027664, ‏ b/340202286)

עדכון יחסי תלות

• Activity Compose תלוי עכשיו ב-Compose Runtime 1.7.0‏ (I7746a, ‏ b/283009666)

גרסה 1.10.0-alpha02

4 בספטמבר 2024

androidx.activity:activity:1.10.0-alpha02, androidx.activity:activity-compose:1.10.0-alpha02 ו-androidx.activity:activity-ktx:1.10.0-alpha02 שוחררו. גרסת 1.10.0-alpha02 כוללת את ההוספות האלה.

שינויים בהתנהגות

• אם הכלי לבחירת תמונות במערכת לא זמין, חוזי התוצאות של הפעילות PickVisualMedia ו-PickMultipleVisualMedia שמפעילים את הכלי לבחירת תמונות כבר לא מעבירים את הגישה ישירות ל-Google Play Services, אלא משתמשים בפעולה הציבורית ACTION_SYSTEM_FALLBACK_PICK_IMAGES ובתכונות הנוספות הקשורות כדי לספק חוויית שימוש עקבית בכלי לבחירת תמונות ליצרני ציוד מקורי ולאפליקציות מערכת כחלופה. השינוי הזה לא אמור להשפיע על חוויית המשתמש במכשירים עם גרסה עדכנית של שירותי Google Play. (I3513d)

תיקוני באגים

• הוסרה חלוקה ידנית של הגישה לממשקי API של פלטפורמות חדשות, כי זה קורה באופן אוטומטי באמצעות בניית מודלים של API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל R8 גרסה 3.3) ובכל גרסאות ה-build כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלצים לעדכן ל-D8 בגרסה 8.1 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. (I9496c, ‏ b/345472586)
• מ-Activity 1.9.2: תוקנה בעיה שבה ממשק ה-API PredictiveBackHandler של Activity Compose המשיך לטפל בתנועת החזרה אחורה של המערכת בפריים שבו היא הושבתה. כתוצאה מכך, ספריות כמו Navigation Compose יכלו לטפל בחזרה אחורה גם אם סטאק החזרה אחורה ריק, וכתוצאה מכך הופיעה הודעת השגיאה IndexOutOfBoundsException. (Ie3301, ‏ b/340202286)
• מפעילות 1.9.1: תוקנה בעיה עם PredictiveBackHandler. אחרי שמבצעים חזרה את המערכת, ניסיון לבצע onBackPressed מ-OnBackPressedDispatcher ייכשל. (I5f1f8)

גרסה 1.10.0-alpha01

26 ביוני 2024

androidx.activity:activity:1.10.0-alpha01, androidx.activity:activity-compose:1.10.0-alpha01 ו-androidx.activity:activity-ktx:1.10.0-alpha01 שוחררו. הגרסה הזו מפותחת בהסתעפות פנימית.

תכונות חדשות

• נוספה תמיכה בתכונות חדשות של PhotoPicker שהושקו ב-Android V, כולל היכולת לבחור תמונות לפי סדר ולבחור איזו כרטיסייה (אלבומים או תמונות) תוצג בהתחלה.

גרסה 1.9

גרסה 1.9.3

16 באוקטובר 2024

התכונות androidx.activity:activity:1.9.3, androidx.activity:activity-compose:1.9.3 וגם androidx.activity:activity-ktx:1.9.3 משוחררות. גרסה 1.9.3 כוללת את ההוספות האלה.

תיקוני באגים

• PredictiveBackHandler לא יפעיל יותר את הקריאה החוזרת שלו לאחר שה-handler הושבת. הפעולה הזו תפתור בעיה שבה NavHost מ-Navigation Compose יגרום להודעת השגיאה IndexOutOfBoundsException. (I3f75e, ‏ b/340202286)

גרסה 1.9.2

4 בספטמבר 2024

התכונות androidx.activity:activity:1.9.2, androidx.activity:activity-compose:1.9.2 וגם androidx.activity:activity-ktx:1.9.2 משוחררות. גרסה 1.9.2 כוללת את ההתחייבויות האלה.

תיקוני באגים

• תוקנה בעיה שבה ממשק ה-API של PredictiveBackHandler לכתיבה מהירה המשיך לטפל בתנועת החזרה של המערכת במסגרת שבה הוא הושבת. כתוצאה מכך, יכול להיות שספריות כמו 'ניווט בכתיבה' יטפלו בחזרה גם כשה-Back Stack ריק, וכתוצאה מכך התוצאה הייתה IndexOutOfBoundsException. (Ie3301, ‏ b/340202286)

גרסה 1.9.1

24 ביולי 2024

התכונות androidx.activity:activity:1.9.1, androidx.activity:activity-compose:1.9.1 וגם androidx.activity:activity-ktx:1.9.1 משוחררות. גרסה 1.9.1 כוללת את ההוספות האלה.

תיקוני באגים

• תוקנה בעיה ב-PredictiveBackHandler שבה אחרי ביצוע שחזור המערכת, הניסיון לבצע onBackPressed מ-OnBackPressedDispatcher נכשל. (I5f1f8)

גרסה 1.9.0

17 באפריל 2024

התכונות androidx.activity:activity:1.9.0, androidx.activity:activity-compose:1.9.0 וגם androidx.activity:activity-ktx:1.9.0 משוחררות. גרסה 1.9.0 כוללת את ההוספות האלה.

שינויים חשובים מאז 1.8.0

• ComponentActivity מטמיע עכשיו את OnUserLeaveHintProvider כדי לאפשר לרכיבים לבצע קריאות חוזרות לאירועים מסוג onUserLeaveHint.
• בממשקי ה-API OnBackPressedCallback, ‏ BackHandler ו-PredictiveBackHandler מופיעה עכשיו אזהרה כשקוראים ל-onBackPressedDispatcher.onBackPressed() בזמן טיפול בלחצן 'הקודם', כי הפעולה הזו תמיד תפר את האנימציה החזויה של תנועת החזרה. פרטים נוספים זמינים במדריך לשיטות מומלצות.
• שאר ממשקי ה-API של הפעילות נכתבו מחדש ב-Kotlin וכל התוספים שהיו זמינים בעבר ב-activity-ktx הועברו אל activity. activity-ktx ריק לגמרי עכשיו.
  • כחלק מההמרה של ActivityResultLauncher ל-Kotlin, שיטת getContract היא עכשיו נכס מופשט ב-Kotlin. זהו שינוי תואם בינארי, אבל הוא מפר את המקור אם ההטמעה של ActivityResultLauncher נכתבה ב-Kotlin.

גרסה 1.9.0-rc01

3 באפריל 2024

androidx.activity:activity:1.9.0-rc01, androidx.activity:activity-compose:1.9.0-rc01 ו-androidx.activity:activity-ktx:1.9.0-rc01 שוחררו. גרסת 1.9.0-rc01 כוללת את ההוספות האלה.

עדכון יחסי תלות

• הפעילות תלויה עכשיו ב-Profile Installer 1.3.1.

גרסה 1.9.0-beta01

‫20 במרץ 2024

התכונות androidx.activity:activity:1.9.0-beta01, androidx.activity:activity-compose:1.9.0-beta01 וגם androidx.activity:activity-ktx:1.9.0-beta01 משוחררות. גרסת 1.9.0-beta01 כוללת את ההוספות האלה.

תיקוני באגים

• תוקנה נסיגה בביצועים בזמן ההפעלה של פעילות שהופיעה ב-Activity 1.9.0-alpha02 כתוצאה מהקריאה ל-OnBackPressedDispatcher כחלק מהיצירה של הפעילות. (Ie75e3)

גרסה 1.9.0-alpha03

7 בפברואר 2024

התכונות androidx.activity:activity:1.9.0-alpha03, androidx.activity:activity-compose:1.9.0-alpha03 וגם androidx.activity:activity-ktx:1.9.0-alpha03 משוחררות. גרסה 1.9.0-alpha03 מכילה את התחייבויות אלה.

אזהרה על שגיאות בקוד

• בממשקי ה-API OnBackPressedCallback, ‏ BackHandler ו-PredictiveBackHandler מופיעה עכשיו אזהרה כשקוראים ל-onBackPressedDispatcher.onBackPressed() בזמן טיפול בלחצן 'הקודם', כי הפעולה הזו תמיד תפר את האנימציה החזויה של תנועת החזרה. פרטים נוספים זמינים במדריך השיטות המומלצות. (1e4222, 2c950d, b/287505200)

תיקוני באגים

• אם אירוע החזרה נשלח מהמערכת שהתחיל במהלך תנועת חזרה חזויה שכבר פועלת, תנועת החזרה החזויה שרצה כרגע תבוטל ואירוע החזרה החדש יתחיל לפעול כדי להתחיל תנועת חזרה חזויה חדשה. (I3482e)
• תוקנה קריסה שנגרמה בגישה ל-onBackPressedDispatcher מ-ComponentActivity בפעם הראשונה משרשור רקע. עכשיו אפשר להיכנס בבטחה אל onBackPressedDispatcher בכל שרשור. (I79955)

גרסה 1.9.0-alpha02

24 בינואר 2024

התכונות androidx.activity:activity:1.9.0-alpha02, androidx.activity:activity-compose:1.9.0-alpha02 וגם androidx.activity:activity-ktx:1.9.0-alpha02 משוחררות. גרסה 1.9.0-alpha02 מכילה את התחייבויות אלה.

המרות ב-Kotlin

• ActivityResultRegistry נכתב מחדש ב-Kotlin. כך מוודאים שהאפשרות של ערכים ריקים (null) של הפרמטרים הכלליים בחוזה שהועברו ל-register תועבר בצורה נכונה ל-ActivityResultLauncher שיוחזר אליכם. (I121f0)
• ActivityResult נכתב מחדש ב-Kotlin. התוספים של Kotlin‏ ActivityResult שתומכים בפירוק מבנה לשדות resultCode ו-data הועברו מ-activity-ktx אל activity. (I0565a)
• התוספים של Kotlin ל-by viewModels() עבור ComponentActivity ו-trackPipAnimationHintView הועברו מ-activity-ktx אל activity. הארטיפקט activity-ktx ריק לגמרי עכשיו. (I0a444)

תיקוני באגים

• ממשק ה-API של enableEdgeToEdge מצייר עכשיו מסביב לכל חתכים במסך. (a3644b, ‏ b/311173461)
• מפעילות 1.8.2: תוקן ה-extra שהוענק ל-ACTION_SYSTEM_FALLBACK_PICK_IMAGES של חוזה הפעילות של 'בחירת תמונה', כדי להעביר לו בצורה נכונה את המפתח EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX, במקום להשתמש ב-extra עם המפתח "com.google.android.gms.provider.extra.PICK_IMAGES_MAX". יצרני ציוד מקורי (OEM) שמטמיעים כלי בחירה של תמונות כחלופה למערכת מומלצים מאוד לתמוך בשני התוספים כדי להבטיח את התאימות הרחבה ביותר. (I96a00)

גרסה 1.9.0-alpha01

29 בנובמבר 2023

androidx.activity:activity:1.9.0-alpha01, androidx.activity:activity-compose:1.9.0-alpha01 ו-androidx.activity:activity-ktx:1.9.0-alpha01 שוחררו. גרסה 1.9.0-alpha01 מכילה את ההוספות האלה.

תכונות חדשות

• ComponentActivity מטמיעים עכשיו את OnUserLeaveHintProvider כדי לאפשר לרכיבים לבצע קריאה חוזרת (callback) עבור אירועי onUserLeaveHint. (I54892)

שינויים ב-API

• ComponentActivity נכתב/ה ב-Kotlin. (I14f31)
• ActivityResultCaller נכתב מחדש ב-Kotlin. (Ib02e4)
• ActivityResultLauncher נכתב מחדש ב-Kotlin. כחלק מההמרה הזו, השיטה getContract היא עכשיו נכס קולטין מופשט. זהו שינוי תואם בינארי, אבל הוא מפר את המקור אם ההטמעה של ActivityResultLauncher נכתבה ב-Kotlin. (Id4615)
• רמת ה-API המינימלית של PickVisualMediaRequest היא עכשיו 19, כמו זו של חוזה PickVisualMedia Activity Result. (Id6e21)

עדכון יחסי תלות

• הפעילות תלויה עכשיו ב-Core 1.13.0-alpha01. (I14f31)

גרסה 1.8

גרסה 1.8.2

13 בדצמבר 2023

התכונות androidx.activity:activity:1.8.2, androidx.activity:activity-compose:1.8.2 וגם androidx.activity:activity-ktx:1.8.2 משוחררות. גרסה 1.8.2 כוללת את השמירות האלה.

תיקוני באגים

• תוקן הרכיב הנוסף שהוענק ל-ACTION_SYSTEM_FALLBACK_PICK_IMAGES של חוזה הפעילות של בורר התמונות, כדי להעביר לו בצורה נכונה את המפתח EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX, במקום להשתמש ברכיב הנוסף עם המפתח "com.google.android.gms.provider.extra.PICK_IMAGES_MAX". יצרני ציוד מקורי (OEM) שמטמיעים כלי בחירה של תמונות כחלופה למערכת מומלצים מאוד לתמוך בשני התוספים כדי להבטיח את התאימות הרחבה ביותר. (I96a00)

גרסה 1.8.1

15 בנובמבר 2023

התכונות androidx.activity:activity:1.8.1, androidx.activity:activity-compose:1.8.1 וגם androidx.activity:activity-ktx:1.8.1 משוחררות. גרסה 1.8.1 מכילה את השינויים האלה.

תיקוני באגים

• OnBackPressedDispatcher ממשיך לשלוח את האירוע ל-OnBackPressedCallback הנכון גם אחרי שמתווסף OnBackPressedCallback חדש בזמן הטיפול בתנועת החזרה. (Id0ff6)

גרסה 1.8.0

4 באוקטובר 2023

התכונות androidx.activity:activity:1.8.0, androidx.activity:activity-compose:1.8.0 וגם androidx.activity:activity-ktx:1.8.0 משוחררות. גרסה 1.8.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז גרסה 1.7.0

• חיזוי תנועת החזרה – OnBackPressedCallback מציע עכשיו קריאות חוזרות חדשות של חיזוי תנועת החזרה לטיפול בהתחלה של תנועת החזרה, בהתקדמות במהלך התנועה ובביטול של תנועת החזרה, בנוסף לקריאה החוזרת הקודמת של handleOnBackPressed() לזמן שבו תנועת החזרה מתבצעת. הגרסה הזו כוללת גם את הקומפוזבילי PredictiveBackHandler לטיפול באירועי חיזוי של תנועת החזרה ב'כתיבה'. הוא מספק זרימה של אובייקטים מסוג BackEventCompat שצריך לאסוף במסגרת ה-lamba של ההשעיה שאתם מספקים:

  PredictiveBackHandler { progress: Flow<BackEventCompat> ->
    // code for gesture back started
    try {
      progress.collect { backEvent ->
      // code for progress
    }
    // code for completion
    } catch (e: CancellationException) {
      // code for cancellation
    }
  }

ComponentActivity.onBackPressed() הוצא משימוש לטובת ממשקי ה-API לטיפול בבקשות חזרה. עכשיו המפתחים צריכים להשתמש ב-OnBackPressedDispatcher במקום לשנות את השיטה הזו.

• EdgeToEdge – הוספה של ComponentActivity.enableEdgeToEdge() כדי להגדיר בקלות את המסך לאורך כל המסך באופן תואם לאחור.

גרסה 1.8.0-rc01

20 בספטמבר 2023

התכונות androidx.activity:activity:1.8.0-rc01, androidx.activity:activity-compose:1.8.0-rc01 וגם androidx.activity:activity-ktx:1.8.0-rc01 משוחררות. גרסה 1.8.0-rc01 כוללת את השמירות האלה.

גרסה 1.8.0-beta01

6 בספטמבר 2023

התכונות androidx.activity:activity:1.8.0-beta01, androidx.activity:activity-compose:1.8.0-beta01 וגם androidx.activity:activity-ktx:1.8.0-beta01 משוחררות. גרסה 1.8.0-beta01 כוללת את ההצהרות האלה.

שיפור מסמכי התיעוד

• שיפרנו את המסמכים של BackEventCompat. (aosp/2722254)

גרסה 1.8.0-alpha07

23 באוגוסט 2023

התכונות androidx.activity:activity:1.8.0-alpha07, androidx.activity:activity-compose:1.8.0-alpha07 וגם androidx.activity:activity-ktx:1.8.0-alpha07 משוחררות. גרסה 1.8.0-alpha07 מכילה את ההוספות האלה.

תכונות חדשות

• נוספה ל-Activity Compose רכיב Composable חדש מסוג PredictiveBackHandler לטיפול באירועים של תנועות חזרה חזויות. הוא מספק Flow של BackEventCompat אובייקטים שצריך לאסוף ב-lambda להשהיה שאתם מספקים:

  PredictiveBackHandler { progress: Flow<BackEventCompat> ->
    // code for gesture back started
    try {
      progress.collect { backEvent ->
      // code for progress
    }
    // code for completion
    } catch (e: CancellationException) {
      // code for cancellation
    }
  }
  

  הוא כולל גם אזהרה בזמן הידור באמצעות כלל איתור שגיאות בקוד (lint) כדי לוודא ש-Flow קורא ל-collect(). (Id2773, ‏ b/294884345)

• עכשיו, onBackPressedDispatcher ב-ComponentActivity מופעל באיטרציה, כך שהוא נוצר רק כשצריך. (I0bf8e)

תיקוני באגים

• ComponentActivity לא יציג יותר שגיאת NPE ב-Android 13 כשיתקבל onBackPressed() קריאה חוזרת והפעילות כבר DESTROYED. (Idb055, ‏ b/291869278)
• הוסרו שימושים ב-API הניסיוני isAtLeastU() (Ie9117, ‏ b/289269026)

גרסה 1.8.0-alpha06

21 ביוני 2023

androidx.activity:activity:1.8.0-alpha06, androidx.activity:activity-compose:1.8.0-alpha06 ו-androidx.activity:activity-ktx:1.8.0-alpha06 שוחררו. גרסה 1.8.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

• המכשיר OnBackPressedDispatcher מבטל עכשיו באופן תקין כל קריאה חוזרת (callback) שיוסרו במהלך תנועת חיזוי חזרה. (I3f90f)

שינויים ב-API

• כשמעבירים את SystemBarStyle.auto ל-API‏ enableEdgeToEdge, עכשיו אפשר לשנות את הפרמטר lambda‏ detectDarkMode כדי לספק לוגיקה מותאמת אישית לזיהוי מצב לילה. (aosp/2546393, b/278263793)

גרסה 1.8.0-alpha05

7 ביוני 2023

התכונות androidx.activity:activity:1.8.0-alpha05, androidx.activity:activity-compose:1.8.0-alpha05 וגם androidx.activity:activity-ktx:1.8.0-alpha05 משוחררות. הגרסה הזו מפותחת בהסתעפות פנימית.

שינויים ב-API

• Activity מספק עכשיו את הכיתה BackEventCompat שמייצגת גרסה תואמת לאחור של BackEvent, שמופרדת מהכיתה BackEvent של המסגרת.
• שינוי תוכנה זדונית: השיטות handleOnBackStarted ו-handleOnBackProgressed של OnBackPressedCallback מקבלות עכשיו מופע androidx.activity.BackEventCompat במקום מחלקה android.window.BackEvent של framework. גם ממשקי ה-API המקבילים של @VisibleForTesting ב-OnBackPressedDispatcher עודכנו.
• ה-constructor של OnBackPressedDispatcher מקבל עכשיו מופע Consumer<Boolean> אופציונלי שמאפשר לבעלים של המפנה לקבל קריאה חוזרת (callback) בכל פעם שמספר הקריאות החוזרות המופעלות משתנה מאפס למספר שונה מאפס או להפך.

תיקוני באגים

• מפעילות 1.7.2: תיקון קריסה של ReportDrawn במהלך ניווט ממסך לפני הקריאה ל-report. (Ic46f1, ‏ b/260506820)

גרסה 1.8.0-alpha04

10 במאי 2023

התכונות androidx.activity:activity:1.8.0-alpha04, androidx.activity:activity-compose:1.8.0-alpha04 וגם androidx.activity:activity-ktx:1.8.0-alpha04 משוחררות. הוא שוחרר מהסתעפות פנימית.

תיקוני באגים

• מפעילות 1.7.1: – אין יותר דליפה מ-ReportFullyDrawExecuter כשמשתמשים ב-ComponentActivity עם ActivityScenario. (Id2ff2, b/277434271)

גרסה 1.8.0-alpha03

12 באפריל 2023

androidx.activity:activity:1.8.0-alpha03, androidx.activity:activity-compose:1.8.0-alpha03 ו-androidx.activity:activity-ktx:1.8.0-alpha03 שוחררו. הגרסה הזו שוחררה מענף פנימי.

תכונות חדשות

• הוספנו את ComponentActivity.setUpEdgeToEdge() כדי להגדיר בקלות את התצוגה מקצה לקצה באופן תואם לאחור.

שינויים ב-API

• ComponentActivity.onBackPressed() הוצא משימוש לטובת ממשקי ה-API לטיפול בבקשות חזרה. מפתחים צריכים להשתמש עכשיו ב-OnBackPressedDispatcher במקום לשנות את השיטה הזו. (Ibce2f, ‏ b/271596918)
• ComponentDialog ו-ComponentActivity מכילים עכשיו API ציבורי initViewTreeOwners() שיכול לשמש לאתחול כל הבעלים של עץ התצוגה לפני ההגדרה של תצוגת התוכן. (Ibdce0, ‏ b/261314581)

תיקוני באגים

• תוקנה בעיה שבה קטעי Fragment (משבצות) ביטלו באופן שגוי את התוקף של רכיבי MenuHost (מארחי תפריטים), וכתוצאה מכך התפריט הפעיל בפעילות הראה התנהגות לא צפויה. (I9404e, ‏ b/244336571)

שינויים אחרים

• ב-ActivityResultRegister נעשה עכשיו שימוש ב-Kotlin Random במקום ב-Java. (I4d98f, ‏ b/272096025)

גרסה 1.8.0-alpha02

8 במרץ 2023

התכונות androidx.activity:activity:1.8.0-alpha02, androidx.activity:activity-compose:1.8.0-alpha02 וגם androidx.activity:activity-ktx:1.8.0-alpha02 משוחררות. פיתוח מענף פנימי.

עדכון בנושא תלות

• מפעילות 1.7.0-rc01: הפעילות תלויה עכשיו ב-Lifecycle 2.6.0.

גרסה 1.8.0-alpha01

8 בפברואר 2023

התכונות androidx.activity:activity:1.8.0-alpha01, androidx.activity:activity-compose:1.8.0-alpha01 וגם androidx.activity:activity-ktx:1.8.0-alpha01 משוחררות. ה-build הזה נוצר מענף פנימי.

תכונות חדשות

• הכיתה OnBackPressedCallback מכילה עכשיו קריאות חוזרות חדשות (callbacks) של התקדמות של תנועת החזרה לחיזוי לטיפול בהתחלה של תנועת החזרה, בהתקדמות במהלך תנועת החזרה ובביטול של תנועת החזרה, בנוסף לקריאה החוזרת הקודמת handleOnBackPressed() לזמן שבו תנועת החזרה מתבצעת.

גרסה 1.7

גרסה 1.7.2

24 במאי 2023

התכונות androidx.activity:activity:1.7.2, androidx.activity:activity-compose:1.7.2 וגם androidx.activity:activity-ktx:1.7.2 משוחררות. גרסה 1.7.2 כוללת את השמירות האלה.

תיקוני באגים

• תיקון קריסה של ReportDrawn כשמנווטים מהמסך לפני שמפעילים את report. (Ic46f1, b/260506820)

גרסה 1.7.1

19 באפריל 2023

androidx.activity:activity:1.7.1, androidx.activity:activity-compose:1.7.1 ו-androidx.activity:activity-ktx:1.7.1 שוחררו. גרסה 1.7.1 כוללת את השינויים האלה.

תיקוני באגים

• אין יותר דליפה של ReportFullyDrawExecuter כשמשתמשים ב-ComponentActivity עם ActivityScenario. (Id2ff2, ‏ b/277434271)

גרסה 1.7.0

22 במרץ 2023

התכונות androidx.activity:activity:1.7.0, androidx.activity:activity-compose:1.7.0 וגם androidx.activity:activity-ktx:1.7.0 משוחררות. גרסה 1.7.0 כוללת את השמירות האלה.

שינויים חשובים מאז 1.6.0

• החוזים של הכלי לבחירת תמונות ב-PickVisualMedia וב-PickMultipleVisualMedia עודכנו ועכשיו הם כוללים אפשרות נוספת למקרים שבהם MediaStore.ACTION_PICK_IMAGES לא זמין. החוזים האלה מאפשרים ליצרני ציוד מקורי (OEM) ולאפליקציות מערכת, כמו Google Play Services – לספק חוויה עקבית של בוחר התמונות במגוון רחב יותר של מכשירי Android ורמות API. לשם כך, צריך להטמיע את פעולת הגיבוי. הכלי לבחירת תמונות ישתמש באפשרות החלופית הזו אם היא זמינה, לפני שיעבור לשימוש ב-Intent.ACTION_OPEN_DOCUMENT, שעדיין תומך בכל המכשירים עם API מגרסה 19 ומעלה.
• ComponentDialog מטמיע את SavedStateRegistryOwner ויש לו גישה ל-SavedStateRegistry משלו ומגדיר את SavedStateRegistryOwner ל-ViewTree שלו. עכשיו אפשר להשתמש ב-Jetpack Compose ב-ComponentDialog כי הוא עומד בדרישות של LifecycleOwner ושל SavedStateRegistryOwner שמצורפים לחלון באמצעות ממשקי ה-API של ViewTree.
• עכשיו אפשר להגדיר מספר דגלים ב-IntentSenderRequest.Builder.setFlags() מ-Intent, במקום רק דגל אחד.

המרה של Kotlin

מספר כיתות Activity הומרו ל-Kotlin. כל הכיתות שהועברו עדיין שומרות על תאימות הבינארית שלהן לגרסאות קודמות. בכיתות הבאות יש שינויים לא תואמים למקור של כיתות שנכתבו ב-Kotlin: ActivityResultRegistryOwner, ‏ OnBackPressedDispatcherOwner.

בטבלה הבאה מפורטים מקורות ההמרות בגרסה החדשה של 'פעילות':

גם הכיתות האלה הומרו ל-Kotlin, אבל ימשיכו להיות תואמות למקור: ContextAware, ContextAwareHelper, OnContextAvailableListener, IntentSenderRequest ו-OnBackPressedDispatcher

ממשקי API של FullyDrawnReporter

עכשיו יש ב-ComponentActivity מופע של FullyDrawnReporter שמאפשר למספר רכיבים לדווח כשהם מוכנים לאינטראקציה. ComponentActivity יחכה עד שכל הרכיבים יסתיימו לפני שיפעיל את reportFullyDrawn() בשמכם. ממשקי ה-API האלה מטפלים בדרישות התזמון עבורך, ואין צורך להפעיל אותם כחלק משליחת קריאה ל-onDraw.

מומלץ להפעיל את ממשקי ה-API האלה:

• שליחת אות ל-Android Runtime בסיום ההפעלה, כדי לוודא שכל הקוד שפועל במהלך רצף הפעלה של כמה פריימים נכלל בעדיפות גבוהה לצורך הידור ברקע.
• שליחת אות ל-Macrobenchmark ול-Play Vitals כשהאפליקציה נחשבת כמוצגת במלואה למדדי ההפעלה הראשונית, כדי שתוכלו לעקוב אחרי הביצועים.

נוספו שלושה ממשקי API של Activity Compose כדי שיהיה נוח יותר להשתמש ב-FullyDrawnReporter בתכנים קומפוזביליים נפרדים:

• ReportDrawn מציין שהתוכן הקומפוזבילי מוכן לאינטראקציה.
• ReportDrawnWhen מקבלת תנאי (למשל, list.count > 0) כדי לציין מתי התוכן הקומפוזבילי מוכן לאינטראקציה.
• ReportDrawnAfter מקבלת שיטה להשהיה, וכשהיא מסתיימת, היא מציינת שאתם מוכנים לאינטראקציה.

עדכונים בנושא תלות

• הפעילות תלויה עכשיו במחזור חיים 2.6.1. (8fc31d)
• הפעילות תלויה עכשיו ב-ProfileInstaller 1.3.0. (83d3b1)

גרסה 1.7.0-rc01

8 במרץ 2023

התכונות androidx.activity:activity:1.7.0-rc01, androidx.activity:activity-compose:1.7.0-rc01 וגם androidx.activity:activity-ktx:1.7.0-rc01 משוחררות. גרסה 1.7.0-rc01 כוללת את השמירות האלה.

עדכון בנושא תלות

• הפעילות תלויה עכשיו ב-Lifecycle 2.6.0.

גרסה 1.7.0-beta02

22 בפברואר 2023

התכונות androidx.activity:activity:1.7.0-beta02, androidx.activity:activity-compose:1.7.0-beta02 וגם androidx.activity:activity-ktx:1.7.0-beta02 משוחררות. גרסה 1.7.0-beta02 מכילה את התחייבויות אלה.

שינויים ב-API

• הפעולה והפרמטר הנוסף שמשמשים את החוזים PickVisualMedia ו-PickMultipleVisualMedia כחלופה במקרה ש-MediaStore.ACTION_PICK_IMAGES לא זמין הם עכשיו קבועים ציבוריים שמספקים יציבות ל-API של יצרני ציוד מקורי ואפליקציות מערכת שרוצים לספק חוויה עקבית של 'כלי הבחירה של Google Photos'. ההטמעה של חלופת הגיבוי הזו עדיין מוגבלת רק לאפליקציות מערכת. (Icd320)

גרסה 1.7.0-beta01

8 בפברואר 2023

התכונות androidx.activity:activity:1.7.0-beta01, androidx.activity:activity-compose:1.7.0-beta01 וגם androidx.activity:activity-ktx:1.7.0-beta01 משוחררות. גרסה 1.7.0-beta01 כוללת את ההצהרות האלה על ביצוע שינויים.

תכונות חדשות

• עכשיו אפשר להגדיר מספר דגלים ב-IntentSenderRequest.Builder.setFlags() מ-Intent, במקום רק דגל אחד. (Iac04c)

תיקוני באגים

• חלופת החירום של PickVisualMedia למקרה שהכלי לבחירת תמונות ב-Framework לא זמין מגבילה עכשיו בצורה נכונה את הטיפול לאפליקציות שמותקנות בתמונת המערכת של המכשיר. (If8ae6)

המרות של Kotlin

• ActivityResultRegistryOwner נכתב עכשיו ב-Kotlin. זהו שינוי לא תואם למקור עבור הכיתות שנכתבו ב-Kotlin – עכשיו צריך לשנות את ברירת המחדל של המאפיין activityResultRegistry במקום להטמיע את הפונקציה הקודמת getActivityResultRegistry(). (I0b00e)
• OnBackPressedDispatcherOwner נכתב עכשיו ב-Kotlin. זהו שינוי לא תואם למקור עבור הכיתות שנכתבו ב-Kotlin – עכשיו צריך לשנות את ברירת המחדל של המאפיין onBackPressedDispatcher במקום להטמיע את הפונקציה הקודמת getOnBackPressedDispatcher. (Ia277d)
• ContextAware, ‏ ContextAwareHelper, ‏ OnContextAvailableListener, ‏ IntentSenderRequest וגם OnBackPressedDispatcher נכתבים עכשיו ב-Kotlin. (I1a73e, ‏ Iada92, ‏ aosp/2410754, ‏ I18ac7, ‏ b/257291701)

גרסה 1.7.0-alpha04

25 בינואר 2023

התכונות androidx.activity:activity:1.7.0-alpha04, androidx.activity:activity-compose:1.7.0-alpha04 וגם androidx.activity:activity-ktx:1.7.0-alpha04 משוחררות. גרסה 1.7.0-alpha04 מכילה את ההצהרות האלה על ביצוע שינויים.

תכונות חדשות

• בהסכמי תוצאות הפעילות PickVisualMedia ו-PickMultipleVisualMedia, המערכת תשתמש מעכשיו בכלי לבחירת תמונות שמסופק על ידי Google Play Services, אם הוא זמין, במקרים שבהם המערכת של Android מספקת כלי לבחירת תמונות (למשל, MediaStore.ACTION_PICK_IMAGES) לא זמין. ה-API ‏isPhotoPickerAvailable() שמזהה רק את הכלי לבחירת תמונות שסופק על ידי מערכת Android הוצא משימוש. מומלץ להשתמש ב-API החדש isPhotoPickerAvailable(Context), שיחזיר נתונים אם אחד מהכלי לבחירת תמונות יהיה זמין. (I55be6)

גרסה 1.7.0-alpha03

11 בינואר 2023

התכונות androidx.activity:activity:1.7.0-alpha03, androidx.activity:activity-compose:1.7.0-alpha03 וגם androidx.activity:activity-ktx:1.7.0-alpha03 משוחררות. גרסה 1.7.0-alpha03 כוללת את ההצהרות האלה.

תכונות חדשות

• עכשיו ל-ComponentDialog יש הטמעה של SavedStateRegistryOwner, יש לו גישה ל-SavedStateRegistry שלו והוא מגדיר את SavedStateRegistryOwner ל-ViewTree שלו. עכשיו אפשר להשתמש ב-Jetpack פיתוח נייטיב בתוך ComponentDialog כי הוא עומד גם ב-LifecycleOwner וגם ב-SavedStateRegistryOwner שמצורפים לחלון דרך דרישות ממשקי ה-API של ViewTree. (Idca17, ‏ I73468 b/261162296)

שינויים ב-API

• נוספה רכיב ReportDrawn שסומן באופן מיידי את הפעילות כ'מוכנה לקריאה ל-reportFullyDrawn'. (Ic5b14, ‏ b/259687964)

המרות ב-Kotlin

• הכיתות ActvitiyResultCallback ו-OnBackPressedCallback הומרו ל-Kotlin תוך שמירה על תאימות למקור ולקובץ הבינארי. (Ifc5e5, ‏ Ide1b0, ‏ b/257291701)

גרסה 1.7.0-alpha02

24 באוקטובר 2022

התכונות androidx.activity:activity:1.7.0-alpha02, androidx.activity:activity-compose:1.7.0-alpha02 וגם androidx.activity:activity-ktx:1.7.0-alpha02 משוחררות. גרסה 1.7.0-alpha02 מכילה את התחייבויות אלה.

תיקוני באגים

• מפעילות 1.6.1: תוקנה בעיה שבה חוזה התוצאה של הפעילות PickMultipleVisualMedia לא הופעל במכשירי Android R כשמשתמשים בערך ברירת המחדל של maxItems. (Ie2776, ‏ b/249182130)

גרסה 1.7.0-alpha01

5 באוקטובר 2022

התכונות androidx.activity:activity:1.7.0-alpha01, androidx.activity:activity-compose:1.7.0-alpha01 וגם androidx.activity:activity-ktx:1.7.0-alpha01 משוחררות. גרסה 1.7.0-alpha01 מכילה את התחייבויות אלה.

ממשקי API של FullyDrawnReporter

עכשיו יש ב-ComponentActivity מופע של FullyDrawnReporter שמאפשר למספר רכיבים לדווח כשהם מוכנים לאינטראקציה. ComponentActivity יחכה עד שכל הרכיבים יסתיימו לפני שיפעיל את reportFullyDrawn() בשמכם. ממשקי ה-API האלה מטפלים בדרישות התזמון עבורך, ואין צורך להפעיל אותם כחלק משליחת קריאה ל-onDraw.

מומלץ להפעיל את ממשקי ה-API האלה:

• שליחת אות ל-Android Runtime בסיום ההפעלה, כדי לוודא שכל הקוד שפועל במהלך רצף הפעלה של כמה פריימים נכלל בעדיפות גבוהה לצורך הידור ברקע.
• שליחת אות ל-Macrobenchmark ול-Play Vitals כשהאפליקציה נחשבת כמוצגת במלואה למדדי ההפעלה הראשונית, כדי שתוכלו לעקוב אחרי הביצועים.

נוספו שני ממשקי API של Activity Compose כדי שיהיה נוח יותר להשתמש ב-FullyDrawnReporter בתכנים קומפוזביליים נפרדים:

• ReportDrawnWhen מקבלת תנאי (למשל, list.count > 0) כדי לציין מתי הרכיב המודולרי מוכן לאינטראקציה.
• ReportDrawnAfter מקבלת שיטה להשהיה, וכשהיא מסתיימת, היא מציינת שאתם מוכנים לאינטראקציה.

גרסה 1.6.1

גרסה 1.6.1

24 באוקטובר 2022

androidx.activity:activity:1.6.1, androidx.activity:activity-compose:1.6.1 ו-androidx.activity:activity-ktx:1.6.1 שוחררו. גרסה 1.6.1 כוללת את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

• תוקנה בעיה שבה חוזה התוצאה של הפעילות PickMultipleVisualMedia לא הופעל במכשירי Android R כשמשתמשים בערך ברירת המחדל של maxItems. (Ie2776, b/249182130)

גרסה 1.6.0

גרסה 1.6.0

21 בספטמבר 2022

התכונות androidx.activity:activity:1.6.0, androidx.activity:activity-compose:1.6.0 וגם androidx.activity:activity-ktx:1.6.0 משוחררות. גרסה 1.6.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז 1.5.0

• הוספנו את ActivityResultContracts.PickVisualMedia ו-ActivityResultContracts.PickMultipleVisualMedia כדי לספק חוזה עם תאימות לאחור, שמשתמש ב-MediaStore.ACTION_PICK_IMAGES כשבורר התמונות זמין וב-Intent.ACTION_OPEN_DOCUMENT כשהוא לא זמין.
• הטמעת את OnBackInvokedCallback ב-Android 13 ב-OnBackPressedDispatchers של ComponentActivity ו-ComponentDialog. כך מוודאים שכל ממשקי ה-API שמבוססים על OnBackPressedDispatcher יפעלו כשמפעילים תנועת חזרה חזותית.

גרסה 1.6.0-rc02

7 בספטמבר 2022

התכונות androidx.activity:activity:1.6.0-rc02, androidx.activity:activity-compose:1.6.0-rc02 וגם androidx.activity:activity-ktx:1.6.0-rc02 משוחררות. גרסה 1.6.0-rc02 מכילה את ההתחייבויות האלה.

תיקוני באגים

• OnBackPressedDispatcher רושם עכשיו את OnBackInvokedCallback עם PRIORITY_DEFAULT במקום PRIORITY_OVERLAY. (I3901f)
• מעכשיו, תמיד יישלחו שתי הפונקציות החוזרות של onMultiWindowModeChanged() בכיתות שמתבססות על ComponentActivity. (Ic4d85)
• הפונקציה ActivityResultRegistry לא תחזיר יותר תוצאה לפונקציה ActivityResultCallback כשהקריאה ל-launch תגרום להשלכת Exception והקריאה החוזרת (callback) נרשמה ללא LifecycleOwner. (Ia7ff7, ‏ b/238350794)
• עכשיו ComponentActivity תפנה כראוי את הקריאות לתפריט בלי צורך לקרוא לפונקציית הסופר בפעילות. (Ie33c5, ‏ b/238057118)

עדכון יחסי תלות

• עכשיו הספרייה Activity תלויה ב-Lifecycle 2.5.1. (If6697)

גרסה 1.6.0-rc01

24 באוגוסט 2022

התכונות androidx.activity:activity:1.6.0-rc01, androidx.activity:activity-compose:1.6.0-rc01 וגם androidx.activity:activity-ktx:1.6.0-rc01 משוחררות. גרסה 1.6.0-rc01 כוללת את השמירות האלה.

תיקוני באגים

• לא תהיה יותר בעיה של ClassVerificationError כשמפעילים את OnBackPressedDispatcher בגרסאות SDK שקודמות ל-33. (Ic32e1)
• מעכשיו, תמיד יישלחו קריאות חזרה (callbacks) של כיתות שמחליפות את קריאת החזרה (callback) onPictureInPictureModeChanged() של ComponentActivity. (Ib7fdb)

גרסה 1.6.0-beta01

10 באוגוסט 2022

androidx.activity:activity:1.6.0-beta01, androidx.activity:activity-compose:1.6.0-beta01 ו-androidx.activity:activity-ktx:1.6.0-beta01 שוחררו. גרסה 1.6.0-beta01 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

שינויים ב-API

• השיטות startActivityForResult ו-startIntentSenderForResult שהוצאו משימוש ב-ComponentActivity עם @NonNull סומנו כי העברה של null תמיד גרמה לקריסה. (Id2a25, b/231476082)

תיקוני באגים

• מפעילות 1.5.1: ה-ActivityResultRegistry לא יחזיר יותר תוצאה ל-ActivityResultCallback כשהקריאה ל-launch תגרום להשלכה של Exception והקריאה החוזרת (call back) נרשמה ללא LifecycleOwner. (Ia7ff7, ‏ b/238350794)
• מפעילות 1.5.1: ComponentActivity יפנה עכשיו כראוי את הקריאות לתפריט להחרגות של onPrepareOptionMenu(),‏ onCreateOptionsMenu() ו-onOptionsItemSelected(), בלי צורך לקרוא לפונקציית הסופר. (Ie33c5, b/238057118)

עדכון יחסי תלות

• מפעילות 1.5.1: הספרייה Activity תלויה עכשיו בגרסה 2.5.1 של Lifecycle. (If6697)

גרסה 1.6.0-alpha05

15 ביוני 2022

androidx.activity:activity:1.6.0-alpha05, androidx.activity:activity-compose:1.6.0-alpha05 ו-androidx.activity:activity-ktx:1.6.0-alpha05 שוחררו. הגרסה 1.6.0-alpha05 פותחה בהסתעפות פרטית לפני השקה, ואין לה התחייבויות ציבוריות.

שינויים ב-API

• הערך של minCompileSdk הוא עכשיו 33 כדי להתאים ל-SDK של Tiramisu Beta 3

תיקוני באגים

• תוקן קריסה במכשירים ישנים יותר במהלך בדיקת התוסף של ה-SDK עבור PickVisualMedia ActivityResultContract, כך שהוא אמור לפעול עכשיו עם ACTION_OPEN_DOCUMENT במכשירים עם Android מגרסה 10 ומטה.

גרסה 1.6.0-alpha04

18 במאי 2022

androidx.activity:activity:1.6.0-alpha04 ו-androidx.activity:activity-ktx:1.6.0-alpha04 משוחררים.

תיקוני באגים

• תוקנה שגיאה ב-PickVisualMediaRequest שבה ניסיון ליצור בקשה, דרך ה-Builder או דרך פונקציית Kotlin ברמה העליונה, היה מוביל לחריגה מ-stack.
• שילבנו את OnBackInvokedCallback ב-Android 13 Dev Beta 2 ב-OnBackPressedDispatcher שסופק על ידי ComponentDialog. כך מוודאים שכל ממשקי ה-API שנוצרו על סמך OnBackPressedDispatcher יפעלו כשמפעילים את האפשרות של תנועת חזרה חזוי.

גרסה 1.6.0-alpha03

27 באפריל 2022

התכונות androidx.activity:activity:1.6.0-alpha03, androidx.activity:activity-compose:1.6.0-alpha03 וגם androidx.activity:activity-ktx:1.6.0-alpha03 משוחררות.

• הערה: הגרסה הזו תעבור הידור רק אחרי SDK של Android 13 Developer Beta 1.

תכונות חדשות

• הוספנו את ActivityResultContracts.PickVisualMedia ו-ActivityResultContracts.PickMultipleVisualMedia כדי לספק חוזה עם תאימות לאחור, שמשתמש ב-MediaStore.ACTION_PICK_IMAGES כשבורר התמונות זמין וב-Intent.ACTION_OPEN_DOCUMENT כשהוא לא זמין.
• שילבו את OnBackInvokedCallback ב-Android 13 Dev Beta 1 ב-OnBackPressedDispatcher שסופק על ידי ComponentActivity. כך מוודאים שכל ממשקי ה-API שנוצרו על סמך OnBackPressedDispatcher יפעלו כשמפעילים את האפשרות של תנועת חזרה חזוי.

גרסה 1.6.0-alpha01

23 במרץ 2022

התכונות androidx.activity:activity:1.6.0-alpha01, androidx.activity:activity-compose:1.6.0-alpha01 וגם androidx.activity:activity-ktx:1.6.0-alpha01 משוחררות.

• הערה: הגרסה הזו תעבור הידור רק מול Android 13 Developer Preview 2 SDK.

תכונות חדשות

• שינויים ששולבו ב-ComponentActivity מ-Android 13 Dev Preview 2.

גירסה 1.5.1

גירסה 1.5.1

27 ביולי 2022

androidx.activity:activity:1.5.1, androidx.activity:activity-compose:1.5.1 ו-androidx.activity:activity-ktx:1.5.1 שוחררו. גרסה 1.5.1 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

• הפונקציה ActivityResultRegistry לא תחזיר יותר תוצאה ל-ActivityResultCallback כשהקריאה ל-launch() תגרום להשלכת Exception והקריאה החוזרת (call back) נרשמה ללא LifecycleOwner. (Ia7ff7, ‏ b/238350794)

• עכשיו ComponentActivity שולח כראוי קריאות תפריט ל-onPrepareOptionMenu(), ל-onCreateOptionsMenu() ול-onOptionsItemSelected() ללא צורך בקריאה לפונקציית ה-Super. (Ie33c5, ‏ b/238057118)

עדכון בנושא תלות

• הספרייה Activity תלויה עכשיו במחזור החיים 2.5.1. (If6697)

גרסה 1.5.0

גרסה 1.5.0

29 ביוני 2022

androidx.activity:activity:1.5.0, androidx.activity:activity-compose:1.5.0 ו-androidx.activity:activity-ktx:1.5.0 שוחררו. גרסה 1.5.0 כוללת את השמירות האלה.

שינויים חשובים מאז גרסה 1.4.0

• ComponentDialog – ComponentDialog הוא תת-סוג של Dialog שכולל OnBackPressedDispatcher שיופעל כשלוחצים על לחצן החזרה במערכת והתיבת הדו-שיח גלויה. חשוב לציין שהמחלקה המשנית הזו גם מגדירה את ViewTreeOnBackPressedDispatcherOwner, ומאפשרת לתצוגות דרך גנרית לאחזר את המפנה הנכון, בין שהוא קיים ב-ComponentActivity ובין שהוא קיים ב-ComponentDialog.
• ממשקי קריאה חוזרת – ComponentActivity מטמיע עכשיו קבוצה של ממשקי קריאה חוזרת מודולריים שאפשר להשתמש בהם במקום בקריאות החזרה של Activity. הממשקים האלה כוללים את: OnNewIntentProvider, OnConfigurationChangedProvider, OnTrimMemoryProvider, OnPictureInPictureModeChangedProvider, OnMultiWindowModeChangedProvider
• שילוב עם CreationExtras – עכשיו יש ל-ComponentActivity אפשרות לספק ViewModelProvider.Factory ללא מצב (stateless) דרך CreationExtras של 2.5.0 לניהול מחזור חיים.

שינויים אחרים

• ה-constructor ללא פרמטרים של ActivityResultContracts.CreateDocument הוצא משימוש והוחלף ב-constructor חדש שמקבל סוג mime ספציפי (למשל, "image/png") כפי שנדרש על ידי Intent.ACTION_CREATE_DOCUMENT.

גרסה 1.5.0-rc01

11 במאי 2022

הגרסאות androidx.activity:activity:1.5.0-rc01, ‏androidx.activity:activity-compose:1.5.0-rc01 ו-androidx.activity:activity-ktx:1.5.0-rc01 פורסמו ללא שינויים מהגרסה 1.5.0-beta01. גרסה 1.5.0-rc01 כוללת את השמירות האלה.

גרסה 1.5.0-beta01

20 באפריל 2022

התכונות androidx.activity:activity:1.5.0-beta01, androidx.activity:activity-compose:1.5.0-beta01 וגם androidx.activity:activity-ktx:1.5.0-beta01 משוחררות. גרסה 1.5.0-beta01 מכילה את התחייבויות אלה.

עדכוני יחסי תלות

• הפעילות תלויה עכשיו במחזור חיים 2.4.0-beta01.

גרסה 1.5.0-alpha05

6 באפריל 2022

התכונות androidx.activity:activity:1.5.0-alpha05, androidx.activity:activity-compose:1.5.0-alpha05 וגם androidx.activity:activity-ktx:1.5.0-alpha05 משוחררות. גרסה 1.5.0-alpha05 מכילה את ההוספות האלה.

תיקוני באגים

• השיטה onPanelClosed() של ComponentActivity קוראת עכשיו גם ל-super onPanelClosed(), וכך נפתרה בעיה שבה לא הייתה קריאה לשיטה onContextMenuClosed. (Ib6f77)

גרסה 1.5.0-alpha04

23 במרץ 2022

התכונות androidx.activity:activity:1.5.0-alpha04, androidx.activity:activity-compose:1.5.0-alpha04 וגם androidx.activity:activity-ktx:1.5.0-alpha04 משוחררות. גרסה 1.5.0-alpha04 מכילה את ההצהרות האלה.

תיקוני באגים

• עכשיו יש תמיכה ב-SavedStateViewFactory בשימוש ב-CreationExtras גם אם הוא הופעל באמצעות SavedStateRegistryOwner. אם מציינים פרמטרים נוספים, המערכת תתעלם מהארגומנטים שהועברו ל-init. (I6c43b, b/224844583)

גרסה 1.5.0-alpha03

23 בפברואר 2022

התכונות androidx.activity:activity:1.5.0-alpha03, androidx.activity:activity-compose:1.5.0-alpha03 וגם androidx.activity:activity-ktx:1.5.0-alpha03 משוחררות. גרסה 1.5.0-alpha03 מכילה את ההצהרות האלה.

שינויים ב-API

• עכשיו אפשר להעביר את CreationExtras לפונקציה by viewModels() של הפעילות (I6a3e6, ‏ b/217600303)

גרסה 1.5.0-alpha02

9 בפברואר 2022

התכונות androidx.activity:activity:1.5.0-alpha02, androidx.activity:activity-compose:1.5.0-alpha02 וגם androidx.activity:activity-ktx:1.5.0-alpha02 משוחררות. גרסה 1.5.0-alpha02 מכילה את התחייבויות אלה.

תכונות חדשות

• ComponentActivity מטמיע עכשיו את הממשק OnPictureInPictureModeChangedProvider כדי לאפשר לכל רכיב לקבל אירועי שינוי של מצב תמונה בתוך תמונה. (I9f567)
• ComponentActivity מטמיע עכשיו את הממשק OnMultiWindowModeChangedProvider כדי לאפשר לכל רכיב לקבל אירועים של שינוי מצב בחלונות מרובים. (I62d91)

גרסה 1.5.0-alpha01

26 בינואר 2022

התכונות androidx.activity:activity:1.5.0-alpha01, androidx.activity:activity-compose:1.5.0-alpha01 וגם androidx.activity:activity-ktx:1.5.0-alpha01 משוחררות. גרסה 1.5.0-alpha01 כוללת את ההצהרות האלה.

תכונות חדשות

• ComponentActivity משתלב עכשיו עם ViewModel CreationExtras, שהוצג כחלק מ-Lifecycle 2.5.0-alpha01. (Ie7e00, ‏ b/207012584)
• נוספה ComponentDialog, קבוצת משנה של Dialog שכוללת OnBackPressedDispatcher שיופעל כשלוחצים על לחצן החזרה של המערכת כשתיבת הדו-שיח גלויה. חשוב לציין שגם המחלקה המשנית הזו מגדירה את ViewTreeOnBackPressedDispatcherOwner, ומאפשרת לתצוגות לקבל את המפנה הנכון באופן כללי, בין שהוא קיים ב-ComponentActivity ובין שהוא קיים ב-ComponentDialog. I8a1bc
• ComponentActivity מטמיע עכשיו את הממשק החדש OnNewIntentProvider כדי לאפשר לכל רכיב לקבל את האירועים האלה. (If1f8b)
• ComponentActivity מטמיע עכשיו את הממשק החדש OnConfigurationChangedProvider כדי לאפשר לכל רכיב לקבל את האירועים האלה. (If623b)
• ComponentActivity מטמיע עכשיו את הממשק החדש של OnTrimMemoryProvider כדי לאפשר לכל רכיב לקבל את האירועים האלה. (Ia9295)

שינויים ב-API

• ה-constructor ללא פרמטרים של ActivityResultContracts.CreateDocument הוצא משימוש והוחלף ב-constructor חדש שמקבל סוג mime ספציפי (למשל, "image/png") כפי שנדרש על ידי Intent.ACTION_CREATE_DOCUMENT. (I2bec6)
• עכשיו אפשר לאחזר את הערך של OnBackPressedDispatcherOwner שמשויך לתצוגה המפורטת דרך ViewTreeOnBackPressedDispatcherOwner, במקום להסתמך על העברה (cast) של Context. (I74685)

תיקוני באגים

• תוקן קריסה שנגרמה בגישה ל-ViewModel בפעם הראשונה מ-registerForActivityResult() חזרה (callback) או מחזרות (callbacks) ל-LifecycleObserver שנוספו כחלק מ-init של ComponentActivity. (Ife83f)

גרסה 1.4.0

גרסה 1.4.0

27 באוקטובר 2021

התכונות androidx.activity:activity:1.4.0, androidx.activity:activity-compose:1.4.0 וגם androidx.activity:activity-ktx:1.4.0 משוחררות. גרסה 1.4.0 כוללת את ההתחייבויות האלה.

שינויים חשובים מאז גרסה 1.3.0

• AndroidX ComponentActivity מטמיע עכשיו את הממשק MenuHost. כך כל רכיב יכול להוסיף פריטים לתפריט ActionBar על ידי הוספת מופע MenuProvider לפעילות. אפשר להוסיף לכל MenuProvider Lifecycle שישלוט באופן אוטומטי בחשיפה של פריטי התפריט האלה על סמך מצב ה-Lifecycle, ויטפל בהסרת ה-MenuProvider כשה-Lifecycle נהרס.
• המחלקה ActivityResultContract נכתבה מחדש ב-Kotlin כדי להבטיח שמפתחים שכותבים חוזים מותאמים אישית ב-Kotlin יוכלו להגדיר את ערך ה-null הנכון עבור מחלקות הקלט והפלט שלהם.
• הכיתה ActivityResultContracts והחוזים שלה נכתבו מחדש ב-Kotlin כדי להבטיח את הנכונות של הערך null.

גרסה 1.4.0-rc01

13 באוקטובר 2021

התכונות androidx.activity:activity:1.4.0-rc01, androidx.activity:activity-compose:1.4.0-rc01 וגם androidx.activity:activity-ktx:1.4.0-rc01 משוחררות. גרסה 1.4.0-rc01 כוללת את השמירות האלה.

תיקוני באגים

• הפונקציה ActivityResultRegistry לא תחזיר יותר תוצאה ל-ActivityResultCallback כשהקריאה של launch תגרור Exception. (If4f91, ‏ b/200845664)

גרסה 1.4.0-beta01

29 בספטמבר 2021

התכונות androidx.activity:activity:1.4.0-beta01, androidx.activity:activity-compose:1.4.0-beta01 וגם androidx.activity:activity-ktx:1.4.0-beta01 משוחררות. גרסה 1.4.0-beta01 מכילה את התחייבויות אלה.

שינויים ב-API

• תוקן הסוג של ActivityResultContracts.OpenMultipleDocuments ו-ActivityResultContracts.GetMultipleContents שגרם לשימוש בסוג פלט של List<? extends Uri> כשמשתמשים בקוד משפת התכנות Java. (If71de)
• עכשיו אפשר לגשת למשתנים הקבועים הציבוריים בתוך הכיתות ActivityResultContracts.StartActivityForResult, ‏ ActivityResultContracts.StartIntentSenderForResult ו-ActivityResultContracts.RequestMultiplePermissions כשמשתמשים ב-Kotlin, דרך אובייקטי Companion שהם עכשיו ציבוריים. (aosp/1832555)

עדכונים במסמכי התיעוד

• הוספנו פרטים נוספים להודעת ההוצאה משימוש לגבי ממשקי ה-API שמנוהלים עכשיו על ידי Activity Result APIs, כלומר startActivityForResult,‏ startIntentSenderForResult,‏ onActivityResult,‏ requestPermissions ו-onRequestPermissionsResult. (cce80f)

גרסה 1.4.0-alpha02

15 בספטמבר 2021

התכונות androidx.activity:activity:1.4.0-alpha02, androidx.activity:activity-compose:1.4.0-alpha02 וגם androidx.activity:activity-ktx:1.4.0-alpha02 משוחררות. גרסה 1.4.0-alpha02 מכילה את ההצהרות האלה.

תכונות חדשות

• הארטיפקט activity-compose מכיל עכשיו שגיאת איתור שגיאות בקוד (lint) מסוג LaunchDuringComposition, שמונעת קריאה ל-method‏ launch של ActivityResultLauncher כחלק מההרכבה, כי ההרכבה אמורה להיות ללא תופעות לוואי. להשתמש בממשקי API לטיפול בתופעות לוואי. (7c2bbe, ‏ b/191347220)

שינויים ב-API

• המחלקה ActivityResultContract נכתבה מחדש ב-Kotlin כדי להבטיח שמפתחים שכותבים חוזים מותאמים אישית ב-Kotlin יוכלו להגדיר את אפשרות ה-null שמתאימה למחלקות הקלט והפלט שלהם. (I8a8f5)
• הכיתה ActivityResultContracts והחוזים שלה נכתבו מחדש ב-Kotlin כדי להבטיח את היכולת לבדוק אם הערך יכול להיות null. (I69802)

גרסה 1.4.0-alpha01

1 בספטמבר 2021

התכונות androidx.activity:activity:1.4.0-alpha01, androidx.activity:activity-compose:1.4.0-alpha01 וגם androidx.activity:activity-ktx:1.4.0-alpha01 משוחררות. גרסה 1.4.0-alpha01 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

• AndroidX ComponentActivity מטמיע עכשיו את הממשק MenuHost. כך כל רכיב יכול להוסיף פריטים לתפריט ActionBar על ידי הוספת מופע MenuProvider לפעילות. אפשר להוסיף לכל MenuProvider Lifecycle שישלוט באופן אוטומטי בחשיפה של פריטי התפריט האלה על סמך מצב ה-Lifecycle, ויטפל בהסרת ה-MenuProvider כשה-Lifecycle נהרס. (I3b608):

/**
  * Using the addMenuProvider() API directly in your Activity
  **/
class ExampleActivity : ComponentActivity(R.layout.activity_example) {

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Add menu items without overriding methods in the Activity
   addMenuProvider(object : MenuProvider {
      override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
        // Add menu items here
        menuInflater.inflate(R.menu.example_menu, menu)
      }

      override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
        // Handle the menu selection
        return true
      }
    })
  }
}

/**
  * Using the addMenuProvider() API in a Fragment
  **/
class ExampleFragment : Fragment(R.layout.fragment_example) {

  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    // The usage of an interface lets you inject your own implementation
    val menuHost: MenuHost = requireActivity()
  
    // Add menu items without using the Fragment Menu APIs
    // Note how we can tie the MenuProvider to the viewLifecycleOwner
    // and an optional Lifecycle.State (here, RESUMED) to indicate when
    // the menu should be visible
    menuHost.addMenuProvider(object : MenuProvider {
      override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
        // Add menu items here
        menuInflater.inflate(R.menu.example_menu, menu)
      }

      override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
        // Handle the menu selection
        return true
      }
    }, viewLifecycleOwner, Lifecycle.State.RESUMED)
  }

שינויים בהתנהגות

• מעכשיו, ה-ActivityResultRegistry יגרום להודעת השגיאה IllegalStateException כשמנסים להפעיל את launch() ב-ActivityResultLauncher שלא נרשם או שנרשם ולא רשום יותר. (Ida75d, ‏ b/192567522)

תרומה חיצונית

• תודה ל-dmitrilc על תיקון שגיאת הקלדה במסמכי התיעוד של ActivityResult. (#221)

גרסה 1.3.1

גרסה 1.3.1

4 באוגוסט 2021

androidx.activity:activity:1.3.1, androidx.activity:activity-compose:1.3.1 ו-androidx.activity:activity-ktx:1.3.1 שוחררו. גרסה 1.3.1 מכילה את השמירות האלה.

עדכונים בנושא תלות

• הפעילות תלויה עכשיו ב-Kotlin 1.5.21.
• ההצעות לכתיבה תלויות עכשיו ב'כתיבה' 1.0.1.

גרסה 1.3.0

גרסה 1.3.0

28 ביולי 2021

התכונות androidx.activity:activity:1.3.0, androidx.activity:activity-compose:1.3.0 וגם androidx.activity:activity-ktx:1.3.0 משוחררות. גרסה 1.3.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז גרסה 1.2.0

• פריט Compose של פעילות – פריט ה-activity-compose מספק את שיטת התוסף setContent לאירוח ממשק המשתמש של Jetpack Compose בפעילות, ורכיבי עטיפה ספציפיים של Compose ליצירת אינטראקציה עם ממשקי ה-API של ComponentActivity לטיפול בלחצן החזרה אחורה במערכת ובממשקי ה-API של תוצאות הפעילות. פרטים נוספים זמינים במסמכי התיעוד.
• חוזה מסוג CaptureVideo – CaptureVideo ActivityResultContract מחליף את החוזה של TakeVideo שיצא משימוש, ומחזיר ערך בוליאני לציון הצלחה שפועל באפליקציות מצלמה רבות.
• מעקב אחר תצוגת ההצעה 'תמונה בתוך תמונה' – משתמשי activity-ktx יכולים להשתמש עכשיו בשיטת התוסף trackPipAnimationHintView ב-Activity כדי ליצור מחדש באופן אוטומטי את PictureInPictureParams עם המיקום החדש של התצוגה כשהיא משתנה ביחס לחלון.

גרסה 1.3.0-rc02

14 ביולי 2021

התכונות androidx.activity:activity:1.3.0-rc02, androidx.activity:activity-compose:1.3.0-rc02 וגם androidx.activity:activity-ktx:1.3.0-rc02 משוחררות. גרסה 1.3.0-rc02 מכילה את ההתחייבויות האלה.

תיקוני באגים

• הקריאות החוזרות של ActivityResultRegistry שמורות ושוחזרו כמו שצריך, כך שהקריאות החוזרות לא משוכפלות ב-SavedState. (I97816, ‏ b/191893160)

גרסה 1.3.0-rc01

1 ביולי 2021

הגרסאות androidx.activity:activity:1.3.0-rc01,‏ androidx.activity:activity-compose:1.3.0-rc01 ו-androidx.activity:activity-ktx:1.3.0-rc01 פורסמו ללא שינויים מ-1.3.0-beta02. גרסה 1.3.0-rc01 כוללת את ההצהרות האלה.

גרסה 1.3.0-beta02

16 ביוני 2021

התכונות androidx.activity:activity:1.3.0-beta02, androidx.activity:activity-compose:1.3.0-beta02 וגם androidx.activity:activity-ktx:1.3.0-beta02 משוחררות. גרסה 1.3.0-beta02 מכילה את ההצהרות האלה.

עודכנה ההגדרה activity-compose כך שתהיה תלויה ב-Compose 1.0.0-beta09. ב-androidx.compose.ui:ui-test-junit4 יש עכשיו תלות בזמן הידור ב-activity-compose.

גרסה 1.3.0-beta01

2 ביוני 2021

androidx.activity:activity:1.3.0-beta01, androidx.activity:activity-compose:1.3.0-beta01 ו-androidx.activity:activity-ktx:1.3.0-beta01 שוחררו. גרסה 1.3.0-beta01 מכילה את ההצהרות האלה.

שינויים ב-API

• השיטה @Composable registerForActivityResult() הוצאה משימוש. יש להשתמש ב-rememberLauncherForActivityResult(). (Ic39d3)

גרסה 1.3.0-alpha08

18 במאי 2021

התכונות androidx.activity:activity:1.3.0-alpha08, androidx.activity:activity-compose:1.3.0-alpha08 וגם androidx.activity:activity-ktx:1.3.0-alpha08 משוחררות. גרסה 1.3.0-alpha08 מכילה את ההצהרות האלה.

תכונות חדשות

• הפונקציה החדשה CaptureVideo ActivityResultContract מחזירה ערך בוליאני ל-ActivityResultCallback, שמציין אם הסרטון נשמר בהצלחה ב-URI שצוין. הגרסה הזו מחליפה את החוזה ב-TakeVideo שהוצא משימוש, כי לעיתים רחוקות מאוד אפליקציות מצלמה תומכות בהחזרת מפת סיביות של תמונה ממוזערת, ולכן התוצאה לא מועילה. (Ie21f2, ‏ b/185938070)
• נוספה ממשק API חדש Activity#setPipAnimationHintView כדי לעדכן את ההצעה של PipParams למקור של מלבן המקור בכל פעם שהתצוגה זזה. (I9063d)

שינויים ב-API

• הפונקציה rememberLauncherForActivityResult מחזירה עכשיו מרכז אפליקציות שמפסיק את השימוש בפונקציה unregister() – הרישום והביטול של הרישום של מרכז האפליקציות מתבצע באופן אוטומטי על ידי rememberLauncherForActivityResult. (I2443e)

תאימות ל-Compose

• androidx.activity:activity-compose:1.3.0-alpha08 תואם רק ל-Compose בגרסה 1.0.0-beta07 ואילך.

גרסה 1.3.0-alpha07

21 באפריל 2021

androidx.activity:activity:1.3.0-alpha07, androidx.activity:activity-compose:1.3.0-alpha07 ו-androidx.activity:activity-ktx:1.3.0-alpha07 שוחררו. גרסה 1.3.0-alpha07 מכילה את ההצהרות האלה.

תיקוני באגים

• עכשיו, הפונקציה rememberLauncherForActivityResult מחזירה הפניה יציבה לאותה מכונה של ActivityResultLauncher, גם אם החוזה משתנה בגלל שינויים בהרכב. (Id2d6d)
• שימוש בגרסאות לא יציבות של Fragments מעל 1.3.0 לא יגרום יותר לשגיאת איתור שגיאות בקוד (lint) שגויה, שבה יצוין שצריך להשתמש ב-1.3.0. (aosp/1670206, ‏ b/184847092)

גרסה 1.3.0-alpha06

7 באפריל 2021

androidx.activity:activity:1.3.0-alpha06, androidx.activity:activity-compose:1.3.0-alpha06 ו-androidx.activity:activity-ktx:1.3.0-alpha06 שוחררו. גרסה 1.3.0-alpha06 מכילה את התחייבויות אלה.

שינויים ב-API

• השם של ה-API registerForActivityResult() השתנה ל-rememberLauncherForActivityResult() כדי לציין בצורה טובה יותר שה-ActivityResultLauncher שמוחזר הוא אובייקט מנוהל שנשמר בשבילכם. ניסיון להתקשר אל unregister אל ActivityResultLauncher שהוחזרו יקפיץ הודעת שגיאה. (I2bb6d)
• הפונקציות LocalOnBackPressedDispatcherOwner.current ו-LocalActivityResultRegistryOwner.current מחזירות ערך שאפשר להעביר אותו כ-null כדי לקבוע טוב יותר אם הוא זמין בהרכב הנוכחי. ממשקי API שדורשים את ממשקי ה-API האלה, כמו BackHandler ו-rememberLauncherForActivityResult(), יגרמו עכשיו לשגיאה תיאורית יותר אם הבעלים הבסיסי לא נמצא. NavHost פועל עכשיו גם אם OnBackPressedDispatcherOwner לא נמצא, וזה מה שקורה כשצופים בתצוגה מקדימה של NavHost. (I7d8b4)

תיקוני באגים

• עכשיו, ה-BackHandler יפריע כראוי ללחיצות על לחצן החזרה לאחור במקרה שהפעילות היא STOPPED, ואז STARTED שוב, ונוספו קריאות חזרה אחרות עם LifecycleOwner. (I71de6, b/182284739)
• שימוש בהרחבה של השיטה launch() עם ActivityResultContract בהתאמה אישית שיש לו קלט Unit לא יגרום יותר ל-NullPointerException (I76282, b/183837954)

גרסה 1.3.0-alpha05

24 במרץ 2021

התכונות androidx.activity:activity:1.3.0-alpha05, androidx.activity:activity-compose:1.3.0-alpha05 וגם androidx.activity:activity-ktx:1.3.0-alpha05 משוחררות. גרסה 1.3.0-alpha05 מכילה את ההצהרות האלה.

תיקוני באגים

• מ-Activity 1.2.2: תוקנה בעיה בבדיקת האיתור של שגיאות בקוד (lint) של InvalidFragmentVersionForActivityResult שהובילה לתוצאה חיובית שגויה כשמשתמשים ב-Fragment 1.3.1 ואילך. (I54da1, ‏ b/182388985)
• מפעילות 1.2.2: מעכשיו, ComponentActivity נמנע מ-ClassNotFoundException כשמפעילים Intent מ-ActivityResultContract שהיה נקבע בעבר כתוספת בIntent אחר. (Ieff05, ‏ b/182906230)

עדכוני יחסי תלות

• מ-Activity 1.2.2: הפעילות תלויה עכשיו ב-Lifecycle 2.3.1.

גרסה 1.3.0-alpha04

10 במרץ 2021

התכונות androidx.activity:activity:1.3.0-alpha04, androidx.activity:activity-compose:1.3.0-alpha04 וגם androidx.activity:activity-ktx:1.3.0-alpha04 משוחררות. גרסה 1.3.0-alpha04 מכילה את ההצהרות האלה.

תיקוני באגים

• מפעילות 1.2.1: הפונקציה RequestMultiplePermissions תמיד מחזירה עכשיו תוצאות לכל ההרשאות המבוקשות, במקום רק להרשאות שלא אושרו בעבר. (I50bc3, b/180884668)
• מפעילות 1.2.1: ActivityResultRegistry מוודא עכשיו שבתהליך עיבוד בקשות launch() יחזירו את התוצאות שלהן גם אם unregister(), ואז register() שוב עם אותו מפתח. (I9ef34, b/181267562)
• Activity Compose כבר לא מוסיף יחסי תלות של בדיקות למסלול הטעינה של סביבת זמן הריצה. (Ifd8b3)
• תוקנה בעיה ב-BackHandler שבה lambda של onBack שהוגדרה בעבר עדיין היה בשימוש אחרי הרכבה מחדש. (8eb5eb)

גרסה 1.3.0-alpha03

24 בפברואר 2021

התכונות androidx.activity:activity:1.3.0-alpha03, androidx.activity:activity-compose:1.3.0-alpha03 וגם androidx.activity:activity-ktx:1.3.0-alpha03 משוחררות. גרסה 1.3.0-alpha03 מכילה את ההצהרות האלה.

תכונות חדשות

• עכשיו יש פונקציית Composable‏ registerForActivityResult לקבלת תוצאות מפעילויות בתוך רכיבים מורכבים. (Ia7851, ‏ b/172690553)

שינויים ב-API

• עכשיו יש ב-LocalOnBackPressedDispatcherOwner פונקציות provides שאפשר להשתמש בהן עם CompositionLocalProvider, במקום asProvidableCompositionLocal(). (I45d24)

גרסה 1.3.0-alpha02

10 בפברואר 2021

התכונות androidx.activity:activity:1.3.0-alpha02, androidx.activity:activity-compose:1.3.0-alpha02 וגם androidx.activity:activity-ktx:1.3.0-alpha02 משוחררות. גרסה 1.3.0-alpha02 מכילה את התחייבויות אלה.

תיקוני באגים

• תוקנה בעיה בניסוח 'פעילות בכתיבה' 1.3.0-alpha01 שגורמת לחריגה NoSuchMethodError: No static method setContent במהלך השימוש בניסוח 1.0.0-alpha12. כל המשתמשים ב-Compose צריכים להסתמך על גרסת 1.3.0-alpha02 ואילך. (b/179911234)

שינויים ב-API

• אפשר להשתמש ב-API BackHandler כדי לאפשר לפריט קומפוזבילי ליירט את לחצן 'הקודם' של המערכת. (I58ed5, ‏ b/172154006)

גרסה 1.3.0-alpha01

10 בפברואר 2021

התכונות androidx.activity:activity:1.3.0-alpha01, androidx.activity:activity-compose:1.3.0-alpha01 וגם androidx.activity:activity-ktx:1.3.0-alpha01 משוחררות. גרסה 1.3.0-alpha01 כוללת את ההוספות האלה.

תכונות חדשות

• הארטיפקט החדש activity-compose מספק רכיבי עזר ספציפיים ל-Jetpack Compose לממשקי API ספציפיים של androidx.activity.
  • ComponentActivity.setContent הועבר מ-androidx.compose.ui.platform.setContent ל-androidx.activity.compose.setContent. (Icf416)

בעיות מוכרות

• שימוש ב-Activity Compose 1.3.0-alpha01 ובספריות שתלויות בו, כמו androidx.compose.ui:ui-test-junit4:1.0.0-alpha12, יוביל לחריגה מסוג NoSuchMethodError: No static method setContent. (b/179911234)

גרסה 1.2.4

גרסה 1.2.4

21 ביולי 2021

androidx.activity:activity:1.2.4 ו-androidx.activity:activity-ktx:1.2.4 משוחררים. גרסה 1.2.4 כוללת את ההצהרות האלה.

תיקוני באגים

• מ-Activity 1.3.0-rc02: פונקציות ה-call back של ActivityResultRegistry נשמרות ומשוחזרות כראוי, כך שלא מתרחשת כפילות של פונקציות ה-call back ב-savedState. (I97816, ‏ b/191893160)

גרסה 1.2.3

גרסה 1.2.3

5 במאי 2021

androidx.activity:activity:1.2.3 ו-androidx.activity:activity-ktx:1.2.3 משוחררים. גרסה 1.2.3 מכילה את ההוספות האלה.

תיקוני באגים

• שימוש בהרחבה של השיטה launch() עם ActivityResultContract בהתאמה אישית שיש לו קלט Unit לא יגרום יותר ל-NullPointerException (I76282, b/183837954)
• תוקנה שגיאה באיתור שגיאות בקוד (lint) שמנחה את המשתמשים להשתמש במקטע 1.3.0 במהלך שימוש בגרסת snapshot, אלפא, בטא או RC של גרסה חדשה יותר של Fragments. (f4a57e, ‏ b/184847092)

גרסה 1.2.2

גרסה 1.2.2

24 במרץ 2021

androidx.activity:activity:1.2.2 ו-androidx.activity:activity-ktx:1.2.2 משוחררים. גרסה 1.2.2 כוללת את ההתחייבויות האלה.

תיקוני באגים

• תוקנה בעיה בבדיקת השגיאות בקוד של InvalidFragmentVersionForActivityResult שהובילה לערך חיובי שגוי במהלך השימוש ב-Fragment 1.3.1 ואילך. (I54da1, ‏ b/182388985)
• ComponentActivity עכשיו נמנעת ClassNotFoundException כשמפעילים Intent מ-ActivityResultContract שהיה בעבר כתוכן נוסף ב-Intent אחר. (Ieff05, b/182906230)

עדכוני יחסי תלות

• הפעילות תלויה עכשיו במחזור חיים 2.3.1.

גרסה 1.2.1

גרסה 1.2.1

10 במרץ 2021

androidx.activity:activity:1.2.1 ו-androidx.activity:activity-ktx:1.2.1 משוחררים. גרסה 1.2.1 כוללת את ההתחייבויות האלה.

תיקוני באגים

• מעכשיו, RequestMultiplePermissions תמיד יחזיר תוצאות עבור כל ההרשאות הנדרשות, במקום רק הרשאות שלא הוענקו בעבר. (I50bc3, b/180884668)
• ActivityResultRegistry מבטיחה עכשיו שבקשות launch() בתהליך יסופקו עם התוצאות שלהן, גם אם תבצעו unregister() ואז register() שוב עם אותו מפתח. (I9ef34, b/181267562)

גרסה 1.2.0

גרסה 1.2.0

10 בפברואר 2021

androidx.activity:activity:1.2.0 ו-androidx.activity:activity-ktx:1.2.0 שוחררו. גרסה 1.2.0 מכילה את ההוספות האלה.

שינויים משמעותיים מאז גרסה 1.1.0

• ממשקי API של תוצאות פעילות: ComponentActivity מספק עכשיו ActivityResultRegistry שמאפשר לטפל בתהליכי startActivityForResult()+onActivityResult() וגם requestPermissions()+onRequestPermissionsResult() בלי לעקוף את השיטות ב'פעילות' או ב-Fragment', ומשפר את בטיחות הסוגים באמצעות ActivityResultContract, ומספק קטעי הוק (hooks) לבדיקת התהליכים האלה. כדאי לעיין במאמר המעודכן בנושא קבלת תוצאה מפעילות.

• ContextAware: ComponentActivity מטמיע עכשיו את ContextAware, ומאפשר לכם להוסיף מופע OnContextAvailableListener אחד או יותר שיקבלו קריאה חוזרת (callback) לפני הבסיס Activity.onCreate().

  • תוסף Kotlin עם השהיה withContextAvailable() מאפשר להריץ בלוק ללא השהיה כשה-Context הופך לזמין ולהחזיר תוצאה.
  • ממשק ה-API הזה משמש את FragmentActivity ב-Fragment 1.3.0 כדי לשחזר את המצב של ה-FragmentManager. כל המאזינים שיתווספו לתת-כיתות של FragmentActivity יפעלו אחרי המאזין הזה.
  • ממשק ה-API הזה משמש את AppCompatActivity ב-AppCompat 1.3.0-alpha02 ואילך. כל המאזינים שיתווספו לתת-כיתות של AppCompatActivity יפעלו אחרי המאזין הזה.

• תמיכה ב-ViewTree: ComponentActivity תומך עכשיו בממשקי ה-API ViewTreeLifecycleOwner.get(View),‏ ViewTreeViewModelStoreOwner.get(View) ו-ViewTreeSavedStateRegistryOwner שנוספו ב-Lifecycle 2.3.0 וב-SavedState 1.1.0, כך שהוא יחזיר את הפעילות כ-LifecycleOwner,‏ ViewModelStoreOwner ו-SavedStateRegistryOwner לכל תצוגה שנוספה ישירות ל-ComponentActivity.

• reportFullyDrawn() – שיטת Activity של reportFullyDrawn() הועברה לאחור ב-ComponentActivity כדי לפעול בכל רמות ה-API, תיקון קריסה ב-API 19 והוספת מעקב לשיטה הזו בכל רמות ה-API.

גרסה 1.2.0-rc01

16 בדצמבר 2020

androidx.activity:activity:1.2.0-rc01 ו-androidx.activity:activity-ktx:1.2.0-rc01 משוחררים. גרסה 1.2.0-rc01 מכילה את שמירות האלה.

תיקוני באגים

• עכשיו ActivityResultRegistry תמיד משחזר את המצב המדויק שנשמר. (Idd56b)
• הוספת מעקב ל-ComponentActivity.reportFullyDrawn (Ic7632)

תרומה חיצונית

• ComponentActivity מבטל עכשיו את reportFullyDrawn(), ומאפשר לקרוא לו בכל רמות ה-API. בנוסף, תוקן קריסה שנגרמה כשקוראים ל-method הזה בלי ההרשאה המתאימה מהמערכת במכשירים עם API 19. תודה, Simon Schiller! (b/163239764, #103)

גרסה 1.2.0-beta02

2 בדצמבר 2020

androidx.activity:activity:1.2.0-beta02 ו-androidx.activity:activity-ktx:1.2.0-beta02 משוחררים. גרסה 1.2.0-beta02 מכילה את התחייבויות אלה.

תיקוני באגים

• תוקנה בעיה שבה Activity Result API לא ימתין עד שהמצב של מחזור החיים יהיה STARTED לפני שהוא יספק תוצאות כשנרשם באמצעות Lifecycle. (I109ea)

תרומה חיצונית

• עדכנו את המסמך של launch() כדי לציין במפורש שהוא עלול להוביל ל-ActivityNotFoundException. תודה Michał Zieliński! (aosp/1493580)

גרסה 1.2.0-beta01

1 באוקטובר 2020

androidx.activity:activity:1.2.0-beta01 ו-androidx.activity:activity-ktx:1.2.0-beta01 משוחררים. גרסה 1.2.0-beta01 מכילה את התחייבויות אלה.

תיקוני באגים

• הפונקציה ActivityResultRegistry יוצרת עכשיו מספרים שלמים באופן אקראי עד שהיא מוצאת מספר שלם שלא הוקצה לשימוש כקוד בקשה register(), וכך מונעת את האפשרות של זליגת נתונים (overflow) במספרים שלמים שנגרמת על ידי הוספת קוד בקשה. (b/168779518)

• משגיחי Lifecycle יוסרו כראוי כשקוראים ל-unregister() ב-ActivityResultLauncher. (b/165608393)

שינויים בהתנהגות

• עכשיו, ה-ActivityResultRegistry יוצר אירוע IllegalStateException כשמנסים לקרוא ל-register() באמצעות LifecycleOwner ש-Lifecycle שלו כבר הגיע ל-STARTED. (b/165435866)

המסמכים עודכנו

• במסמכי התיעוד של ContextAware יש קישורים אל LifecycleOwner כדי להדגיש שקודים להתקשרות חזרה של Lifecycle הם המקום המתאים לאירועי יצירה והרס. (aosp/1414152)

גרסה 1.2.0-alpha08

19 באוגוסט 2020

androidx.activity:activity:1.2.0-alpha08 ו-androidx.activity:activity-ktx:1.2.0-alpha08 משוחררים. גרסה 1.2.0-alpha08 מכילה את התחייבויות אלה.

תכונות חדשות

• ComponentActivity מיישם עכשיו את ContextAware, ומאפשר לכם להוסיף מופע OnContextAvailableListener אחד או יותר שיקבל קריאה חוזרת לפני Activity.onCreate() הבסיסי. (b/161390636)
  • תוסף Kotlin עם השעיה withContextAvailable() מאפשר להפעיל בלוק שלא נמצא בהמתנה כשההקשר הופך לזמין ולהחזיר תוצאה. (I8290c)
  • ממשק ה-API הזה משמש את FragmentActivity ב-Fragment 1.3.0-alpha08 כדי לשחזר את המצב של ה-FragmentManager. כל המאזינים שיתווספו לתת-כיתות של FragmentActivity יפעלו אחרי המאזין הזה. (I513da)
  • ה-API הזה משמש את AppCompatActivity ב-AppCompat 1.3.0-alpha02. מאזינים שנוספו למחלקות המשנה של AppCompatActivity יפעלו אחרי המאזינים האלה. (I513da)

תיקוני באגים

• תוקנה בעיה בבדיקת Lint של ActivityResultFragmentVersionDetector שגרמה לקריסה שלה כשמשתמשים ב-Lint מגרסה 27.1.0 ואילך. (b/162155191)

גרסה 1.2.0-alpha07

22 ביולי 2020

androidx.activity:activity:1.2.0-alpha07 ו-androidx.activity:activity-ktx:1.2.0-alpha07 שוחררו. גרסה 1.2.0-alpha07 מכילה את ההצהרות האלה.

תכונות חדשות

• נוספה בדיקת שגיאות בקוד של InvalidFragmentVersionForActivityResult החדשה שמאמתת שנעשה שימוש ב-Fragment 1.3.0-alpha07 בזמן השימוש ב-Activity result API, כדי למנוע קריסות בסביבת זמן הריצה שנובעות מבעיות מסוג 'קוד בקשה לא תקין' ומבקשות הרשאה לא מתפקדות שנגרמו כתוצאה משימוש בגרסאות ישנות של Fragments. (b/152554847)

תרומה חיצונית

• תוקנה שגיאת ArrayIndexOutOfBoundsException במהלך ניתוח התוצאות של חוזה Activity Result‏ RequestPermission. (I8f9e3, b/161057605)

גרסה 1.2.0-alpha06

10 ביוני 2020

androidx.activity:activity:1.2.0-alpha06 ו-androidx.activity:activity-ktx:1.2.0-alpha06 שוחררו. גרסה 1.2.0-alpha06 מכילה את ההצהרות האלה.

תכונות חדשות

• עכשיו אפשר להשבית את המחלקה ActivityResult בקוטלין כדי לגשת ישירות ל-requestCode ול-intent. (b/157212935)
• עכשיו אפשר להשתמש ב-ActivityResultLauncher כדי לקבל את הערך של ActivityResultContract ששימש לרישום מרכז האפליקציות. (b/156875743)

שינויים ב-API

• שינוי שגורם לשבירה: השם של השיטה invoke() ב-ActivityResultRegistry השתנה ל-onLaunch(). (b/157496491)
• אם לא מוחזרת תוצאה, החוזה OpenMultipleDocuments מחזיר עכשיו רשימה ריקה במקום null ל-callback הרשום. (b/157348014)

גרסה 1.2.0-alpha05

20 במאי 2020

androidx.activity:activity:1.2.0-alpha05 ו-androidx.activity:activity-ktx:1.2.0-alpha05 משוחררים. גרסה 1.2.0-alpha05 מכילה את התחייבויות אלה.

תכונות חדשות

• נוספה תמיכה ב-ViewTreeViewModelStoreOwner מ-דוחות מחזור חיים 2.3.0-alpha03 וב-ViewTreeSavedStateRegistryOwner מ-SavedState 1.1.0-alpha01 בזמן שימוש ב-View בתוך ComponentActivity. (aosp/1297993, ‏ aosp/1300264)

שינויים ב-API

• החוזה של TakePicture מחזיר עכשיו ערך מסוג boolean שמציין הצלחה, ולא תמונה ממוזערת Bitmap, כי רק לעיתים רחוקות מאוד יש תמיכה באפשרות הזו באפליקציות המצלמה בכתיבת התמונה ל-Uri שסופק. (b/154302879)
• התוספים invoke() ב-ActivityResultLauncher הוסרו לטובת שימוש מפורש ב-launch() כדי לציין טוב יותר שאלה פעולות אסינכרוניות. תוספי Kotlin ל-launch נוספו לחבילת androidx.activity.result עבור ActivityResultLauncher<Void> ו-ActivityResultLauncher<Unit>, שמבטלים את הצורך להעביר ב-null או ב-Unit, בהתאמה, ומשקפים את ההתנהגות הזו מהתוספים invoke() הקודמים. (aosp/1304674, ‏ aosp/1304675)
• השיטות IntentSenderRequest.Builder עבור setFlagsMask() ו-setFlagsValues() שולבו לשיטה אחת, setFlags(). (aosp/1302111)

תיקוני באגים

• במהלך רישום של ActivityResultCallback דרך LifecycleOwner, תוקנה בעיה שבה הקריאה החוזרת (callback) תופעל לפני שהמצב יגיע אל STARTED. (aosp/1309744)

שינויים בהתנהגות

• הרכיב ActivityResultRegistry יוצר עכשיו קודי בקשות החל מ-0xFFFF במקום ב-0, כך שהוא מונע חפיפה בשימוש ב-startActivityForResult() או ב-requestPermissions() בפעילות. (aosp/1302324)

גרסה 1.2.0-alpha04

29 באפריל 2020

androidx.activity:activity:1.2.0-alpha04 ו-androidx.activity:activity-ktx:1.2.0-alpha04 משוחררים. גרסה 1.2.0-alpha04 מכילה את ההוספות האלה.

תכונות חדשות

• נוספה חוזה שיכול לקרוא ל-startIntentSenderForResult לממשקי ה-API של ActivityResult. (b/153007517)

שינויים ב-API

• השם של method‏ prepareCall() השתנה ל-registerForActivityResult(), גם ב-ComponentActivity כאן וגם ב-Fragment 1.3.0-alpha04. (aosp/1278717)
• השמות של החוזים GetContents,‏ OpenDocuments ו-RequestPermissions שונו ל-GetMultipleContents,‏ OpenMultipleDocuments ו-RequestMultiplePermissions, בהתאמה. (aosp/1280161)
• ComponentActivity מטמיע עכשיו את הממשק ActivityResultRegisteryOwner. (aosp/1290888)
• - ממשקי ה-API של startActivityForResult()/onActivityResult() ו-onRequestPermissionsResult() ב-ComponentActivity הוצאו משימוש. צריך להשתמש ב-Activity Result APIs. (b/154751887)

תיקוני באגים

• כשמשתמשים בחוזים GetMultipleContents ו-OpenMultipleDocuments ובוחרים פריט יחיד, הוא מוחזר כעת בצורה נכונה לשיחה החוזרת. (b/152941153)

גרסה 1.2.0-alpha03

1 באפריל, 2020

androidx.activity:activity:1.2.0-alpha03 ו-androidx.activity:activity-ktx:1.2.0-alpha03 שוחררו. גרסה 1.2.0-alpha03 מכילה את התחייבויות אלה.

תכונות חדשות

• הוספת החוזים TakeVideo,‏ PickContact,‏ GetContent,‏ GetContents,‏ OpenDocument,‏ OpenDocuments,‏ OpenDocumentTree ו-CreateDocument לקבוצת החוזים שנוצרו מראש על ידי ActivityResultContracts. (aosp/1262482, ‏ aosp/1266916, ‏ aosp/1268960)
• ממשקי ה-API של תוצאות הפעילות תומכים עכשיו בהפעלת פעילות עם תוצאה באמצעות ActivityOptionsCompat אופציונלי. (b/151860054)

שינויים ב-API

• החוזה של TakePicture כולל עכשיו קלט מסוג Uri למקום שבו צריך לאחסן את התמונה. השם של החוזה הקודם שלא מקבל קלט השתנה ל-TakePicturePreview. (aosp/1262482)
• השם של method‏ registerActivityResultCallback() ב-ActivityResultRegistry השתנה ל-register(). (aosp/1267621)
• השם של השיטה dispose() ב-ActivityResultLauncher השתנה ל-unregister(), וה-unregisterResultCallback() ב-ActivityResultRegistry הוסר. (aosp/1267621)
• השיטה createIntent() של ActivityResultContact מקבלת עכשיו Context בנוסף לקלט, כדי לאפשר ליצור כוונות מפורשות. (aosp/1238800)
• עכשיו אפשר להשתמש ב-ActivityResultContract כדי לשנות את getSynchronousResult() ולספק תוצאה בלי להפעיל את startActivityForResult. החוזים RequestPermission ו-RequestPermissions משתמשים בזה כדי לספק סטטוס 'granted' (הוקצה) בצורה נכונה אם ההרשאות המבוקשות כבר הוקצו. (b/151110799)
• החוזה של Dial שהיה זמין בעבר הוסר כי Intent הזה לא מיועד לשימוש עם startActivityForResult(). (aosp/1266916)
• הרבה ממשקי API של תוצאות פעילות שלא נועדו להרחבה הם עכשיו final. הרשימה הזו כוללת את getActivityResultRegistry(), את השיטות prepareCall(), את כל השיטות של ActivityResultRegistry מלבד invoke() ואת מספר חוזי ברירת המחדל שלא תומכים בתוספים אופציונליים. (b/152439361)

תיקוני באגים

• תוקנה בעיה ב-NullPointerException ב-ActivityResultRegistry כשמנסים להעביר תוצאות לשיחה חוזרת שעדיין לא נרשמה מחדש אחרי שינוי בהגדרות. עכשיו ActivityResultRegistry שומר את התוצאות האלה בהמתנה ומעביר אותן כשהשיחה החוזרת נרשמת מחדש. (b/152137004)

גרסה 1.2.0-alpha02

18 במרץ 2020

androidx.activity:activity:1.2.0-alpha02 ו-androidx.activity:activity-ktx:1.2.0-alpha02 משוחררים. גרסה 1.2.0-alpha02 מכילה את התחייבויות אלה.

תכונות חדשות

• ActivityResultRegistry: ‏ComponentActivity מספק עכשיו ActivityResultRegistry שמאפשר לטפל בתהליכים startActivityForResult()+onActivityResult() וגם requestPermissions()+onRequestPermissionsResult() בלי לשנות את שיטות ה-Activity או ה-Fragment, מספק בטיחות סוגים משופרת באמצעות ActivityResultContract ומספק ווקים לבדיקה של התהליכים האלה. כדאי לעיין במאמר המעודכן בנושא קבלת תוצאה מפעילות. (b/125158199)

גרסה 1.2.0-alpha01

4 במרץ 2020

androidx.activity:activity:1.2.0-alpha01 ו-androidx.activity:activity-ktx:1.2.0-alpha01 משוחררים. גרסה 1.2.0-alpha01 מכילה את התחייבויות אלה.

תכונות חדשות

• הוספנו תמיכה ב-API של ViewTreeLifecycleOwner.get(View) שנוסף ב-Lifecycle 2.3.0-alpha01, כך שהוא יחזיר את הפעילות כ-LifecycleOwner לכל תצוגות שנוספו ישירות לפעילות. (aosp/1182955)

תיקוני באגים

• תוקנה נסיגה (regression) שהופיעה בפעילות 1.1.0 כשהיא פועלת בגרסאות ישנות יותר של הפלטפורמה, שבהן onBackPressed() גורם ל-IllegalStateException בגלל באג ב-android.app.FragmentManager. (b/146290338)

גרסה 1.1.0

גרסה 1.1.0

22 בינואר 2020

androidx.activity:activity:1.1.0 משוחרר. גרסה 1.1.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז גרסה 1.0.0

• שילוב של SavedState ב-Lifecycle ViewModel: SavedStateViewModelFactory הוא עכשיו המפעל שמוגדר כברירת מחדל כשמשתמשים ב-by viewModels(), ב-constructor‏ ViewModelProvider או ב-ViewModelProviders.of() עם ComponentActivity או עם תת-הסוגים שלו.

גרסה 1.1.0-rc03

4 בדצמבר 2019

androidx.activity:activity:1.1.0-rc03 ו-androidx.activity:activity-ktx:1.1.0-rc03 משוחררים. גרסה 1.1.0-rc03 כוללת את השמירות האלה.

שינויים בתלות

• הפעילות תלויה עכשיו ב-Lifecycle 2.2.0-rc03 וב-Lifecycle ViewModel SavedState 1.0.0-rc03.

גרסה 1.1.0-rc02

7 בנובמבר 2019

androidx.activity:activity:1.1.0-rc02 ו-androidx.activity:activity-ktx:1.1.0-rc02 שוחררו. גרסה 1.1.0-rc02 מכילה את ההתחייבויות האלה.

שינויים ביחסי התלות

• הפעילות תלויה עכשיו במחזור החיים 2.2.0-rc02.

גרסה 1.1.0-rc01

23 באוקטובר 2019

הגרסאות androidx.activity:activity:1.1.0-rc01 ו-androidx.activity:activity-ktx:1.1.0-rc01 פורסמו ללא שינויים מ-1.1.0-beta01. גרסה 1.1.0-rc01 כוללת את ההוספות האלה.

גרסה 1.1.0-beta01

9 באוקטובר 2019

androidx.activity:activity:1.1.0-beta01 ו-androidx.activity:activity-ktx:1.1.0-beta01 משוחררים. גרסה 1.1.0-beta01 כוללת את ההצהרות האלה.

שינויים בתלות

• הפעילות תלויה עכשיו ב-SavedState 1.0.0 יציב.

גרסה 1.1.0-alpha03

5 בספטמבר 2019

androidx.activity:activity:1.1.0-alpha03 ו-androidx.activity:activity-ktx:1.1.0-alpha03 משוחררים. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תכונות חדשות

• הפעילות תלויה עכשיו ב-Core 1.1.0 יציב.

תיקוני באגים

• הפעילות תלויה עכשיו במחזור חיים 2.2.0-alpha04.

גרסה 1.1.0-alpha02

7 באוגוסט 2019

androidx.activity:activity:1.1.0-alpha02 ו-androidx.activity:activity-ktx:1.1.0-alpha02 משוחררים. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תכונות חדשות

• SavedStateViewModelFactory הוא עכשיו המפעל שמוגדר כברירת מחדל כשמשתמשים ב-by viewModels(), ב-constructor של ViewModelProvider או ב-ViewModelProviders.of() עם ComponentActivity (b/135716331)

גרסה 1.1.0-alpha01

2 ביולי 2019

androidx.activity:activity:1.1.0-alpha01 ו-androidx.activity:activity-ktx:1.1.0-alpha01 משוחררים. אפשר למצוא כאן את ההתחייבות שכלולה בגרסה הזו.

תכונות חדשות

• עכשיו activity תלוי ב-Lifecycle 2.2.0-alpha02. (aosp/1007817)
• נוספה תלות של activity-ktx ב-lifecycle-runtime-ktx. כבר לא צריך להוסיף אותה באופן מפורש ליחסי התלות כשמשתמשים ב-activity-ktx או בספריות שתלות ב-activity-ktx (כמו fragment-ktx). (aosp/987162)

גרסה 1.0.0

גרסה 1.0.0

5 בספטמבר 2019

androidx.activity:activity:1.0.0 ו-androidx.activity:activity-ktx:1.0.0 משוחררים. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

תכונות עיקריות בגרסה 1.0.0

• ComponentActivity: ComponentActivity משמש כסיווג הבסיס החדש של FragmentActivity ב-Fragment 1.1.0, וכתוצאה מכך AppCompatActivity ב-AppCompat 1.1.0.
• activity-ktx: המודול activity-ktx כולל תוסף למאפיין by viewModels ב-Kotlin לגישה ל-ViewModels. המודול הזה נכלל באופן אוטומטי כאשר כוללים את fragment-ktx מ-Fragment 1.1.0.
• OnBackPressedDispatcher: כחלופה שניתנת ליצירה כדי לשנות את onBackPressed(), מעכשיו אפשר לרשום OnBackPressedCallback מכל LifecycleOwner (כמו קטע) כדי ליירט אירועים של לחצן החזרה לאחור במערכת. נוספה ל-activity-ktx פונקציית lambda עם גרסת נמען addCallback. פרטים נוספים זמינים במאמר הוספת תיעוד של ניווט מותאם אישית אחורה.
• הוצאה משימוש של onRetainCustomNonConfigurationInstance: ממשקי ה-API onRetainCustomNonConfigurationInstance() ו-getLastCustomNonConfigurationInstance() הקשורים הוצאו משימוש. מומלץ מאוד להשתמש ב-ViewModels כדי לאחסן מצב שאינו תצורה, כי הם מציעים פתרון שאפשר לשלב בכל ViewModelStoreOwner, שמבהיר את הבעלות על האובייקטים שנשמרים ומספק קריאה חוזרת (callback) מסוג onCleared() לניקוי המשאבים כשהפעילות נהרסת סופית.

גרסה 1.0.0-rc01

2 ביולי 2019

androidx.activity:activity:1.0.0-rc01 ו-androidx.activity:activity-ktx:1.0.0-rc01 שוחררו ללא שינויים מ-1.0.0-beta01. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

גרסה 1.0.0-beta01

5 ביוני 2019

הגרסאות androidx.activity::activity:1.0.0-beta01 ו-androidx.activity:activity-ktx:1.0.0-beta01 פורסמו ללא שינויים מ-1.0.0-alpha08. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

גרסה 1.0.0-alpha08

7 במאי 2019

androidx.activity:activity:1.0.0-alpha08 ו-androidx.activity:activity-ktx:1.0.0-alpha08 משוחררים. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

שינויים ב-API

• שינוי שפוגע בתאימות לאחור: השיטות addOnBackPressedCallback ו-removeOnBackPressedCallback ב-ComponentActivity, שהוצאו משימוש בעבר, הוסרו. aosp/953857
• השיטות setEnabled() ו-isEnabled() של OnBackPressedCallback הן סופיות עכשיו. b/131416833
• השיטה remove() של OnBackPressedCallback היא עכשיו סופית. aosp/952720
• ל-OnBackPressedDispatcher יש עכשיו קונסטרוקטורים ציבוריים, שמאפשרים ליצור מופעים משלכם לבדיקה וכו'. aosp/953431
• onBackPressed() עבור ComponentActivity מסומן עכשיו באופן מפורש כ-@MainThread aosp/952721

תיקוני באגים

• תוקנה בעיה ב-ConcurrentModificationException כשקוראים ל-remove() מתוך השיטה handleOnBackPressed() של OnBackPressedCalback שנוסף באמצעות LifecycleOwner. b/131765095

גרסה 1.0.0-alpha07

25 באפריל 2019

androidx.activity:activity:1.0.0-alpha07 ו-androidx.activity:activity-ktx:1.0.0-alpha07 משוחררים. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

שינויים ב-API

בגרסה הזו יש שינויים משמעותיים בטיפול ב-onBackPressed(). פרטים נוספים זמינים במסמכי התיעוד המעודכנים בנושא גיבוי בהתאמה אישית.

• השיטות של OnBackPressedCallback ושל OnBackPressedDispatcher סומנו כ-@MainThread. (aosp/943813)
• השיטה handleOnBackPressed() לא מחזירה יותר boolean. במקום זאת, OnBackPressedCallback היא עכשיו כיתה מופשטת שאפשר להפעיל או להשבית אותה – רק כשהשיטה החדשה isEnabled() מחזירה את הערך true, תתבצע קריאה ל-handleOnBackPressed(), שבה חובה לטפל בלחצן 'הקודם'. (aosp/944518)
• השיטות addCallback של OnBackPressedDispatcher כבר לא מחזירות מופע של Cancellable. OnBackPressedCallback כוללים עכשיו שיטת remove() שממלאת את הפונקציונליות הזו, ומאפשרת לך לקרוא ל-remove() במהלך handleOnBackPressed(). (aosp/944519) (aosp/946316)
• activity-ktx מכיל עכשיו קריאה חוזרת ברמת הנמען עבור addCallback שמקבלת פונקציית lambda שמטמיעה את handleOnBackPressed() ויש לה גישה ל-isEnabled ול-remove() (aosp/944520)

גרסה 1.0.0-alpha06

3 באפריל 2019

androidx.activity:activity:1.0.0-alpha06 ו-androidx.activity:activity-ktx:1.0.0-alpha06 משוחררים. כאן אפשר למצוא את ההתחייבויות (commits) שכלולות בגרסה הזו.

שינויים ב-API

• ComponentActivity מכיל עכשיו constructor נוסף של @LayoutRes int, שמחליף את ההתנהגות הקודמת של הוספת הערות למחלקה AppCompatActivity בכיתוב @ContentView. הגישה הזו פועלת גם במודולים של אפליקציות וגם במודולים של ספריות. (b/128352521)
• ממשקי ה-API הקשורים ל-OnBackPressedCallback ב-ComponentActivity הוצאו משימוש לטובת OnBackPressedDispatcher החדש, שאפשר לאחזר דרך getOnBackPressedDispatcher(). (aosp/922523)
• שיטות להוספת OnBackPressedCallback חדש ל-OnBackPressedDispatcher מחזירות עכשיו אובייקט Cancellable, שמאפשר להסיר את פונקציית ה-callback בלי צורך בהפניה מפורשת ל-OnBackPressedDispatcher. (aosp/922523)
• הוספה של OnBackPressedCallback עם LifecycleOwner משויך עכשיו, תוביל להוספה ולהסרה של OnBackPressedCallback כשמחזור החיים מתחיל ומופסק, בהתאמה. (aosp/922523)

גרסה 1.0.0-alpha05

13 במרץ 2019

androidx.activity:activity:1.0.0-alpha05 ו-androidx.activity:activity-ktx:1.0.0-alpha05 משוחררים. הרשימה המלאה של השינויים שכלולים במהדורה הזו מופיעה כאן.

תכונות חדשות

• חיפושי הערות ב-@ContentView שמורים עכשיו במטמון (b/123709449)

גרסה 1.0.0-alpha04

30 בינואר 2019

androidx.activity:activity 1.0.0-alpha04 ו-androidx.activity:activity-ktx 1.0.0-alpha04 משוחררים.

תכונות חדשות

• נוספה תמיכה בהערה של המחלקה @ContentView שמאפשרת לציין איזה קובץ XML של פריסה צריך להתנפח, כחלופה לשימוש ב-setContentView(). (aosp/837619)

שינויים ב-API

• הוספנו הערה שאסור לשנות את getViewModelStore(), והיא תהיה סופית בגרסה עתידית. אם אתם משנים את השיטה הזו כרגע, עליכם לשלוח בקשה להוספת תכונה. (aosp/837619)

תיקוני באגים

• המודול activity תלוי עכשיו בגרסה 2.1.0-alpha02 של ViewModel כדי להתאים לתלות של המודול activity-ktx.

גרסה 1.0.0-alpha03

17 בדצמבר 2018

androidx.activity 1.0.0-alpha03 משוחרר.

תכונות חדשות

• ComponentActivity מיישמת עכשיו את BundleSavedStateRegistryOwner ותלויה בספרייה SavedState שפורסמה לאחרונה [aosp/815133]
• עכשיו ComponentActivity פועלת סביב באג במסגרת Android שגורם ל-InputMethodManager לדלוף את התצוגה האחרונה שהתמקדו בה [b/37122102]

גרסה 1.0.0-alpha02

3 בדצמבר 2018

שינויים ב-API

• נוספה הערה שאסור לשנות את הערך של getLifecycle(), והוא ישתנה ל-final בגרסה עתידית. אם אתם משנים את השיטה הזו, עליכם לשלוח בקשה להוספת תכונה. (aosp/815834)

גרסה 1.0.0-alpha01

5 בנובמבר 2018

ב-androidx.activity 1.0.0-alpha01 מופיעה ComponentActivity, כיתת בסיס חדשה של FragmentActivity ו-AppCompatActivity הקיימים.

תכונות חדשות

• עכשיו אפשר לרשום OnBackPressedCallback דרך addOnBackPressedCallback כדי לקבל קריאות חזרה מסוג onBackPressed() בלי לשנות את השיטה בפעילות.
• נוספה by viewModels() חדשה של Kotlin לניהול נכסים, שמאפשרת לאחזר ViewModel מ-ComponentActivity.
• אירועי קלט בהמתנה (כמו קליקים) מבוטלים עכשיו ב-onStop().

שינויים ב-API

• ההטמעה של LifecycleOwner ו-ViewModelStoreOwner הועברה מ-FragmentActivity אל ComponentActivity.
• האפשרות onRetainCustomNonConfigurationInstance הוצאה משימוש. משתמשים ב-ViewModel כדי לאחסן אובייקטים שצריכים לשרוד שינויים בתצורה.