פעילות

גישה לממשקי API שאפשר להרכיב, שמבוססים על Activity.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫11 במרץ 2026 1.13.0 - - -

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

כדי להוסיף תלות ב-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"
}

Kotlin

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.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

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

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

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

עדכון תלות

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

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

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

עדכון תלות

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

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

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

תיקוני באגים

  • ‫From 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.

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

גרסה ‎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. מידע נוסף על הורים של תצוגות לא רציפות זמין בהערות הגרסה של ליבת או במאמרי העזרה בכתובת 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: תוקנה בעיה שבה ה-API של Activity Compose‏ PredictiveBackHandler המשיך לטפל בתנועת החלקה אחורה של המערכת במסגרת שבה הוא הושבת, מה שיכול היה לגרום לספריות כמו Navigation Compose לטפל בהחלקה אחורה גם עם מקבץ פעילויות קודמות (back stack) ריק, וכתוצאה מכך להקפיץ הודעת שגיאה (throw) את IndexOutOfBoundsException. (Ie3301, b/340202286)
  • מתוך Activity 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 מכילה את השמירות האלה.

עדכון תלות

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

תיקוני באגים

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

תיקוני באגים

  • ‫API‏ enableEdgeToEdge מצייר עכשיו מסביב לכל החלקים החסרים במסך. (a3644b, b/311173461)
  • מתוך Activity 1.8.2: תוקן הערך הנוסף שהועבר אל ACTION_SYSTEM_FALLBACK_PICK_IMAGES של Photo Picker Activity Contract כדי להעביר אליו את המפתח EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX בצורה נכונה, במקום להשתמש בערך הנוסף עם המפתח "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. כחלק מההמרה הזו, ה-method‏ getContract היא עכשיו מאפיין מופשט של Kotlin. זהו שינוי שמתאים לבינארי, אבל הוא עלול לשבור את הקוד אם ההטמעה של ActivityResultLauncher נכתבה ב-Kotlin. (Id4615)
  • ‫PickVisualMediaRequest כולל עכשיו את אותה רמת API מינימלית של 19 כמו חוזה התוצאה של הפעילות PickVisualMedia. (Id6e21)

עדכון תלות

גרסה 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 לקבל קריאה חוזרת (callback) בכל פעם שמספר הקריאות החוזרות המופעלות משתנה מאפס למספר שאינו אפס או להיפך.

תיקוני באגים

  • מתוך 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.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)

תיקוני באגים

  • תוקנה בעיה שבה מקטעים (Fragments) ביטלו באופן שגוי את התוקף של MenuHosts וגרמו להתנהגות לא צפויה בתפריטים אחרים בפעילות. (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.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 כוללת עכשיו קריאות חוזרות חדשות לחיזוי התקדמות החזרה, לטיפול בתנועת החזרה, להתקדמות במהלך התנועה ולביטול תנועת החזרה, בנוסף לקריאה החוזרת הקודמת 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 פיתוח נייטיב בתוך ComponentDialog כי הוא עומד בדרישות של LifecycleOwner ושל SavedStateRegistryOwner שמצורפים לחלון באמצעות ממשקי ה-API של ViewTree.
  • ‫IntentSenderRequest.Builder.setFlags() מאפשר עכשיו להגדיר כמה דגלים מ-Intent, ולא רק דגל אחד.

המרת Kotlin

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

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

פעילות 1.5 פעילות 1.6
override fun getActivityResultRegistry() = activityResultRegistry override val activityResultRegistry = activityResultRegistry
override fun getOnBackPressedDispatcher() = onBackPressedDispatcher override val onBackPressedDispatcher = onBackPressedDispatcher

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

‫FullyDrawnReporter APIs

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

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

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

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

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

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

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

עדכון תלות

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

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

  • ‫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 רשום עכשיו ב-OnBackInvokedCallback עם PRIORITY_DEFAULT במקום PRIORITY_OVERLAY. (I3901f)
  • בכיתות שמרחיבות את ComponentActivity, תמיד יישלחו שני הקריאות החוזרות (callback) של onMultiWindowModeChanged(). (Ic4d85)
  • הפונקציה ActivityResultRegistry לא תחזיר יותר תוצאה לפונקציה ActivityResultCallback אם הקריאה launch תזרוק Exception והקריאה החוזרת נרשמה ללא LifecycleOwner. (Ia7ff7, b/238350794)
  • ‫ComponentActivity מעכשיו, הפונקציה תשלח קריאות לתפריט בצורה תקינה בלי שתצטרכו להפעיל את פונקציית העל בפעילות. (Ie33c5, b/238057118)

עדכון תלות

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

תיקוני באגים

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

תכונות חדשות

  • שינויים משולבים בגרסת Dev Preview 2 של Android 13 ב-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)

עדכון תלות

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

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

גרסה ‎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() או מתוך קריאות חוזרות (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 יוכלו להגדיר את מאפיין המציין אם ערך יכול להיות ריק (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
  **/