פעילות

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

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

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

dependencies {
    def activity_version = "1.13.0"

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

dependencies {
    val activity_version = "1.13.0"

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

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

משוב

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

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.14

גרסה ‎1.14.0-alpha03

‫23 בספטמבר 2026

הגרסאות androidx.activity:activity:1.14.0-alpha03,‏ androidx.activity:activity-compose:1.14.0-alpha03 וגם androidx.activity:activity-ktx:1.14.0-alpha03 יוצאות. גרסה ‎1.14.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

• במקום זאת, צריך להשתמש ב-WindowCompat#enableEdgeToEdge(Window) במקום ב-EdgeToEdge#enable() (Ibff3e)
• הוצאו משימוש עומסי יתר של שדות טקסט ב-Material 2 שמקבלים פרמטרים של value, onValueChange. צריך לבצע מיגרציה ל-overload שמשתמש ב-TextFieldState כדי להעביר את המצב שלו. (I6b841, ‏ b/556234973)

תיקוני באגים

• התלות ב-androidx.lifecycle:lifecycle-runtime עודכנה ל-2.10.0. הגרסה הזו נדרשת כדי להריץ בדיקות lint של זמן ריצה של מחזור חיים בחבילה עם AGP בגרסה 9.5.0-alpha04 ואילך. (I99bfd, ‏ b/556807521)
• ComponentActivity החדש defaultViewModelArgs תומך עכשיו גם בהגדרת אתחול ישיר. (I10a08)

גרסה ‎1.14.0-alpha02

‫9 בספטמבר 2026

הגרסאות androidx.activity:activity:1.14.0-alpha02,‏ androidx.activity:activity-compose:1.14.0-alpha02 וגם androidx.activity:activity-ktx:1.14.0-alpha02 יוצאות. גרסה ‎1.14.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

• ‫compileSdk for Compose libraries updated to 37.1. כדי לעשות את זה, צריך לעדכן את compileSdk באופן טרנזיטיבי בכל האפליקציות והספריות שמשתמשות ב-Compose. (I05b0f)

גרסה ‎1.14.0-alpha01

‫26 באוגוסט 2026

הגרסאות androidx.activity:activity:1.14.0-alpha01,‏ androidx.activity:activity-compose:1.14.0-alpha01 וגם androidx.activity:activity-ktx:1.14.0-alpha01 יוצאות. גרסה ‎1.14.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• תוספים של כוונות לא מתווספים יותר באופן אוטומטי ל-defaultViewModelCreationExtras לפעילויות שמיוצאות. מפתחים של פעילויות מיוצאות יכולים לבטל את defaultViewModelArgs כדי לספק באופן מפורש תוספים מאומתים של כוונות. (Id0cb6, b/213646066)
• עכשיו יש ב-Activity פונקציות ליצירת מופעים של רכיבים בקלות: NavigationEventDispatcherOwner ו-OnBackPressedDispatcherOwner. (I1d259, ‏ Iadd5c)
• ‫OnBackPressedDispatcher מספקת עכשיו תוסף asNavigationEventDispatcher כדי להמיר אותה בקלות ל-NavigationEventDispatcher. (Id11cf)

גרסה 1.13

גרסה 1.13.0

‫11 במרץ 2026

הגרסאות androidx.activity:activity:1.13.0,‏ androidx.activity:activity-compose:1.13.0 וגם androidx.activity:activity-ktx:1.13.0 יוצאות. גרסה 1.13.0 מכילה את השמירות האלה.

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

• ‫ComponentActivity עכשיו מטמיע את הממשק OnPictureInPictureUiStateChangedProvider, מה שאומר שעכשיו הוא יכול להשתלב עם ארטיפקט core:core-pip החדש שמאפשר לכל רכיב לקבל אירועים של שינוי מצב ממשק משתמש של תמונה בתוך תמונה.
• EdgeToEdge מופעלת עכשיו מחדש בשינויים בהגדרות כדי לוודא שהצבע של סרגל הסטטוס של המערכת מתעדכן בצורה תקינה.

גרסה ‎1.13.0-rc01

‫25 בפברואר 2026

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

תיקוני באגים

• מתוך Activity 1.12.4: אפליקציית התמונות והסרטונים ActivityResultContracts תיפתח עכשיו בצורה תקינה כשמשתמשים בה במכשירים עם תיקוני האבטחה העדכניים ביותר של URI. ‫(I61201, ‏ b/433708587)

גרסה ‎1.13.0-alpha01

‫14 בינואר 2026

הגרסאות androidx.activity:activity:1.13.0-alpha01,‏ androidx.activity:activity-compose:1.13.0-alpha01 וגם androidx.activity:activity-ktx:1.13.0-alpha01 יוצאות. גרסה ‎1.13.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

• EdgeToEdge מופעלת עכשיו מחדש כשמתבצעים שינויים בהגדרות, כדי לוודא שהצבע של סרגל הסטטוס של המערכת מתעדכן בצורה תקינה. ‫(Id1381, ‏ b/364713509)

שינויים ב-API

• ‫ComponentActivity עכשיו מטמיע את הממשק OnPictureInPictureUiStateChangedProvider, מה שאומר שעכשיו הוא יכול להשתלב עם ארטיפקט core:core-pip החדש שמאפשר לכל רכיב לקבל אירועים של שינוי מצב ממשק משתמש של תמונה בתוך תמונה. ‫(I4df5c, ‏ b/441310308)

תיקוני באגים

• מגרסה Activity 1.12.2: תוקנה בעיה שבה הגדרה ידנית של isEnabled ב-OnBackPressedCallback עם מודעות למחזור החיים ביטלה את המצב Lifecycle, וגרמה לקריסות. (I7d898, ‏ b/461999811)

גרסה 1.12

גרסה 1.12.4

‫11 בפברואר 2026

הגרסאות androidx.activity:activity:1.12.4,‏ androidx.activity:activity-compose:1.12.4 וגם androidx.activity:activity-ktx:1.12.4 יוצאות. גרסה 1.12.4 מכילה את השמירות האלה.

תיקוני באגים

• האפליקציה 'תמונות וסרטונים' ActivityResultContracts תיפתח עכשיו בצורה תקינה כשמשתמשים בה במכשירים עם תיקוני האבטחה האחרונים של URI. ‫(I61201, ‏ b/433708587)

גרסה 1.12.3

‫28 בינואר 2026

הגרסאות androidx.activity:activity:1.12.3,‏ androidx.activity:activity-compose:1.12.3 וגם androidx.activity:activity-ktx:1.12.3 יוצאות. גרסה 1.12.3 מכילה את השמירות האלה.

גרסה 1.12.2

‫17 בדצמבר 2025

הגרסאות androidx.activity:activity:1.12.2,‏ androidx.activity:activity-compose:1.12.2 וגם androidx.activity:activity-ktx:1.12.2 יוצאות. גרסה 1.12.2 מכילה את השמירות האלה.

תיקוני באגים

• תוקנה בעיה שבה הגדרה ידנית של isEnabled ב-OnBackPressedCallback עם מודעות למחזור החיים ביטלה את המצב של מחזור החיים, וגרמה לקריסות. (I7d898, ‏ b/461999811)

גרסה 1.12.1

‫3 בדצמבר 2025

הגרסאות androidx.activity:activity:1.12.1,‏ androidx.activity:activity-compose:1.12.1 וגם androidx.activity:activity-ktx:1.12.1 יוצאות. גרסה 1.12.1 מכילה את השמירות האלה.

Updated Dependency

• הפעילות תלויה עכשיו ב-Navigation Event 1.0.1

גרסה 1.12.0

‫19 בנובמבר 2025

הגרסאות androidx.activity:activity:1.12.0,‏ androidx.activity:activity-compose:1.12.0 וגם androidx.activity:activity-ktx:1.12.0 יוצאות. גרסה 1.12.0 מכילה את השמירות האלה.

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

• הספרייה Androidx Activity תלויה עכשיו בספרייה החדשה NavigationEvent. התמיכה כוללת את NavigationEventDispatcher ב-ComponentActivity וב-ComponentDialog. בנוסף, ממשקי ה-API של OnBackPressed נכתבו מחדש על בסיס ממשקי ה-API של NavigationEvent כדי להבטיח תאימות לאחור עם הספרייה הקודמת.

גרסה ‎1.12.0-rc01

‫5 בנובמבר 2025

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

תיקוני באגים

• תיקון כשלים בזמן ריצה עבור BackHandler ו-PredictiveBackHandler באפליקציות שמשתמשות במחלקות Activity בהתאמה אישית. הקומפוזיציות האלה חוזרות עכשיו בבטחה ל-LocalOnBackPressedDispatcherOwner תוך שמירה על סדר השליחה באפליקציות שתומכות ב-NavigationEventDispatcherOwner. (I43873)

גרסה ‎1.12.0-beta01

‫22 באוקטובר 2025

הגרסאות androidx.activity:activity:1.12.0-beta01,‏ androidx.activity:activity-compose:1.12.0-beta01 וגם androidx.activity:activity-ktx:1.12.0-beta01 יוצאות. גרסה ‎1.12.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

• השקנו את ActivityFlags API הניסיוני לניהול שינויים בהתנהגות בזמן ריצה והעברות. הדגל הראשון מאפשר סדר יציב של OnBackPressedCallback, וכך הניווט אחורה הופך לצפוי יותר כשמתבצעים שינויים במחזור החיים. מפתחים יכולים לבטל את ההסכמה על ידי הגדרת ActivityFlags.isOnBackPressedLifecycleOrderMaintained = false. (I06bdf, ‏ Id08bb, ‏ I439aa, ‏ b/422730945, ‏ b/450533622)

עדכון תלות

• עדכון התלויות במחזור החיים לגרסה 2.9.4 ‏ (Ic9fb2)

גרסה ‎1.12.0-alpha09

‫24 בספטמבר 2025

הגרסאות androidx.activity:activity:1.12.0-alpha09,‏ androidx.activity:activity-compose:1.12.0-alpha09 וגם androidx.activity:activity-ktx:1.12.0-alpha09 יוצאות. גרסה ‎1.12.0-alpha09 מכילה את השמירות האלה.

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

• הפעילות תלויה עכשיו ב-Navigation Event 1.0.0-alpha08.

גרסה ‎1.12.0-alpha08

‫10 בספטמבר 2025

הגרסאות androidx.activity:activity:1.12.0-alpha08,‏ androidx.activity:activity-compose:1.12.0-alpha08 וגם androidx.activity:activity-ktx:1.12.0-alpha08 יוצאות. גרסה ‎1.12.0-alpha08 מכילה את השמירות האלה.

עדכון תלות

• הפעילות תלויה עכשיו ב-Navigation Event 1.0.0-alpha08.

גרסה ‎1.12.0-alpha07

‫27 באוגוסט 2025

הגרסאות androidx.activity:activity:1.12.0-alpha07,‏ androidx.activity:activity-compose:1.12.0-alpha07 וגם androidx.activity:activity-ktx:1.12.0-alpha07 יוצאות. גרסה ‎1.12.0-alpha07 מכילה את השמירות האלה.

תיקוני באגים

• תוקנה בעיה ב-EdgeToEdge ב-API 35 שבה תצוגות בלתי נראות גרמו להוספות בלתי צפויות של מדידות. (If49ff)

עדכון תלות

• הפעילות תלויה עכשיו באירוע הניווט 1.0.0-alpha07.

גרסה ‎1.12.0-alpha06

‫13 באוגוסט 2025

הגרסאות androidx.activity:activity:1.12.0-alpha06,‏ androidx.activity:activity-compose:1.12.0-alpha06 וגם androidx.activity:activity-ktx:1.12.0-alpha06 יוצאות. גרסה ‎1.12.0-alpha06 מכילה את השמירות האלה.

עדכון MinSdk

• ערך ברירת המחדל minSdk של AndroidX הועבר מ-API 21 ל-API 23 (‏Ibdfca, ‏ b/380448311, ‏ b/435705964, ‏ b/435705223)

עדכונים במאמרי העזרה

• עדכנו את מסמכי ה-KDocs של PredictiveBackHandler כדי לציין בעיה ידועה בתזמון, שבה יכול להיות שהמערכת תעבד תנועת מגע באותו פריים שבו היא מושבתת. (I5be5c, ‏ b/431534103)
• עדכנו את מסמכי ה-KDocs של BackHandler ושל PredictiveBackHandler כדי לציין במפורש את ההתנהגות של 'ההגדרה האחרונה שנוצרה היא זו שתקפה', בנוסף להמלצה על יצירת הגדרות ללא תנאים באמצעות הדגל enabled. (I7ab94)

עדכון של תלות

• הפעילות תלויה עכשיו באירוע הניווט 1.0.0-alpha06.

גרסה ‎1.12.0-alpha05

‫30 ביולי 2025

הגרסאות androidx.activity:activity:1.12.0-alpha05,‏ androidx.activity:activity-compose:1.12.0-alpha05 וגם androidx.activity:activity-ktx:1.12.0-alpha05 יוצאות. גרסה ‎1.12.0-alpha05 מכילה את השמירות האלה.

עדכון תלות

• הפעילות תלויה עכשיו באירוע הניווט 1.0.0-alpha05.

גרסה ‎1.12.0-alpha04

‫2 ביולי 2025

הגרסאות androidx.activity:activity:1.12.0-alpha04,‏ androidx.activity:activity-compose:1.12.0-alpha04 וגם androidx.activity:activity-ktx:1.12.0-alpha04 יוצאות. גרסה ‎1.12.0-alpha04 מכילה את השמירות האלה.

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

• הפעילות תלויה עכשיו ב-NavigationEvent Alpha04

גרסה ‎1.12.0-alpha03

‫18 ביוני 2025

הגרסאות androidx.activity:activity:1.12.0-alpha03,‏ androidx.activity:activity-compose:1.12.0-alpha03 וגם androidx.activity:activity-ktx:1.12.0-alpha03 יוצאות. גרסה ‎1.12.0-alpha03 מכילה את השמירות האלה.

תיקוני באגים

• הפונקציות OnBackPressedDispatcher ו-NavigationEventDispatcher מאותחלות עכשיו באופן עצל ב-ComponentActivity. (I710e6)

• תוקנו בעיות ב-OnBackPressedDistpatcher שגרמו לבעיות הבאות:

  • רק השולח האחרון של OnBackPressedCallback שנוסף יקבל התראה על המצב המופעל שלו (b/418715930)
  • ‫OnBackPressedDispatcher מסירה את הקריאה החוזרת הלא נכונה כשמשתמשים בפונקציה addCallback שמקבלת מחזור חיים. (b/422714753)
  • ‫OnBackPressedDispatcher.remove() לא מסיר את כל המופעים של OnBackPressedCallback רשום. (b/423024414)

גרסה ‎1.12.0-alpha02

‫4 ביוני 2025

הגרסאות androidx.activity:activity:1.12.0-alpha02,‏ androidx.activity:activity-compose:1.12.0-alpha02 וגם androidx.activity:activity-ktx:1.12.0-alpha02 יוצאות. גרסה ‎1.12.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

• ‫NavigationEvent 1.0.0-alpha02: תוקנה ConcurrentModificationException שיכולה לקרות כשקוראים ל-NavigationEventCallback.remove() בגלל שינוי בו-זמני של הרשימה הפנימית של רכיבים שניתן לסגור. (I63066)

גרסה ‎1.12.0-alpha01

‫20 במאי 2025

הגרסאות androidx.activity:activity:1.12.0-alpha01,‏ androidx.activity:activity-compose:1.12.0-alpha01 וגם androidx.activity:activity-ktx:1.12.0-alpha01 יוצאות. גרסה ‎1.12.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

• ‫ComponentActivity ו-ComponentDialog שולבו עם NavigationEvent 1.0.0-alpha01 באמצעות NavigationEventDispatcherOwner API. עכשיו אפשר לאחזר NavigationEventDispatcher מ-ComponentActivity דרך השדה navigationEventDispatcher. מאחר ש-OnBackPressedDispatcher נכתב מחדש על בסיס הספרייה החדשה, כל השימושים הקודמים אמורים להמשיך לפעול בצורה תקינה. מעכשיו צריך להשתמש ב-NavigationEventDispatcher וב-NavigationEventCallback. (Ib8eed, I6cc44, Ib7724, I9a0f7,b/412597031, b/415028038, b/412596729, b/412597140, b/412596012)

גרסה 1.11

גרסה 1.11.0

‫10 בספטמבר 2025

הגרסאות androidx.activity:activity:1.11.0,‏ androidx.activity:activity-compose:1.11.0 וגם androidx.activity:activity-ktx:1.11.0 יוצאות. גרסה 1.11.0 מכילה את השמירות האלה.

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

• נוסף MediaCapabilities API ל-PickVisualMediaRequest כדי לאפשר לאפליקציות לציין את יכולות המדיה שלהן, כמו סוגי HDR נתמכים.
• הפעילות נאספת עכשיו באמצעות API 36.

גרסה ‎1.11.0-rc01

‫23 באפריל 2025

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

גרסה ‎1.11.0-beta01

‫9 באפריל 2025

הגרסאות androidx.activity:activity:1.11.0-beta01,‏ androidx.activity:activity-compose:1.11.0-beta01 וגם androidx.activity:activity-ktx:1.11.0-beta01 יוצאות. גרסה ‎1.11.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.11.0-alpha02

‫26 במרץ 2025

הגרסאות androidx.activity:activity:1.11.0-alpha02,‏ androidx.activity:activity-compose:1.11.0-alpha02 וגם androidx.activity:activity-ktx:1.11.0-alpha02 יוצאות. גרסה ‎1.11.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

• שילבנו את EDGE_NONE וframeTimeMillis החדשים מ-Android 16 Beta03 ב-BackEventCompat שסופק על ידי הפונקציות handleOnBackStarted ו-handleOnBackProgressed של OnBackPressedCallback.

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

• הפעילות נאספת עכשיו באמצעות API ברמה 36. ‫(I510e8, ‏ b/301910674)

גרסה ‎1.11.0-alpha01

‫12 במרץ 2025

הגרסאות androidx.activity:activity:1.11.0-alpha01,‏ androidx.activity:activity-compose:1.11.0-alpha01 וגם androidx.activity:activity-ktx:1.11.0-alpha01 יוצאות. גרסה ‎1.11.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

• נוסף MediaCapabilities API ל-PickVisualMediaRequest כדי לאפשר לאפליקציות לציין את יכולות המדיה שלהן, כמו סוגי HDR נתמכים. (Ic3ee7)

גרסה 1.10

גרסה 1.10.1

‫26 בפברואר 2025

הגרסאות androidx.activity:activity:1.10.1,‏ androidx.activity:activity-compose:1.10.1 וגם androidx.activity:activity-ktx:1.10.1 יוצאות. גרסה 1.10.1 מכילה את השמירות האלה.

תיקוני באגים

• עכשיו אפשר לפתור את הבעיות שקשורות ל-ViewTree OnBackPressedDispatcherOwners ול-FullyDrawnReporterOwners באמצעות הורים לא רציפים של תצוגה, כמו ViewOverlay. מידע נוסף על הורים של תצוגות מנותקות מופיע בהערות הגרסה של Core או במסמכי התיעוד בכתובת ViewTree.setViewTreeDisjointParent. (Ie7750)

גרסה 1.10.0

‫15 בינואר 2025

הגרסאות androidx.activity:activity:1.10.0,‏ androidx.activity:activity-compose:1.10.0 וגם androidx.activity:activity-ktx:1.10.0 יוצאות. גרסה 1.10.0 מכילה את השמירות האלה.

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

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

גרסה ‎1.10.0-rc01

‫11 בדצמבר 2024

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

תיקוני באגים

• תוקנה הבעיה שבה שינוי המצב המופעל בזמן שה-PredictiveBackHandler פעיל כרגע גורם לקיצור דרך של הקריאה החוזרת באופן מיידי. הוא יסיים עכשיו את הקריאה החוזרת הנוכחית בלי קשר לשינויים בסטטוס המופעל. (Ib8719)

גרסה ‎1.10.0-beta01

‫13 בנובמבר 2024

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

גרסה ‎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)

תיקוני באגים

• מתוך Activity 1.9.3: PredictiveBackHandler לא יפעיל יותר את הקריאה החוזרת שלו אחרי שהמטפל יושבת. הפעולה הזו תפתור בעיה שבה NavHost מ-Navigation Compose יחזיר IndexOutOfBoundsException. ‫(I3f75e, ‏ b/365027664, ‏ b/340202286)

עדכון תלות

• הפעילות 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) ובכל הגרסאות כשמשתמשים ב-AGP 8.1 ואילך (למשל D8 גרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלץ לעדכן לגרסה 8.1 של D8 או לגרסה מאוחרת יותר. למידע נוסף, מומלץ לעיין במאמר הזה. (I9496c, ‏ b/345472586)
• מתוך Activity 1.9.2: תוקנה בעיה שבה Activity Compose PredictiveBackHandler API המשיך לטפל בתנועת החלקה אחורה במערכת במסגרת שבה הוא הושבת, מה שיכול היה לגרום לספריות כמו Navigation Compose לטפל בתנועת החלקה אחורה גם עם מקבץ פעילויות קודמות (back stack) ריק, וכתוצאה מכך להקפיץ הודעת שגיאה (throw) את 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 לא יפעיל יותר את הקריאה החוזרת אחרי שהמטפל מושבת. הפעולה הזו תפתור בעיה שבה 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 של Activity Compose המשיך לטפל בתנועת החלקה אחורה במערכת במסגרת שבה הוא הושבת, מה שיכול היה לגרום לספריות כמו Navigation Compose לטפל בתנועת החלקה אחורה גם עם מקבץ פעילויות קודמות (back stack) ריק, וכתוצאה מכך להקפיץ הודעת שגיאה (throw) את 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 כדי לאפשר לרכיבים קריאות חוזרות (callbacks) לאירועי onUserLeaveHint.
• ממשקי ה-API ‏OnBackPressedCallback, ‏BackHandler ו-PredictiveBackHandler מציגים עכשיו אזהרה כשמתבצעת קריאה ל-onBackPressedDispatcher.onBackPressed() במהלך טיפול בפעולת חזרה, כי הפעולה הזו תמיד תשבור את אנימציית החזרה החזויות. פרטים נוספים זמינים במדריך לשיטות מומלצות.
• שאר ממשקי ה-API של Activity נכתבו מחדש ב-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 מכילה את השמירות האלה.

תיקוני באגים

• תוקנה רגרסיה בביצועים של הפעלת פעילות שהוצגה בפעילות 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 מכילה את השמירות האלה.

אזהרת Lint

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

תיקוני באגים

• ‫enableEdgeToEdge API מצייר עכשיו מסביב לכל החלקים החסרים במסך. (a3644b, b/311173461)
• מתוך Activity 1.8.2: תוקן ה-extra שהועבר אל Photo Picker Activity Contract's 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 כדי לאפשר לרכיבים קריאות חוזרות (callbacks) לאירועי onUserLeaveHint. (I54892)

שינויים ב-API

• הקוד ComponentActivity שוכתב ב-Kotlin. (I14f31)
• הקוד ActivityResultCaller שוכתב ב-Kotlin. (Ib02e4)
• הקוד ActivityResultLauncher שוכתב ב-Kotlin. כחלק מההמרה הזו, השיטה getContract היא עכשיו מאפיין מופשט של Kotlin. זהו שינוי שמתאים לבינארי, אבל הוא גורם לשבירה של המקור אם ההטמעה של ActivityResultLauncher נכתבה ב-Kotlin. (Id4615)
• ל-PickVisualMediaRequest יש עכשיו את אותה רמת API מינימלית של 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 Composable לטיפול באירועים של חיזוי תנועת החזרה ב-Activity Compose. הוא מספק Flow של אובייקטים מסוג BackEventCompat שצריך לאסוף בלמדה של ההשעיה שסיפקתם:

  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 נוסף רכיב חדש של PredictiveBackHandler Composable לטיפול באירועים של חיזוי תנועת החזרה. היא מספקת 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 כשהיא מקבלת קריאה חוזרת (callback) של 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 מבטל עכשיו בצורה נכונה את כל הקריאות החוזרות (callbacks) שמוסרות במהלך חיזוי תנועת החזרה. (I3f90f)

שינויים ב-API

• כשמעבירים את SystemBarStyle.auto אל enableEdgeToEdge API, אפשר עכשיו לבטל את הפרמטר detectDarkMode lambda כדי לספק לוגיקה מותאמת אישית לזיהוי מצב לילה. (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

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

תיקוני באגים

• מתוך Activity 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 של Activity: - אין יותר דליפות של 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 יוצאות. הגרסה הזו נוצרה מענף פנימי.

תכונות חדשות

• המחלקות OnBackPressedCallback כוללות עכשיו קריאות חוזרות (callback) חדשות של התקדמות חיזוי תנועת החזרה, לטיפול בהתחלת תנועת החזרה, בהתקדמות שלה ובביטול שלה, בנוסף לקריאה החוזרת (callback) הקודמת 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

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

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

גם המחלקות האלה הומרו ל-Kotlin, אבל הן עדיין תואמות למקור: ContextAware,‏ ContextAwareHelper,‏ OnContextAvailableListener,‏ IntentSenderRequest ו-OnBackPressedDispatcher

‫FullyDrawnReporter APIs

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

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

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

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

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

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

• הפעילות תלויה עכשיו במחזור החיים 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 ליצרני ציוד מקורי ולאפליקציות מערכת שרוצים לספק חוויה עקבית של הכלי לבחירת תמונות. ההטמעה של הגיבוי הזה עדיין מוגבלת לאפליקציות מערכת בלבד. (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 למקרים שבהם הכלי לבחירת תמונות לא זמין, מגביל עכשיו בצורה נכונה את הטיפול באפליקציות שמותקנות בקובץ האימג' של המערכת במכשיר. (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 Activity Result ישתמשו עכשיו בכלי לבחירת תמונות שסופק על ידי Google Play Services, אם הוא זמין, במקרים שבהם הכלי לבחירת תמונות שסופק על ידי מערכת Android (לדוגמה, MediaStore.ACTION_PICK_IMAGES) לא זמין. הוצאנו משימוש את isPhotoPickerAvailable() API שמזהה רק את הכלי לבחירת תמונות שמסופק על ידי מערכת 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 Compose בתוך ComponentDialog כי הוא עומד בדרישות של LifecycleOwner ושל SavedStateRegistryOwner שמצורפים לחלון דרך ממשקי ViewTree API. (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 מכילה את השמירות האלה.

תיקוני באגים

• מתוך Activity 1.6.1: תוקנה בעיה בחוזה PickMultipleVisualMedia Activity Result שלא הופעל במכשירי 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 מכילה את השמירות האלה.

‫FullyDrawnReporter APIs

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

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

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

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

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

גרסה 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 מכילה את השמירות האלה.

תיקוני באגים

• נפתרה בעיה בחוזה PickMultipleVisualMedia Activity Result שלא הופעל במכשירי 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 רשום עכשיו ב-PRIORITY_DEFAULT במקום ב-PRIORITY_OVERLAYOnBackInvokedCallback. (I3901f)
• בכיתות שמרחיבות את ComponentActivity, תמיד יישלחו עכשיו שני קריאות החזרה (callback) של onMultiWindowModeChanged(). (Ic4d85)
• הפונקציה ActivityResultRegistry לא תחזיר יותר תוצאה לפונקציה ActivityResultCallback אם הקריאה לפונקציה launch תגרום לשגיאה Exception והקריאה החוזרת נרשמה ללא 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 מכילה את השמירות האלה.

תיקוני באגים

• הפעלת OnBackPressedDispatcher לא תגרום יותר ל-ClassVerificationError כשמשתמשים בגרסאות SDK שקודמות לגרסה 33. (Ic32e1)
• בכיתות שבהן מוגדרת החזרה (callback) של ComponentActivity ל-onPictureInPictureModeChanged(), ההחזרה הזו תמיד תופעל. (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 מכילה את השמירות האלה.

שינויים ב-API

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

תיקוני באגים

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

עדכון תלות

• מתוך Activity 1.5.1: הספרייה Activity מסתמכת עכשיו על גרסה Lifecycle 2.5.1. (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 בהתאם ל-Tiramisu Beta 3 SDK

תיקוני באגים

• תוקנה קריסה במכשירים ישנים יותר כשמבצעים בדיקת הרחבת 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 שבה ניסיון ליצור בקשה, באמצעות הכלי ליצירת בקשות או פונקציית Kotlin ברמה העליונה, היה גורם לגלישת מחסנית.
• שילבנו את 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 יוצאות.

• הערה: הגרסה הזו תעבור קומפילציה רק מול Android 13 Developer Beta 1 SDK.

תכונות חדשות

• הוספנו את ActivityResultContracts.PickVisualMedia ו-ActivityResultContracts.PickMultipleVisualMedia כדי לספק חוזה שתואם לאחור ומשתמש ב-MediaStore.ACTION_PICK_IMAGES כשכלי בחירת התמונות זמין, וב-Intent.ACTION_OPEN_DOCUMENT כשהוא לא זמין.
• שילבנו את OnBackInvokedCallback בגרסת הבטא הראשונה למפתחים של Android 13 בתוך 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 תצוגה מקדימה למפתחים 2 SDK.

תכונות חדשות

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

גירסה 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 מכילה את השמירות האלה.

תיקוני באגים

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

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

עדכון של תלות

• הספרייה Activity תלויה עכשיו ב-Lifecycle 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, וכך מאפשרת לתצוגות לאחזר את ה-dispatcher הנכון באופן כללי, בין אם הוא קיים ב-ComponentActivity או ב-ComponentDialog.
• ממשקי קריאה חוזרת (callback) – בספרייה ComponentActivity יש עכשיו קבוצה של ממשקי קריאה חוזרת מודולריים שאפשר להשתמש בהם במקום בקריאות החוזרות Activity. הממשקים האלה כוללים את: OnNewIntentProvider, ‏ OnConfigurationChangedProvider, ‏ OnTrimMemoryProvider, ‏ OnPictureInPictureModeChangedProvider, ‏ OnMultiWindowModeChangedProvider
• ‫CreationExtras Integration – ל-ComponentActivity יש עכשיו אפשרות לספק ViewModelProvider.Factory בלי שמירת מצב דרך Lifecycle 2.5.0’s CreationExtras.

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

• ה-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 מכילה את השמירות האלה.

תיקוני באגים

• השיטה ComponentActivity של onPanelClosed() קוראת עכשיו גם לשיטת העל 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. אם מספקים תוספים, המערכת מתעלמת מהארגומנטים שמוגדרים בהפעלה. ‫(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, במקום להסתמך על שימוש ב-Context. (I74685)

תיקוני באגים

• תוקנה קריסה שהתרחשה כשניסו לגשת ל-ViewModel בפעם הראשונה מתוך קריאה חוזרת (callback) של registerForActivityResult() או מתוך הקריאות החוזרות של 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 יוכלו להגדיר את מאפיין המציין אם ערך יכול להיות ריק (nullability) הנכון עבור מחלקות הקלט והפלט שלהם.
• המחלקות ActivityResultContracts והחוזים שלהן נכתבו מחדש ב-Kotlin כדי להבטיח את המאפיין הנכון של ציון האם ערך יכול להיות ריק (nullability).

גרסה ‎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 כחלק מהקומפוזיציה, כי הקומפוזיציה צריכה להיות ללא תופעות לוואי. להשתמש ב-APIs לטיפול בתופעות לוואי. ‫(7c2bbe, ‏ b/191347220)

שינויים ב-API

• הכיתה ActivityResultContract נכתבה מחדש ב-Kotlin כדי להבטיח שמפתחים שכותבים חוזים בהתאמה אישית ב-Kotlin יוכלו להגדיר את מאפיין המציין אם ערך יכול להיות ריק (nullability) הנכון עבור כיתות הקלט והפלט שלהם. (I8a8f5)
• הכיתה ActivityResultContracts והחוזים שלה נכתבו מחדש ב-Kotlin כדי להבטיח את המאפיין הנכון של ערך שיכול להיות ריק (nullability). (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 מכילה את השמירות האלה.

תכונות חדשות

• ‫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 יקפיץ הודעת שגיאה (throw) IllegalStateException כשמנסים להתקשר אל launch() ב-ActivityResultLauncher שלא נרשם או שבוטל הרישום שלו. ‫(Ida75d, ‏ b/192567522)

External Contribution

• תודה ל-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

• ארטיפקט Activity Compose – הארטיפקט activity-compose מספק את שיטת ההרחבה setContent לאירוח ממשק המשתמש של Jetpack Compose בפעילות, ועטיפות ספציפיות ל-Compose לאינטראקציה עם ממשקי ה-API של ComponentActivity לטיפול בכפתור 'הקודם' במערכת ובממשקי ה-API של תוצאות הפעילות. פרטים נוספים מופיעים במאמרי העזרה.
• ‫CaptureVideo contract – החוזה 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 מכילה את השמירות האלה.

תיקוני באגים

• הקריאות החוזרות (callbacks) מסוג 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

• הוסר ה-method‏ @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 מחזירה עכשיו launcher שמבטל את הפונקציה unregister() – הרישום והביטול של ה-launcher מטופלים אוטומטית על ידי 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 לא יגרום יותר להקפיץ הודעת שגיאה חיובית כוזבת של כלי לאיתור שגיאות בקוד שתנחה אתכם להשתמש ב-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

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

תיקוני באגים

• ה-BackHandler יתפוס עכשיו כמו שצריך את הלחיצות על לחצן החזרה במקרה שהפעילות היא STOPPED, ואז STARTED שוב, והוספנו קריאות חוזרות אחרות עם LifecycleOwner. ‫(I71de6, ‏ b/182284739)
• שימוש בתוסף של method‏ 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)
• מגרסה Activity 1.2.2: ComponentActivity לא מפעיל יותר ClassNotFoundException כשמפעילים Intent מתוך ActivityResultContract שהוחזק קודם כתוספת בתוך Intent אחר. ‫(Ieff05, ‏ b/182906230)

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

• מפעילות 1.2.2: הפעילות תלויה עכשיו במחזור החיים 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 מכילה את השמירות האלה.

תיקוני באגים

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

תכונות חדשות

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

שינויים ב-API

• LocalOnBackPressedDispatcherOwner כולל עכשיו provides פונקציות שאפשר להשתמש בהן עם CompositionLocalProvider, במקום ה-API של 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 מכילה את השמירות האלה.

תיקוני באגים

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

שינויים ב-API

• אפשר להשתמש ב-BackHandler API כדי לאפשר לרכיב Composable ליירט את הכפתור "הקודם" של המערכת. (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: עכשיו מתבצעת שמירה ושחזור תקינים של הקריאות החוזרות (callbacks) של ActivityResultRegistry, כך שהקריאות החוזרות לא משוכפלות ב-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 מכילה את השמירות האלה.

תיקוני באגים

• שימוש בתוסף של method‏ launch() עם ActivityResultContract מותאם אישית שיש לו קלט Unit לא יגרום יותר לשגיאה NullPointerException (I76282, ‏ b/183837954)
• תוקנה שגיאת lint חיובית כוזבת שדרשה שימוש ב-Fragment 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 lint שגרמה לתוצאת חיובית כוזבת כשנעשה שימוש ב-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

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

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

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

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

• ‫reportFullyDrawn() backport – שיטת Activity של reportFullyDrawn() עברה backport ב-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)

External Contribution

• הפונקציה ComponentActivity מחליפה עכשיו את הפונקציה reportFullyDrawn(), כך שאפשר להפעיל אותה בכל רמות ה-API. בנוסף, תוקן באג שגרם לקריסה כשמפעילים את הפונקציה הזו בלי הרשאת המערכת המתאימה במכשירים עם 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 לא המתין עד ש-Lifecycle היה STARTED לפני שהעביר תוצאות כשנרשם עם Lifecycle. (I109ea)

External Contribution

• עדכנו את המסמכים של launch() כדי לציין במפורש שהוא יכול להקפיץ הודעת שגיאה ActivityNotFoundException. תודה למיכל ז'ילינסקי! (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(), וכך נמנעת אפשרות של הצפת מספרים שלמים שנגרמת מהגדלה של קודי בקשות. (b/168779518)

• הסרה של Lifecycle observers מתבצעת בצורה תקינה כשמפעילים את unregister() ב-ActivityResultLauncher. (b/165608393)

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

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

עדכון מאמרי העזרה

• ContextAware קישורים למסמכי התיעוד של LifecycleOwner כדי להדגיש את Lifecycle callbacks כמקום המתאים לאירועי יצירה והשמדה. (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)
  • ‫AppCompatActivity משתמש ב-API הזה ב-AppCompat 1.3.0-alpha02. כל מאזין שנוסף לתת-מחלקות של AppCompatActivity יפעל אחרי המאזין הזה. (I513da)

תיקוני באגים

• תוקנה בעיה בActivityResultFragmentVersionDetector Lint check שגרמה להפסקת הפעולה כשנעשה שימוש ב-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 lint check חדש שמוודא שאתם משתמשים ב-Fragment 1.3.0-alpha07 כשאתם משתמשים ב-Activity Result API, כדי למנוע קריסות בזמן ריצה בגלל בעיות שקשורות ל'קוד בקשה לא תקין' ובקשות הרשאה שלא פועלות בגלל שימוש בגרסאות ישנות יותר של Fragments. (b/152554847)

External Contribution

• תוקנה שגיאה 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 ב-Kotlin כדי לגשת ישירות אל requestCode ו-intent. (b/157212935)
• ‫ActivityResultLauncher מאפשרת עכשיו לקבל את ActivityResultContract ששימש לרישום של מרכז האפליקציות. (b/156875743)

שינויים ב-API

• שינוי שעלול לשבור את התאימות לאחור: השם של השיטה invoke() ב-ActivityResultRegistry השתנה ל-onLaunch(). (b/157496491)
• אם לא מוחזרת תוצאה, החוזה OpenMultipleDocuments מחזיר עכשיו רשימה ריקה במקום null לקריאה החוזרת הרשומה. (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 מ-Lifecycle 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)
• ה-methods‏ IntentSenderRequest.Builder של setFlagsMask() ו-setFlagsValues() שולבו ל-method‏ setFlags() אחת. (aosp/1302111)

תיקוני באגים

• כשרושמים ActivityResultCallback עם LifecycleOwner, תוקנה בעיה שבה הקריאה החוזרת הופעלה לפני שהמצב הגיע ל-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 לממשקי ActivityResult API. (b/153007517)

שינויים ב-API

• השם של השיטה 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)
• ממשקי Activity Result API תומכים עכשיו בהפעלת פעילות לקבלת תוצאה עם ActivityOptionsCompat אופציונלי. (b/151860054)

שינויים ב-API

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

תיקוני באגים

• תוקן באג NullPointerException ב-ActivityResultRegistry כשמנסים להעביר תוצאות לקריאה חוזרת (callback) שלא נרשמה מחדש אחרי שינוי בהגדרות. עכשיו 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)

תיקוני באגים

• תוקנה רגרסיה שהוצגה בגרסה 1.1.0 של Activity כשמריצים אותה בגרסאות ישנות יותר של הפלטפורמה, שבהן 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

• שילוב של Lifecycle ViewModel SavedState: SavedStateViewModelFactory היא עכשיו הגדרת ברירת המחדל של factory שמשמשת כשמשתמשים ב-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 stable.

גרסה ‎1.1.0-alpha03

‫5 בספטמבר 2019

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

תכונות חדשות

• הפעילות תלויה עכשיו בגרסה יציבה של 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 מופצים. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תכונות חדשות

• מעכשיו, SavedStateViewModelFactory היא ברירת המחדל של הפקטורי (factory) שמשמשת כשמשתמשים ב-by viewModels(), בבונה 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 מופצים. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

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

• ‫ComponentActivity: ComponentActivity משמשת כמחלקת הבסיס החדשה ל-FragmentActivity ב-Fragment 1.1.0, וכתוצאה מכך גם ל-AppCompatActivity ב-AppCompat 1.1.0.
• ‫activity-ktx: המודול activity-ktx כולל הרחבת מאפיין Kotlin‏ by viewModels לגישה ל-ViewModels. המודול הזה נכלל באופן אוטומטי כשמייבאים את fragment-ktx מ-Fragment 1.1.0.
• ‫OnBackPressedDispatcher: כחלופה קומפוזבילית לשינוי מברירת המחדל של onBackPressed(), אפשר עכשיו לרשום OnBackPressedCallback מכל LifecycleOwner (כמו מקטע (fragment)) כדי ליירט אירועים של הכפתור "הקודם" במערכת. פונקציית lambda עם גרסת מקלט addCallback נוספה ל-activity-ktx. פרטים נוספים מופיעים במאמר הוספת תיעוד של ניווט לאחור מותאם אישית.
• הוצאה משימוש של onRetainCustomNonConfigurationInstance: הוצאנו משימוש את onRetainCustomNonConfigurationInstance() ואת ממשקי ה-API הקשורים 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. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

גרסה ‎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. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

גרסה ‎1.0.0-alpha08

‫7 במאי 2019

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

שינויים ב-API

• שינוי שעלול לשבור תאימות: הוסרו השיטות addOnBackPressedCallback ו-removeOnBackPressedCallback שהוצאו משימוש בעבר ב-ComponentActivity. aosp/953857
• ה-methods‏ setEnabled() ו-isEnabled() של OnBackPressedCallback הן עכשיו סופיות. b/131416833
• השיטה remove() של OnBackPressedCallback היא עכשיו סופית. aosp/952720
• ‫OnBackPressedDispatcher כולל עכשיו constructors ציבוריים, שמאפשרים ליצור מופעים משלכם לצורך בדיקה וכו'. aosp/953431
• ‫onBackPressed() for ComponentActivity is now explicitly marked as @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 מופצים. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

שינויים ב-API

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

• ה-methods של OnBackPressedCallback ושל OnBackPressedDispatcher סומנו כ-@MainThread. (aosp/943813)
• השיטה handleOnBackPressed() לא מחזירה יותר boolean. במקום זאת, OnBackPressedCallback היא עכשיו מחלקה מופשטת שאפשר להפעיל או להשבית – רק אם ה-method החדשה isEnabled() מחזירה true, יתבצע קריאה ל-handleOnBackPressed(), שבו חובה לטפל בכפתור 'הקודם'. (aosp/944518)
• השיטות addCallback של OnBackPressedDispatcher כבר לא מחזירות מופע של Cancellable. OnBackPressedCallback כוללים עכשיו את ה-method‏ remove() שממלא את הפונקציונליות הזו, ומאפשר לכם לקרוא ל-remove() במהלך handleOnBackPressed(). (aosp/944519) (aosp/946316)
• ‫activity-ktx מכיל עכשיו קריאה חוזרת בהיקף של מקלט עבור addCallback שמקבלת lamdba שמטמיעה את 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 מופצים. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

שינויים ב-API

• המחלקות ComponentActivity כוללות עכשיו בנאי שני שמקבל @LayoutRes int, שמחליף את ההתנהגות הקודמת של הוספת הערה למחלקה AppCompatActivity באמצעות @ContentView. הגישה הזו פועלת גם במודולים של אפליקציות וגם במודולים של ספריות. (b/128352521)
• ממשקי ה-API הקשורים OnBackPressedCallback ב-ComponentActivity הוצאו משימוש לטובת OnBackPressedDispatcher החדש, שאפשר לאחזר באמצעות getOnBackPressedDispatcher(). (aosp/922523)
• שיטות להוספת OnBackPressedCallback חדש ל-OnBackPressedDispatcher מחזירות עכשיו אובייקט Cancellable, שמאפשר להסיר את הקריאה החוזרת בלי לדרוש הפניה מפורשת ל-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 מופצים. כאן אפשר למצוא את הרשימה המלאה של פעולות ה-commit שנכללות בגרסה הזו.

תכונות חדשות

• @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 כדי לקבל קריאות חוזרות (callback) של onBackPressed() בלי להחליף את השיטה בפעילות.
• נוסף נציג מאפיינים חדש של Kotlin לאחזור by viewModels() ViewModel מ-ComponentActivity.
• אירועי קלט בהמתנה (כמו קליקים) מבוטלים עכשיו ב-onStop().

שינויים ב-API

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