فعالیت
آخرین به روز رسانی | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
---|---|---|---|---|
4 سپتامبر 2024 | 1.9.2 | - | - | 1.10.0-alpha02 |
اعلام وابستگی ها
برای افزودن وابستگی به Activity، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر ، مخزن Maven Google را بخوانید.
وابستگیهای مصنوعات مورد نیاز خود را در فایل build.gradle
برای برنامه یا ماژول خود اضافه کنید:
شیار
dependencies { def activity_version = "1.9.2" // Java language implementation implementation "androidx.activity:activity:$activity_version" // Kotlin implementation "androidx.activity:activity-ktx:$activity_version" }
کاتلین
dependencies { val activity_version = "1.9.2" // Java language implementation implementation("androidx.activity:activity:$activity_version") // Kotlin implementation("androidx.activity:activity-ktx:$activity_version") }
برای اطلاعات بیشتر درباره وابستگیها، به افزودن وابستگیهای ساخت نگاه کنید.
بازخورد
بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.
برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.
نسخه 1.10
نسخه 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
Activity Result که فعال میشوند، اگر انتخابگر عکس سیستم در دسترس نباشد، Photo Picker دیگر مستقیماً به سرویسهای Google Play واگذار نمیشود، اما از کنش عمومیACTION_SYSTEM_FALLBACK_PICK_IMAGES
و موارد اضافی مرتبط برای ارائه تجربهای ثابت Photo Picker به OEM و برنامههای سیستمی استفاده میکند. به عنوان یک بازگشت این نباید تأثیری بر تجربه کاربری دستگاههایی که نسخه اخیر سرویسهای 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 ComposePredictiveBackHandler
API به کنترل ژست برگشت سیستم در فریمی که غیرفعال شده بود، ادامه میداد، که میتواند منجر به این شود که کتابخانههایی مانند Navigation Compose حتی با پشته خالی پشتیبان را مدیریت کنند، و در نتیجه یکIndexOutOfBoundsException
پرتاب می کند. ( Ie3301 , b/340202286 ) - از فعالیت
1.9.1
: مشکلی درPredictiveBackHandler
برطرف شد که در آن پس از انجام بازگشت سیستم، تلاش برای انجامonBackPressed
ازOnBackPressedDispatcher
با شکست مواجه میشد. ( I5f1f8 )
نسخه 1.10.0-alpha01
26 ژوئن 2024
androidx.activity:activity:1.10.0-alpha01
، androidx.activity:activity-compose:1.10.0-alpha01
و androidx.activity:activity-ktx:1.10.0-alpha01
منتشر شدند. این نسخه در یک شعبه داخلی توسعه یافته است.
ویژگی های جدید
- اضافه شدن پشتیبانی از ویژگی های جدید
PhotoPicker
که در Android V معرفی شده اند، از جمله امکان انتخاب تصاویر به ترتیب و انتخاب تب (اعم از آلبوم ها یا تصاویر) که باید در ابتدا قابل مشاهده باشند.
نسخه 1.9
نسخه 1.9.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 حاوی این lthcocommit ها است.
رفع اشکال
- مشکلی را برطرف کرد که در آن Activity Compose
PredictiveBackHandler
API به کنترل ژست برگشت سیستم در فریمی که غیرفعال شده بود ادامه میداد، که میتوانست منجر به این شود که کتابخانههایی مانند Navigation Compose حتی با پشته خالی پشتیبان را مدیریت کنند و در نتیجه یک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 شامل این commit ها است.
رفع اشکال
- مشکلی در
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 شامل این commit ها است.
تغییرات مهم از 1.8.0
-
ComponentActivity
اکنونOnUserLeaveHintProvider
را پیاده سازی می کند تا به کامپوننت ها اجازه دهد تا برای رویدادهایonUserLeaveHint
تماس بگیرند. - APIهای
OnBackPressedCallback
،BackHandler
وPredictiveBackHandler
اکنون هنگام تماس باonBackPressedDispatcher.onBackPressed()
هنگام بازگردانی هشدار می دهند زیرا همیشه انیمیشن Back Predictive Back را شکسته می کند. برای جزئیات بیشتر به راهنمای بهترین شیوه ها مراجعه کنید. - بقیه 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 حاوی این commit ها است.
به روز رسانی وابستگی
- اکنون فعالیت به Profile Installer 1.3.1 بستگی دارد.
نسخه 1.9.0-beta01
20 مارس 2024
androidx.activity:activity:1.9.0-beta01
، androidx.activity:activity-compose:1.9.0-beta01
و androidx.activity:activity-ktx:1.9.0-beta01
منتشر شدند. نسخه 1.9.0-beta01 حاوی این تعهدات است.
رفع اشکال
- یک رگرسیون عملکرد راهاندازی Activity معرفی شده در Activity
1.9.0-alpha02
که با فراخوانیOnBackPressedDispatcher
به عنوان بخشی از ایجاد فعالیت ایجاد شده بود، رفع شد. ( Ie75e3 )
نسخه 1.9.0-alpha03
7 فوریه 2024
androidx.activity:activity:1.9.0-alpha03
، androidx.activity:activity-compose:1.9.0-alpha03
و androidx.activity:activity-ktx:1.9.0-alpha03
منتشر شدند. نسخه 1.9.0-alpha03 حاوی این commit ها است.
اخطار لینت
- APIهای
OnBackPressedCallback
،BackHandler
وPredictiveBackHandler
اکنون هنگام تماس باonBackPressedDispatcher.onBackPressed()
هنگام بازگردانی هشدار می دهند زیرا همیشه انیمیشن Back Predictive Back را شکسته می کند. برای جزئیات بیشتر به راهنمای بهترین شیوه ها مراجعه کنید. ( 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 حاوی این commit ها است.
تبدیل کاتلین
-
ActivityResultRegistry
در Kotlin بازنویسی شده است. این تضمین میکند که باطلپذیری ژنریکهای قراردادی که برای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 ) - از فعالیت
1.8.2
: موارد اضافی ارسال شده بهACTION_SYSTEM_FALLBACK_PICK_IMAGES
قرارداد فعالیت انتخابگر عکس را برطرف کرد تا بهجای استفاده از کلید اضافی با کلید"com.google.android.gms.provider.extra.PICK_IMAGES_MAX"
به درستی کلیدEXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX
ارسال شود. اکیداً توصیه میشود اگر یک OEM هستید که یک سیستم Photo Picker را پیادهسازی میکند تا از هر دو ویژگی اضافی برای اطمینان از وسیعترین سازگاری پشتیبانی کند. ( 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 حاوی این commit ها است.
ویژگی های جدید
-
ComponentActivity
اکنونOnUserLeaveHintProvider
را پیاده سازی می کند تا به کامپوننت ها اجازه دهد تا برای رویدادهایonUserLeaveHint
تماس بگیرند. ( I54892 )
تغییرات API
-
ComponentActivity
در Kotlin بازنویسی شده است. ( I14f31 ) -
ActivityResultCaller
در Kotlin بازنویسی شده است. ( Ib02e4 ) -
ActivityResultLauncher
در Kotlin بازنویسی شده است. به عنوان بخشی از این تبدیل، متدgetContract
اکنون یک ویژگی انتزاعی Kotlin است. این یک تغییر سازگار باینری است، اما اگر اجرایActivityResultLauncher
شما در Kotlin نوشته شده باشد، منبع شکسته است. ( شناسه 4615 ) -
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 حاوی این commit ها است.
رفع اشکال
- موارد اضافی ارسال شده به
ACTION_SYSTEM_FALLBACK_PICK_IMAGES
قرارداد فعالیت انتخابگر عکس را برطرف کرد تا بهجای استفاده از کلید اضافی با کلید"com.google.android.gms.provider.extra.PICK_IMAGES_MAX"
، آن را به درستی بهEXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX
منتقل کنید. اکیداً توصیه میشود اگر یک OEM هستید که یک سیستم Photo Picker را پیادهسازی میکند تا از هر دو ویژگی اضافی برای اطمینان از وسیعترین سازگاری پشتیبانی کند. ( 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 حاوی این commit ها است.
رفع اشکال
-
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 حاوی این commit ها است.
تغییرات مهم از 1.7.0
- برگشت پیشگو -
OnBackPressedCallback
اکنون تماس های برگشتی پیشگویانه جدیدی را برای مدیریت شروع حرکت، پیشرفت در طول حرکت، و لغو ژست برگشتی علاوه بر فراخوان قبلیhandleOnBackPressed()
برای زمانی که ژست برگشتی انجام می شود، ارائه می دهد. این همچنین باPredictiveBackHandler
Composable ارائه میشود تا رویدادهای پیشگویانه اشارهای را در Activity Compose مدیریت کند. این یک جریان از اشیاء 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 حاوی این commit ها است.
نسخه 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 حاوی این commit ها است.
ویژگی های جدید
Activity Compose یک
PredictiveBackHandler
Composable جدید اضافه کرده است تا رویدادهای پیشبینی کننده ژستهای برگشتی را مدیریت کند. این یک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 } }
همچنین با یک اخطار زمان کامپایل از طریق قانون lint ارائه می شود تا اطمینان حاصل شود که فراخوانی های
Flow
collect()
. ( Id2773 , b/294884345 )onBackPressedDispatcher
درComponentActivity
اکنون با تنبلی مقداردهی اولیه می شود، به طوری که فقط در صورت نیاز ایجاد می شود. ( I0bf8e )
رفع اشکال
-
ComponentActivity
دیگر NPE را در Android 13 نشان نمیدهد، زمانی که یک تماسonBackPressed()
دریافت میکند و Activity قبلاًDESTROYED
شده است. ( Idb055 , b/291869278 ) - کاربردهای حذف شده آزمایشی
isAtLeastU()
API ( 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 حاوی این commit ها است.
ویژگی های جدید
-
OnBackPressedDispatcher
اکنون به درستی همه تماسهایی را که در طول یک حرکت پیشگویانه برگشت حذف میشوند، لغو میکند. ( I3f90f )
تغییرات API
- هنگامی که
SystemBarStyle.auto
را بهenableEdgeToEdge
API ارسال می کنید، اکنون می توانید پارامتر lambdadetectDarkMode
را لغو کنید تا منطق سفارشی برای تشخیص حالت شب ارائه دهید. ( aosp/2546393 , b/278263793 )
نسخه 1.8.0-alpha05
7 ژوئن 2023
androidx.activity:activity:1.8.0-alpha05
، androidx.activity:activity-compose:1.8.0-alpha05
و androidx.activity:activity-ktx:1.8.0-alpha05
منتشر شدند. این نسخه در یک شعبه داخلی توسعه یافته است.
تغییرات API
- Activity اکنون یک کلاس
BackEventCompat
را ارائه می دهد که به عنوان یک نسخه سازگار با عقب ازBackEvent
که از کلاسBackEvent
چارچوب جدا شده است، عمل می کند. - شکستن تغییر: روش های
handleOnBackStarted
وhandleOnBackProgressed
OnBackPressedCallback
اکنون به جای یک کلاسandroid.window.BackEvent
یک نمونهandroidx.activity.BackEventCompat
دریافت می کنند. APIهای معادل@VisibleForTesting
درOnBackPressedDispatcher
نیز بهروزرسانی شدهاند. - سازنده
OnBackPressedDispatcher
اکنون یک نمونه اختیاریConsumer<Boolean>
می گیرد که به صاحبان توزیع کننده اجازه می دهد هر زمان که تعداد تماس های برگشتی فعال شده از صفر به غیرصفر یا برعکس تغییر تماس دریافت کنند.
رفع اشکال
- از فعالیت
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
منتشر شدند. این از یک شعبه داخلی منتشر شد.
رفع اشکال
- از Activity 1.7.1 : -
ReportFullyDrawExecuter
دیگر هنگام استفاده ازComponentActivity
باActivityScenario
لو نمیدهد. ( ID2ff2 , b/277434271 )
نسخه 1.8.0-alpha03
12 آوریل 2023
androidx.activity:activity:1.8.0-alpha03
، androidx.activity:activity-compose:1.8.0-alpha03
و androidx.activity:activity-ktx:1.8.0-alpha03
منتشر شدند. این از یک شعبه داخلی منتشر شد.
ویژگی های جدید
-
ComponentActivity.setUpEdgeToEdge()
اضافه شد تا به راحتی صفحه نمایش لبه به لبه را به روشی سازگار با عقب تنظیم کند.
تغییرات API
-
ComponentActivity.onBackPressed()
اکنون به نفع APIها برای مدیریت برگشت منسوخ شده است. توسعه دهندگان اکنون باید ازOnBackPressedDispatcher
استفاده کنند، نه اینکه این روش را نادیده بگیرند. ( Ibce2f , b/271596918 ) -
ComponentDialog
وComponentActivity
اکنون حاوی API عمومیinitViewTreeOwners()
هستند تا قبل از تنظیم نمای محتوا برای مقداردهی اولیه همه صاحبان درخت view استفاده شود. ( Ibdce0 , b/261314581 )
رفع اشکال
- مشکلی که در آن Fragments به اشتباه MenuHosts را باطل می کرد و باعث می شد منوهای دیگر در Activity رفتار غیرمنتظره ای داشته باشند، برطرف شد. ( I9404e , b/244336571 )
سایر تغییرات
-
ActivityResultRegister
اکنون به جای جاوا از KotlinRandom
استفاده می کند. ( 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
منتشر شدند. از یک شاخه داخلی توسعه یافته است.
به روز رسانی وابستگی
- از Activity
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
اکنون شامل فراخوانهای پیشبینیکننده پیشرفت بازگشتی جدید برای مدیریت شروع حرکت برگشتی، پیشرفت در طول ژست، و لغو ژست برگشتی علاوه بر تماس قبلی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 حاوی این commit ها است.
رفع اشکال
- رفع خرابی
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 حاوی این commit ها است.
رفع اشکال
- هنگام استفاده از
ComponentActivity
باActivityScenario
ReportFullyDrawExecuter
دیگر درز نمی کند. ( 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 حاوی این commit ها است.
تغییرات مهم از 1.6.0
- قراردادهای فعالیت Photo Picker در
PickVisualMedia
وPickMultipleVisualMedia
بهروزرسانی شدهاند تا حاوی یک بک گراند اضافی برای زمانی کهMediaStore.ACTION_PICK_IMAGES
در دسترس نیست.ACTION_PICK_IMAGES که به OEMها و برنامههای سیستمی، مانند سرویسهای Google Play اجازه میدهد تا تجربه یکدستی از Photo Picker را در گستره وسیعتری از Android ارائه دهند. دستگاه ها و سطوح API با اجرای عمل بازگشتی . در صورتی که Photo Picker قبل از استفاده ازIntent.ACTION_OPEN_DOCUMENT
در دسترس باشد، از این بازگشتی استفاده میکند، که همچنان از همه دستگاههای API 19 و بالاتر پشتیبانی میکند. -
ComponentDialog
اکنونSavedStateRegistryOwner
را پیاده سازی می کند و بهSavedStateRegistry
خود دسترسی دارد وSavedStateRegistryOwner
برایViewTree
خود تنظیم می کند. اکنون میتوان از Jetpack Compose در یکComponentDialog
استفاده کرد، زیرا همLifecycleOwner
و همSavedStateRegistryOwner
را که از طریق الزامات APIهایViewTree
به پنجره متصل شدهاند، برآورده میکند. -
IntentSenderRequest.Builder.setFlags()
اکنون به شما اجازه می دهد تا به جای یک پرچم، چندین پرچم را ازIntent
تنظیم کنید.
تبدیل کاتلین
تعدادی از کلاس های Activity به Kotlin تبدیل شده اند. همه کلاس های تبدیل شده هنوز سازگاری باینری خود را با نسخه های قبلی حفظ می کنند. کلاس های زیر دارای تغییرات ناسازگار منبع برای کلاس های نوشته شده در Kotlin هستند: ActivityResultRegistryOwner
، OnBackPressedDispatcherOwner
.
جدول زیر تبدیل منبع برای نسخه جدید Activity را ارائه می دهد:
فعالیت 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
API های FullyDrawnReporter
ComponentActivity
اکنون یک نمونه FullyDrawnReporter
را ارائه می دهد که به چندین مؤلفه اجازه می دهد زمانی که برای تعامل آماده هستند گزارش دهند. ComponentActivity
قبل از فراخوانی reportFullyDrawn()
از طرف شما منتظر می ماند تا تمام کامپوننت ها تکمیل شوند. این APIها از الزامات زمانبندی برای شما مراقبت میکنند و نیازی به فراخوانی به عنوان بخشی از تماس onDraw
ندارند.
این APIها تشویق می شوند تا فعال شوند:
- زمانی که راهاندازی کامل میشود، زمان اجرای Android را علامتگذاری کنید تا مطمئن شوید که تمام کد اجرا شده در طول یک دنباله راهاندازی چند فریمی گنجانده شده است و برای جمعآوری پسزمینه اولویتبندی میشود.
- هنگامی که برنامه شما باید به طور کامل برای معیارهای راه اندازی در نظر گرفته شود، سیگنال Macrobenchmark و Play Vitals را نشان می دهد، بنابراین می توانید عملکرد را ردیابی کنید.
سه API Activity Compose اضافه شدهاند تا استفاده از FullyDrawnReporter
را از تک تک اجزای سازنده راحتتر کند:
-
ReportDrawn
نشان می دهد که composable شما بلافاصله برای تعامل آماده است. -
ReportDrawnWhen
یک گزاره می گیرد (یعنیlist.count > 0
) تا نشان دهد که سازنده شما چه زمانی برای تعامل آماده است. -
ReportDrawnAfter
یک روش تعلیق را انتخاب می کند که وقتی کامل شد، نشان می دهد که شما برای تعامل آماده هستید.
به روز رسانی های وابستگی
- اکنون فعالیت به Lifecycle
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 حاوی این commit ها است.
به روز رسانی وابستگی
- اکنون فعالیت به
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
در دسترس نیست استفاده میشود.ACTION_PICK_IMAGES اکنون ثابتهای عمومی هستند که ثبات API را برای OEMها و برنامههای سیستمی که میخواهند تجربه یکدستی از Photo Picker ارائه دهند، فراهم میکنند. اجرای این بازگشتی هنوز فقط به برنامه های سیستمی محدود می شود. ( ICD320 )
نسخه 1.7.0-beta01
8 فوریه 2023
androidx.activity:activity:1.7.0-beta01
، androidx.activity:activity-compose:1.7.0-beta01
و androidx.activity:activity-ktx:1.7.0-beta01
منتشر شدند. نسخه 1.7.0-beta01 حاوی این تعهدات است.
ویژگی های جدید
-
IntentSenderRequest.Builder.setFlags()
اکنون به شما اجازه می دهد تا به جای یک پرچم، چندین پرچم را ازIntent
تنظیم کنید. ( Iac04c )
رفع اشکال
- بازگشتی برای
PickVisualMedia
برای زمانی که Framework Photo Picker در دسترس نیست، اکنون به درستی مدیریت را به برنامه های نصب شده در تصویر سیستم دستگاه محدود می کند. ( If8ae6 )
تبدیل کاتلین
-
ActivityResultRegistryOwner
اکنون در Kotlin نوشته شده است. این یک تغییر منبع ناسازگار برای کلاسهایی است که در Kotlin نوشته شدهاند - اکنون باید به جای اجرای تابعgetActivityResultRegistry()
ویژگیactivityResultRegistry
را لغو کنید. ( 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 حاوی این commit ها است.
ویژگی های جدید
- قراردادهای
PickVisualMedia
وPickMultipleVisualMedia
Activity Result اکنون در مواردی که سیستم Android Photo Picker (به عنوان مثالMediaStore.ACTION_PICK_IMAGES
) در دسترس نباشد، از Photo Picker ارائه شده از خدمات Google Play استفاده خواهد کرد. APIisPhotoPickerAvailable()
که فقط سیستم Android را تشخیص میدهد به شرطی که Photo Picker منسوخ شده باشد. توصیه میشود از API جدیدisPhotoPickerAvailable(Context)
استفاده کنید، که اگر یکی از Photo Picker در دسترس باشد، باز خواهد گشت. ( 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 حاوی این commit ها است.
ویژگی های جدید
-
ComponentDialog
اکنونSavedStateRegistryOwner
را پیاده سازی می کند و بهSavedStateRegistry
خود دسترسی دارد وSavedStateRegistryOwner
برای ViewTree خود تنظیم می کند. اکنون میتوان از Jetpack Compose در یکComponentDialog
استفاده کرد، زیرا همLifecycleOwner
و همSavedStateRegistryOwner
را که از طریق الزامات APIهای ViewTree به پنجره متصل شدهاند، برآورده میکند. ( Idca17 , I73468 b/261162296 )
تغییرات API
- یک
ReportDrawn
قابل ترکیب اضافه شد که بلافاصله فعالیت را به عنوان آماده برای فراخوانیreportFullyDrawn
علامت گذاری می کند. ( Ic5b14 , b/259687964 )
تبدیل کاتلین
- کلاس های
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 حاوی این commit ها است.
رفع اشکال
- از 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 حاوی این commit ها است.
API های FullyDrawnReporter
ComponentActivity
اکنون یک نمونه FullyDrawnReporter
را ارائه می دهد که به چندین مؤلفه اجازه می دهد زمانی که برای تعامل آماده هستند گزارش دهند. ComponentActivity
قبل از فراخوانی reportFullyDrawn()
از طرف شما منتظر می ماند تا تمام کامپوننت ها تکمیل شوند. این APIها از الزامات زمانبندی برای شما مراقبت میکنند و نیازی به فراخوانی به عنوان بخشی از تماس onDraw
ندارند.
این APIها تشویق می شوند تا فعال شوند:
- زمانی که راهاندازی کامل میشود، زمان اجرای Android را علامتگذاری کنید تا مطمئن شوید که تمام کد اجرا شده در طول یک دنباله راهاندازی چند فریمی گنجانده شده است و برای جمعآوری پسزمینه اولویتبندی میشود.
- هنگامی که برنامه شما باید به طور کامل برای معیارهای راه اندازی در نظر گرفته شود، سیگنال Macrobenchmark و Play Vitals را نشان می دهد، بنابراین می توانید عملکرد را ردیابی کنید.
دو API Activity Compose اضافه شدهاند تا استفاده از FullyDrawnReporter
از اجزای سازنده منفرد راحتتر باشد:
-
ReportDrawnWhen
یک گزاره می گیرد (یعنیlist.count > 0
) تا نشان دهد که سازنده شما چه زمانی برای تعامل آماده است. -
ReportDrawnAfter
یک روش تعلیق را انتخاب می کند که وقتی کامل شد، نشان می دهد که شما برای تعامل آماده هستید.
نسخه 1.6.1
نسخه 1.6.1
24 اکتبر 2022
androidx.activity:activity:1.6.1
، androidx.activity:activity-compose:1.6.1
و androidx.activity:activity-ktx:1.6.1
منتشر شدند. نسخه 1.6.1 حاوی این commit ها است.
رفع اشکال
- مشکل راهاندازی نشدن قرارداد
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 حاوی این commit ها است.
تغییرات مهم از 1.5.0
-
ActivityResultContracts.PickVisualMedia
وActivityResultContracts.PickMultipleVisualMedia
برای ارائه یک قرارداد سازگار با گذشته که ازMediaStore.ACTION_PICK_IMAGES
استفاده می کند.ACTION_PICK_IMAGES زمانی که Photo Picker در دسترس است و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 حاوی این commit ها است.
رفع اشکال
-
OnBackPressedDispatcher
اکنونOnBackInvokedCallback
به جایPRIORITY_OVERLAY
باPRIORITY_DEFAULT
ثبت می کند. ( I3901f ) - کلاسهایی که
ComponentActivity
گسترش میدهند، اکنون همیشه هر دو تماسonMultiWindowModeChanged()
آنها ارسال میشود. ( IC4d85 ) -
ActivityResultRegistry
دیگر نتیجهای را بهActivityResultCallback
برنمیگرداند وقتی فراخوانlaunch
هر گونهException
ایجاد میکند و پاسخ تماس بدونLifecycleOwner
ثبت میشود. ( Ia7ff7 , b/238350794 ) -
ComponentActivity
اکنون بدون نیاز به فراخوانی عملکرد فوق العاده در فعالیت شما، تماس های منو را به درستی ارسال می کند. ( Ie33c5 , b/238057118 )
به روز رسانی وابستگی
- اکنون کتابخانه
Activity
به Lifecycle2.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 حاوی این commit ها است.
رفع اشکال
- راهاندازی یک
OnBackPressedDispatcher
دیگر باعثClassVerificationError
در هنگام استفاده از نسخههای SDK قبل از ۳۳ نمیشود. ( Ic32e1 ) - کلاس هایی که فراخوانی
onPictureInPictureModeChanged()
ComponentActivity
را لغو می کنند، اکنون همیشه تماس هایشان ارسال می شود. ( Ib7fdb )
نسخه 1.6.0-beta01
10 آگوست 2022
androidx.activity:activity:1.6.0-beta01
، androidx.activity:activity-compose:1.6.0-beta01
و androidx.activity:activity-ktx:1.6.0-beta01
منتشر شدند. نسخه 1.6.0-beta01 حاوی این تعهدات است.
تغییرات 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()
بدون نیاز به فراخوانی تابع super ارسال می کند. ( 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
که در آن تلاش برای ایجاد یک درخواست، از طریق Builder یا تابع سطح بالای 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
استفاده می کند.ACTION_PICK_IMAGES زمانی که Photo Picker در دسترس است وIntent.ACTION_OPEN_DOCUMENT
زمانی که در دسترس نیست اضافه شد. -
OnBackInvokedCallback
در Android 13 Dev Beta 1 درOnBackPressedDispatcher
ارائه شده توسطComponentActivity
ادغام کرد. این تضمین میکند که همه APIهای ساخته شده بر رویOnBackPressedDispatcher
هنگام فعال کردن یک حرکت پیشبینی کننده برگشت کار میکنند.
نسخه 1.6.0-alpha01
23 مارس 2022
androidx.activity:activity:1.6.0-alpha01
، androidx.activity:activity-compose:1.6.0-alpha01
و androidx.activity:activity-ktx:1.6.0-alpha01
منتشر شدند.
- توجه: این نسخه فقط در برابر SDK پیشنمایش برنامهنویس اندروید 13 کامپایل میشود.
ویژگی های جدید
- تغییرات یکپارچه شده در 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 حاوی این commit ها است.
رفع اشکال
ActivityResultRegistry
دیگر نتیجهای را بهActivityResultCallback
برنمیگرداند، زمانی که فراخوانیlaunch()
هرException
را ایجاد میکند و تماس برگشتی بدونLifecycleOwner
ثبت میشود. ( Ia7ff7 , b/238350794 )ComponentActivity
اکنون به درستی فراخوانی های منو را بهonPrepareOptionMenu()
،onCreateOptionsMenu()
وonOptionsItemSelected()
بدون نیاز به فراخوانی تابع super ارسال می کند. ( Ie33c5 , b/238057118 )
به روز رسانی وابستگی
- اکنون کتابخانه
Activity
به Lifecycle2.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 حاوی این commit ها است.
تغییرات مهم از 1.4.0
- ComponentDialog -
ComponentDialog
یک زیر کلاس ازDialog
است که شامل یکOnBackPressedDispatcher
است که با فشار دادن دکمه بازگشت سیستم و نمایان شدن کادر گفتگو فراخوانی می شود. نکته مهم این است که این زیر کلاس همچنینViewTreeOnBackPressedDispatcherOwner
را تنظیم می کند ، و به نمایش می دهد یک روش عمومی برای بازیابی توزیع کننده صحیح اعم از موجود در یکComponentActivity
یا یکComponentDialog
. - رابط های پاسخ به تماس -
ComponentActivity
اکنون مجموعه ای از رابط های پاسخ به تماس ماژولار را پیاده سازی می کند که می توانند به جای تماس باActivity
استفاده شوند. این رابط ها شامل موارد زیر هستند:OnNewIntentProvider
،OnConfigurationChangedProvider
،OnTrimMemoryProvider
،OnPictureInPictureModeChangedProvider
،OnMultiWindowModeChangedProvider
- ادغام CreationExtras -
ComponentActivity
اکنون این توانایی را دارد که یکViewModelProvider.Factory
را ارائه دهد. از طریقCreationExtras
از طریق چرخه عمر2.5.0
.
تغییرات دیگر
- سازنده NO Parameter for
ActivityResultContracts.CreateDocument
با یک سازنده جدید که یک نوع میمون بتونی (به عنوان مثال ، "تصویر/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 حاوی این commit ها است.
نسخه 1.5.0-beta01
20 آوریل 2022
androidx.activity:activity:1.5.0-beta01
، androidx.activity:activity-compose:1.5.0-beta01
، و androidx.activity:activity-ktx:1.5.0-beta01
منتشر می شود. نسخه 1.5.0-beta01 حاوی این تعهدات است.
به روزرسانی های وابستگی
- فعالیت اکنون به چرخه عمر
2.4.0-beta01
بستگی دارد.
نسخه 1.5.0-alpha05
6 آوریل 2022
androidx.activity:activity:1.5.0-alpha05
، androidx.activity:activity-compose:1.5.0-alpha05
، و androidx.activity:activity-ktx:1.5.0-alpha05
منتشر می شود. نسخه 1.5.0-alpha05 شامل این تعهدات است.
رفع اشکال
-
onPanelClosed()
ComponentActivity
() اکنون نیز فوق العاده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 حاوی این commit ها است.
رفع اشکال
-
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 حاوی این commit ها است.
تغییرات 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 حاوی این commit ها است.
ویژگی های جدید
-
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 حاوی این commit ها است.
ویژگی های جدید
-
ComponentActivity
اکنون با ViewModel CreationExtras ادغام شده است ، به عنوان بخشی از چرخه عمر2.5.0-alpha01
معرفی شده است. ( IE7E00 ، b/207012584 ) - اضافه شده
ComponentDialog
، یک زیر کلاس ازDialog
که شامل یکOnBackPressedDispatcher
شده است ، که هنگام فشار دادن دکمه پشت سیستم در هنگام گفتگو ، تحت فشار قرار می گیرد ، فراخوانی می شود. نکته مهم این است که این زیر کلاس همچنینViewTreeOnBackPressedDispatcherOwner
را تنظیم می کند ، و به نمایش می دهد یک روش عمومی برای بازیابی توزیع کننده صحیح اعم از موجود در یکComponentActivity
یا یکComponentDialog
. ( i8a1bc ) -
ComponentActivity
اکنون رابط جدیدOnNewIntentProvider
را پیاده سازی می کند تا هر مؤلفه ای بتواند این رویدادها را دریافت کند. ( if1f8b ) -
ComponentActivity
اکنون رابط جدیدOnConfigurationChangedProvider
را پیاده سازی می کند تا هر مؤلفه ای بتواند این رویدادها را دریافت کند. ( if623b ) -
ComponentActivity
اکنون رابط جدیدOnTrimMemoryProvider
را پیاده سازی می کند تا هر مؤلفه ای بتواند این رویدادها را دریافت کند. ( IA9295 )
تغییرات API
- سازنده NO Parameter for
ActivityResultContracts.CreateDocument
با یک سازنده جدید که یک نوع میمون بتونی (به عنوان مثال ،"image/png"
) را می گیردIntent.ACTION_CREATE_DOCUMENT
مستهلک شده و جایگزین شده است. ( i2bec6 ) -
OnBackPressedDispatcherOwner
مرتبط با یک نمای اکنون می تواند از طریقViewTreeOnBackPressedDispatcherOwner
بازیابی شود ، نه اینکه به بازیگرانContext
اعتماد کنید. ( i74685 )
رفع اشکال
- برای اولین بار از طریق تماس
registerForActivityResult()
یا تماس برگشتی به یکLifecycleObserver
که به عنوان بخشی ازinit
از یکComponentActivity
اضافه شده است ، تصادف هنگام دسترسی به یکViewModel
را برطرف کرد. ( 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 حاوی این commit ها است.
تغییرات مهم از 1.3.0
- Androidx
ComponentActivity
اکنون رابطMenuHost
پیاده سازی می کند. این امر به هر مؤلفه ای اجازه می دهد تا با افزودن یک نمونهMenuProvider
به فعالیت ، موارد منو را بهActionBar
اضافه کند. هرMenuProvider
می تواند به صورت اختیاری با یکLifecycle
اضافه شود که به طور خودکار دید آن موارد منو را بر اساس حالتLifecycle
کنترل می کند و هنگام از بین رفتنLifecycle
، حذفMenuProvider
را کنترل می کند. - کلاس
ActivityResultContract
در کوتلین بازنویسی شده است تا اطمینان حاصل شود که توسعه دهندگان در حال نوشتن قراردادهای سفارشی در کوتلین می توانند باطل صحیح را برای کلاسهای ورودی و خروجی خود تعریف کنند. - کلاس
ActivityResultContracts
و قراردادهای آن در کوتلین بازنویسی شده است تا از قابلیت تهی مناسب اطمینان حاصل شود.
نسخه 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 حاوی این commit ها است.
رفع اشکال
- هنگامی که تماس
launch
هرException
انجام می دهد ، دیگرActivityResultRegistry
دیگر نتیجه ای را بهActivityResultCallback
باز نمی گرداند. ( 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>
. ( if71de ) - ثابت های عمومی در
ActivityResultContracts.StartActivityForResult
،ActivityResultContracts.StartIntentSenderForResult
، وActivityResultContracts.RequestMultiplePermissions
اکنون هنگام استفاده از Kotlin از طریق اشیاءCompanion
خود در حال حاضر قابل دسترسی هستند. ( AOSP/1832555 )
به روزرسانی مستندات
- پیام استهلاک برای API که اکنون توسط API های نتیجه فعالیت ، یعنی
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 شامل این تعهدات است.
ویژگی های جدید
- Artifact
activity-compose
در حال حاضر حاوی یک خطای راه اندازیLaunchDuringComposition
است که مانع از فراخوانی روشlaunch
ActivityResultLauncher
به عنوان بخشی از ترکیب می شود به عنوان ترکیب باید عاری از اثر جانبی باشد. برای رسیدگی به عوارض جانبی از API استفاده کنید. ( 7c2bbe ، b/191347220 )
تغییرات API
- کلاس
ActivityResultContract
در کوتلین بازنویسی شده است تا اطمینان حاصل شود که توسعه دهندگان در حال نوشتن قراردادهای سفارشی در کوتلین می توانند باطل صحیح را برای کلاسهای ورودی و خروجی خود تعریف کنند. ( i8a8f5 ) - کلاس
ActivityResultContracts
و قراردادهای آن در کوتلین بازنویسی شده است تا از قابلیت تهی مناسب اطمینان حاصل شود. ( 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
پیاده سازی می کند. این به هر مؤلفه ای اجازه می دهد تا با افزودن یک نمونهMenuProvider
به فعالیت ، موارد منو را بهActionBar
اضافه کند. هرMenuProvider
می تواند به صورت اختیاری با یکLifecycle
اضافه شود که به طور خودکار دید آن موارد منو را بر اساس حالتLifecycle
کنترل می کند و هنگام از بین رفتنLifecycle
، حذفMenuProvider
را کنترل می کند. ( 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
اکنون هنگام تلاش برایlaunch()
در یکActivityResultLauncher
که ثبت نشده است یا ثبت نام نکرده است ،IllegalStateException
است. ( ida75d ، b/192567522 )
سهم خارجی
- با تشکر از dmitrilc برای رفع یک تایپی در مستندات
ActivityResult
. ( شماره 221 )
نسخه 1.3.1
نسخه 1.3.1
4 آگوست 2021
androidx.activity:activity:1.3.1
، androidx.activity:activity-compose:1.3.1
، و androidx.activity:activity-ktx:1.3.1
منتشر می شود. نسخه 1.3.1 شامل این تعهدات است.
به روزرسانی های وابستگی
- فعالیت اکنون به Kotlin
1.5.21
بستگی دارد. - آهنگسازی فعالیت اکنون به آهنگسازی
1.0.1
بستگی دارد.
نسخه 1.3.0
نسخه 1.3.0
28 ژوئیه 2021
androidx.activity:activity:1.3.0
، androidx.activity:activity-compose:1.3.0
و androidx.activity:activity-ktx:1.3.0
منتشر می شود. نسخه 1.3.0 شامل این تعهدات است.
تغییرات مهم از 1.2.0
- Active Compose Artifact - Artifact
activity-compose
روش پسوندsetContent
برای میزبانی UI Jetpack شما در یک فعالیت فراهم می کند و بسته بندی های خاصی را برای تعامل با API هایComponentActivity
برای دستیابی به دکمه پشت سیستم و API های نتیجه فعالیت ایجاد می کند. برای جزئیات بیشتر به مستندات مراجعه کنید. - CATTREVIDEO CONTRAPT -
CaptureVideo
ActivityResultContract
جایگزین قراردادTakeVideo
در حال حاضر مستهلک شده است و یک موفقیت بولی را که در بسیاری از برنامه های دوربین کار می کند ، برمی گرداند. - ردیابی تصویر در تصویر در تصویر -کاربران
activity-ktx
هم اکنون می توانند از روش توسعهtrackPipAnimationHintView
درActivity
استفاده کنند تا به طور خودکارPictureInPictureParams
را با موقعیت جدید نمای بازسازی کنند زیرا موقعیت نسبت به پنجره را تغییر می دهد.
نسخه 1.3.0-RC02
14 جولای 2021
androidx.activity:activity:1.3.0-rc02
، androidx.activity:activity-compose:1.3.0-rc02
، و androidx.activity:activity-ktx:1.3.0-rc02
منتشر می شود. نسخه 1.3.0-RC02 شامل این تعهدات است.
رفع اشکال
- اکنون تماس های
ActivityResultRegistry
به درستی ذخیره شده و بازیابی می شوند ، بنابراین تماس های تماس تلفنی در SavedState کپی نمی شوند. ( i97816 ، b/191893160 )
نسخه 1.3.0-RC01
1 ژوئیه 2021
androidx.activity:activity:1.3.0-rc01
، androidx.activity:activity-compose:1.3.0-rc01
، و androidx.activity:activity-ktx:1.3.0-rc01
بدون تغییر از 1.3.0-beta02
. نسخه 1.3.0-RC01 شامل این تعهدات است.
نسخه 1.3.0-beta02
16 ژوئن 2021
androidx.activity:activity:1.3.0-beta02
، androidx.activity:activity-compose:1.3.0-beta02
، و androidx.activity:activity-ktx:1.3.0-beta02
منتشر می شود. نسخه 1.3.0-beta02 شامل این تعهدات است.
activity-compose
به آهنگسازی 1.0.0-beta09
بستگی دارد. androidx.compose.ui:ui-test-junit4
اکنون وابستگی زمانی کامپایل به activity-compose
دارد.
نسخه 1.3.0-beta01
2 ژوئن 2021
androidx.activity:activity:1.3.0-beta01
، androidx.activity:activity-compose:1.3.0-beta01
، و androidx.activity:activity-ktx:1.3.0-beta01
منتشر می شود. نسخه 1.3.0-beta01 شامل این تعهدات است.
تغییرات API
- روش قبلاً کاهش یافته
@Composable registerForActivityResult()
حذف شده است. لطفاً ازrememberLauncherForActivityResult()
استفاده کنید. ( IC39D3 )
نسخه 1.3.0-alpha08
18 مه 2021
androidx.activity:activity:1.3.0-alpha08
، androidx.activity:activity-compose:1.3.0-alpha08
، و androidx.activity:activity-ktx:1.3.0-alpha08
منتشر می شود. نسخه 1.3.0-alpha08 شامل این تعهدات است.
ویژگی های جدید
- فعالیت جدید
CaptureVideo
ActivityResultContract
یک Boolean را بهActivityResultCallback
شما باز می گرداند که نشان می دهد آیا فیلم شما با موفقیت در URI داده شده ذخیره شده است. این جایگزین قراردادTakeVideo
در حال حاضر مستهلک شده است زیرا برنامه های دوربین به ندرت از بازگشت یک مپ کوچک تصویر کوچک پشتیبانی می کنند و نتیجه را بی فایده می کنند. ( IE21F2 ، B/185938070 ) -
Activity#setPipAnimationHintView
برای به روزرسانی اشاره رکورد منبع پیپرامز هر زمان که این نمایش حرکت می کند. ( i9063d )
تغییرات API
- تابع
rememberLauncherForActivityResult
مانده از عملکردی که عملکردunregister()
را کاهش می دهد - ثبت نام و ثبت نام از پرتاب به طور خودکار توسطrememberLauncherForActivityResult
می شود. ( i2443e )
سازگاری را تشکیل می دهد
-
androidx.activity:activity-compose:1.3.0-alpha08
فقط با نسخه آهنگسازی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 ) - استفاده از نسخه های ناپایدار قطعات بالاتر از
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
- API
registerForActivityResult()
بهrememberLauncherForActivityResult()
شده است که به یاد داشته باشید کهActivityResultLauncher
برگشتی یک شیء مدیریت شده است که از طرف شما به یاد می آید. تلاش برایunregister
نام ازActivityResultLauncher
برگشتی ، اکنون خطایی خواهد داشت. ( i2bb6d ) -
LocalOnBackPressedDispatcherOwner.current
andLocalActivityResultRegistryOwner.current
now return a nullable value to better determine whether it is available in the current composition. API هایی که به آن API نیاز دارند ، مانندBackHandler
وrememberLauncherForActivityResult()
به ترتیب ، در صورت عدم یافتن مالک زیرین ، اکنون خطای توصیفی تری دارند.NavHost
اکنون حتی در صورت یافتن یکOnBackPressedDispatcherOwner
کار می کند ، چنین مواردی در هنگام پیش نمایشNavHost
وجود دارد. ( i7d8b4 )
رفع اشکال
- در صورت
STOPPED
فعالیت ، اینBackHandler
به درستی مطبوعات را به درستی رهگیری می کند ، سپس دوبارهSTARTED
و سایر تماس های تماس با یک چرخه حیات اضافه شد. ( i71de6 ، b/182284739 ) - با استفاده از پسوند روش
launch()
با یک فعالیت سفارشیActivityResultContract
که دارایUnit
است ، دیگر باعث ایجادNullPointerException
نمی شود ( I76282 ، B/183837954 )
نسخه 1.3.0-alpha05
24 مارس 2021
androidx.activity:activity:1.3.0-alpha05
، androidx.activity:activity-compose:1.3.0-alpha05
و androidx.activity:activity-ktx:1.3.0-alpha05
منتشر می شود. نسخه 1.3.0-alpha05 شامل این تعهدات است.
رفع اشکال
- از فعالیت 1.2.2 : یک مسئله را در بررسی
InvalidFragmentVersionForActivityResult
fragmentionforactivityresult بررسی کرد که هنگام استفاده از قطعه 1.3.1 یا بالاتر منجر به مثبت کاذب شد. ( I54DA1 ، B/182388985 ) - از فعالیت 1.2.2 :
ComponentActivity
اکنون هنگام راه اندازی یکIntent
از یکActivityResultContract
، که قبلاً به عنوان اضافی درIntent
دیگری برگزار می شد ، از یکClassNotFoundException
جلوگیری می کند. ( 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 شامل این تعهدات است.
رفع اشکال
- از فعالیت
1.2.1
:RequestMultiplePermissions
اکنون به جای فقط مجوزهایی که قبلاً اعطا نشده بود ، نتایج همه مجوزهای درخواستی را برمی گرداند. ( I50BC3 ، b/180884668 ) - از فعالیت
1.2.1
:ActivityResultRegistry
اکنون تضمین می کند که در حال انجام درخواستlaunch()
درخواست ها حتی اگرunregister()
نتایج خود را برمی گردانند ، سپس دوبارهregister()
. ( i9ef34 ، b/181267562 ) - آهنگسازی دیگر وابستگی های آزمون را به ClassPath زمان اجرا اضافه نمی کند. ( IFD8B3 )
- مسئله ای را با
BackHandler
برطرف کرد که در آنonBack
که قبلاً تنظیم شده بود ، پس از بازپرداخت هنوز مورد استفاده قرار می گرفت. ( 8EB5EB )
نسخه 1.3.0-alpha03
24 فوریه 2021
androidx.activity:activity:1.3.0-alpha03
، androidx.activity:activity-compose:1.3.0-alpha03
و androidx.activity:activity-ktx:1.3.0-alpha03
منتشر می شود. نسخه 1.3.0-alpha03 شامل این تعهدات است.
ویژگی های جدید
- در حال حاضر یک تابع
registerForActivityResult
برای بدست آوردن نتیجه از فعالیت های موجود در ترکیبات وجود دارد. ( IA7851 ، B/172690553 )
تغییرات API
-
LocalOnBackPressedDispatcherOwner
اکنون عملکردی راprovides
می دهد که می تواند باCompositionLocalProvider
مورد استفاده قرار گیرد و APIasProvidableCompositionLocal()
را جایگزین کند. ( i45d24 )
نسخه 1.3.0-alpha02
10 فوریه 2021
androidx.activity:activity:1.3.0-alpha02
، androidx.activity:activity-compose:1.3.0-alpha02
، و androidx.activity:activity-ktx:1.3.0-alpha02
منتشر می شود. نسخه 1.3.0-alpha02 شامل این تعهدات است.
رفع اشکال
- رفع یک مسئله در فعالیت آهنگسازی
1.3.0-alpha01
که باعث ایجاد یکNoSuchMethodError: No static method setContent
در هنگام استفاده از آهنگسازی1.0.0-alpha12
وجود ندارد. همه کاربران آهنگسازی باید به1.3.0-alpha02
و بالاتر بستگی داشته باشند. ( b/179911234 )
تغییرات API
- از API
BackHandler
می توان استفاده کرد تا یک ترکیب بتواند از دکمه عقب سیستم رهگیری کند. ( i58ed5 ، b/172154006 )
نسخه 1.3.0-alpha01
10 فوریه 2021
androidx.activity:activity:1.3.0-alpha01
، androidx.activity:activity-compose:1.3.0-alpha01
، و androidx.activity:activity-ktx:1.3.0-alpha01
منتشر می شود. نسخه 1.3.0-alpha01 شامل این تعهدات است.
ویژگی های جدید
- Artifact جدید
activity-compose
، Jetpack را برای API های خاصandroidx.activity
آهنگسازی می کند.-
ComponentActivity.setContent
ازandroidx.compose.ui.platform.setContent
بهandroidx.activity.compose.setContent
منتقل شده است. ( ICF416 )
-
مسائل شناخته شده
- با استفاده از فعالیت آهنگسازی
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 شامل این تعهدات است.
رفع اشکال
- از فعالیت
1.3.0-rc02
: اکنون تماس های CompensionResultregistry به درستی ذخیره شده و بازیابی می شوند ، بنابراین تماس های برگشتی در SaveDstate کپی نمی شوند. ( i97816 ، b/191893160 )
نسخه 1.2.3
نسخه 1.2.3
5 مه 2021
androidx.activity:activity:1.2.3
و androidx.activity:activity-ktx:1.2.3
منتشر می شود. نسخه 1.2.3 شامل این تعهدات است.
رفع اشکال
- با استفاده از پسوند روش
launch()
با یک فعالیت سفارشیActivityResultContract
که دارایUnit
است ، دیگر باعث ایجادNullPointerException
نمی شود ( I76282 ، B/183837954 ) - رفع خطای خط مثبت کاذب به شما گفت که هنگام استفاده از عکس فوری ، آلفا ، بتا یا RC از نسخه جدیدتر از قطعات ، از قطعه
1.3.0
استفاده کنید. ( 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
fragmentionforactivityresult بررسی که منجر به مثبت کاذب هنگام استفاده از قطعه 1.3.1 یا بالاتر شد. ( I54DA1 ، B/182388985 ) -
ComponentActivity
اکنون هنگام راه اندازی یکIntent
از یکActivityResultContract
، که قبلاً به عنوان یک اضافی درIntent
دیگری برگزار می شد ، از یکClassNotFoundException
جلوگیری می کند. ( 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
- APIS نتیجه فعالیت :
ComponentActivity
اکنون یکActivityResultRegistry
فراهم می کند که به شما امکان می دهدstartActivityForResult()
+onActivityResult()
و همچنینrequestPermissions()
+onRequestPermissionsResult()
جریان را بدون روش های مهم در فعالیت یا قطعه خود ، افزایش ایمنی نوع را از طریقActivityResultContract
ایجاد می کند و Hooks را فراهم می کند. برای آزمایش این جریان ها. مشاهده به روز شده نتیجه یک فعالیت را مشاهده کنید.
ContextAware
:ComponentActivity
اکنونContextAware
را پیاده سازی می کند و به شما امکان می دهد یک یا چند موردOnContextAvailableListener
را اضافه کنید که قبل ازActivity.onCreate()
پایه ، یک پاسخ به تماس دریافت می کنند.- یک پسوند Kotlin
withContextAvailable()
به شما امکان می دهد تا در صورت در دسترس بودن زمینه ، یک بلوک غیر تعلیق را اجرا کنید و نتیجه را برگردانید. - این API توسط
FragmentActivity
در قطعه 1.3.0 برای بازگرداندن وضعیتFragmentManager
استفاده می شود. هر شنونده اضافه شده به زیر کلاسهایFragmentActivity
بعد از آن شنونده اجرا می شود. - این API توسط
AppCompatActivity
در AppCompat 1.3.0-alpha02 یا بالاتر استفاده می شود. هر شنونده اضافه شده به زیر کلاسهایAppCompatActivity
پس از آن شنونده اجرا می شود.
- یک پسوند Kotlin
ViewTree
Support :ComponentActivity
اکنون ازViewTreeLifecycleOwner.get(View)
،ViewTreeViewModelStoreOwner.get(View)
، وViewTreeSavedStateRegistryOwner
API اضافه شده در Lifecycle2.3.0
و SavedState1.1.0
به گونه ای که فعالیت خود را به عنوانLifecycleOwner
،ViewModelStoreOwner
SavedStateRegistryOwner
بازگرداند. برای هر دیدگاهی که مستقیماً بهComponentActivity
اضافه می شود.
- گزارش دهی DREAPERALL () backport - روش
Activity
reportFullyDrawn()
درComponentActivity
برای کار در تمام سطوح API ، رفع یک تصادف در API 19 و اضافه کردن ردیابی برای این روش برای همه سطح API انجام شده است.
نسخه 1.2.0-RC01
16 دسامبر 2020
androidx.activity:activity:1.2.0-rc01
و androidx.activity:activity-ktx:1.2.0-rc01
منتشر می شود. نسخه 1.2.0-RC01 شامل این تعهدات است.
رفع اشکال
- اکنون
ActivityResultRegistry
همواره وضعیت دقیقی را که نجات یافته است بازیابی می کند. ( IDD56B ) - افزودن ردیابی به
ComponentActivity.reportFullyDrawn
( IC7632 )
سهم خارجی
-
ComponentActivity
اکنونreportFullyDrawn()
را نادیده می گیرد ، و این امکان را می دهد تا در تمام سطوح API فراخوانی شود و هنگام فراخوانی این روش بدون اجازه سیستم مناسب در دستگاه های API 19 ، تصادف را برطرف کند. با تشکر از سیمون شیلر! ( 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 شامل این تعهدات است.
رفع اشکال
- مسئله ای را برطرف کرد که در آن نتیجه فعالیت API منتظر
STARTED
چرخه عمر قبل از ارائه نتایج در هنگام ثبت نام درLifecycle
باشد. ( i109ea )
سهم خارجی
- اسناد را برای
launch()
به روز کرد تا صریحاً با این مسئله تماس بگیرد که می تواند یکActivityNotFoundException
را پرتاب کند. با تشکر از Michał Zieliński! ( AOSP/1493580 )
نسخه 1.2.0-beta01
1 اکتبر 2020
androidx.activity:activity:1.2.0-beta01
و androidx.activity:activity-ktx:1.2.0-beta01
منتشر می شود. نسخه 1.2.0-beta01 شامل این تعهدات است.
رفع اشکال
ActivityResultRegistry
اکنون به طور تصادفی عدد صحیح را تولید می کند تا زمانی که چیزی را پیدا کند که از آن به عنوانregister()
، بنابراین مانع از سرریز عدد صحیح احتمالی ناشی از افزایش کدهای درخواست می شود. ( b/168779518 )ناظران
Lifecycle
هنگام فراخوانیunregister()
در یکActivityResultLauncher
به درستی حذف می شوند. ( b/165608393 )
رفتار تغییر می کند
-
ActivityResultRegistry
اکنون هنگام تلاش برای تماسregister()
با یکLifecycleOwner
کهLifecycle
که قبلاً از قبل رسیده استSTARTED
بهIllegalStateException
می کند. ( b/165435866 )
مستندات به روز شده
- پیوندهای مستندات
ContextAware
برای برجسته کردن تماس هایLifecycle
به عنوان مکان مناسب برای ایجاد و تخریب ، پیوندهای مستندات ContextAware بهLifecycleOwner
( 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
در قطعه 1.3.0-alpha08 برای بازگرداندن وضعیتFragmentManager
استفاده می شود. هر شنونده اضافه شده به زیر کلاسهایFragmentActivity
بعد از آن شنونده اجرا می شود. ( i513da ) - این API توسط
AppCompatActivity
در AppCompat 1.3.0-alpha02 استفاده می شود. هر شنونده اضافه شده به زیر کلاسهایAppCompatActivity
پس از آن شنونده اجرا می شود. ( i513da )
- یک پسوند Kotlin
رفع اشکال
- مسئله را با بررسی LINT
ActivityResultFragmentVersionDetector
بررسی کرد که باعث شکسته شدن آن هنگام استفاده از LINT 27.1.0 یا بالاتر شد. ( b/162155191 )
نسخه 1.2.0-alpha07
22 جولای 2020
androidx.activity:activity:1.2.0-alpha07
و androidx.activity:activity-ktx:1.2.0-alpha07
منتشر می شود. نسخه 1.2.0-alpha07 شامل این تعهدات است.
ویژگی های جدید
- اضافه کردن یک نام
InvalidFragmentVersionForActivityResult
، بررسی می کند که تأیید می کند که شما هنگام استفاده از API نتیجه فعالیت از قطعه1.3.0-alpha07
استفاده می کنید ، از تصادفات زمان اجرا به دلیل "کد درخواست نامعتبر" و درخواست های مجوز غیر عملکردی ناشی از استفاده از نسخه های قدیمی تر قطعات جلوگیری می کنید. ( b/152554847 )
سهم خارجی
- هنگام تجزیه نتایج حاصل از قرارداد نتیجه فعالیت
RequestPermission
، یکArrayIndexOutOfBoundsException
را برطرف کرد. ( i8f9e3 ، b/161057605 )
نسخه 1.2.0-alpha06
10 ژوئن 2020
androidx.activity:activity:1.2.0-alpha06
و androidx.activity:activity-ktx:1.2.0-alpha06
منتشر می شود. نسخه 1.2.0-alpha06 شامل این تعهدات است.
ویژگی های جدید
- اکنون می توانید کلاس
ActivityResult
را در کوتلین تخریب کنید تا مستقیماً بهrequestCode
وintent
دسترسی پیدا کنید. ( b/157212935 ) -
ActivityResultLauncher
اکنون به شما امکان می دهدActivityResultContract
را که برای ثبت نام پرتاب استفاده شده است ، دریافت کنید. ( b/156875743 )
تغییرات API
- Breaking Change : روش
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
از چرخه عمر2.3.0-alpha03
، وViewTreeSavedStateRegistryOwner
از SaveDstate1.1.0-alpha01
هنگام استفاده از یکView
در یکComponentActivity
. ( AOSP/1297993 ، AOSP/1300264 )
تغییرات API
- قرارداد
TakePicture
در حال حاضر یکboolean
را نشان می دهد که نشان دهنده موفقیت است نه یکBitmap
تصویر کوچک ، زیرا این کار به ندرت توسط برنامه های دوربین هنگام نوشتن تصویر بهUri
ارائه شده پشتیبانی می شود. ( b/154302879 ) - پسوندهای
invoke()
درActivityResultLauncher
به نفع صریح استفاده ازlaunch()
حذف شده است تا بهتر نشان دهد که این عملیات ناهمزمان هستند. پسوندهای Kotlin برایlaunch
بهandroidx.activity.result
برایActivityResultLauncher<Void>
وActivityResultLauncher<Unit>
اضافه شده است که به ترتیب ، نیاز به عبور درnull
یاUnit
را حذف می کند ، به ترتیب ، این رفتار را ازinvoke()
قبلی استناد می کند. ( AOSP/1304674 ، AOSP/1304675 ) - روشهای
IntentSenderRequest.Builder
برایsetFlagsMask()
وsetFlagsValues()
در یک روشsetFlags()
واحد ترکیب شده است. ( AOSP/1302111 )
رفع اشکال
- هنگام ثبت نام
ActivityResultCallback
با یکLifecycleOwner
، مسئله ای را برطرف کرد که در آن تماس تلفنی قبل ازSTARTED
دولت ایجاد می شود. ( AOSP/1309744 )
رفتار تغییر می کند
-
ActivityResultRegistry
اکنون کدهای درخواست را از0xFFFF
شروع می کند و نه در0
، از همپوشانی در هنگام استفاده ازstartActivityForResult()
یاrequestPermissions()
در یک فعالیت جلوگیری می کند. ( AOSP/1302324 )
نسخه 1.2.0-alpha04
29 آوریل 2020
androidx.activity:activity:1.2.0-alpha04
و androidx.activity:activity-ktx:1.2.0-alpha04
منتشر می شود. نسخه 1.2.0-alpha04 شامل این تعهدات است.
ویژگی های جدید
- یک قرارداد اضافه کرد که می تواند StartIntentSenderForresult را به API های ActivityResult فراخوانی کند. ( b/153007517 )
تغییرات API
- روش
prepareCall()
بهregisterForActivityResult()
تغییر نام داده شده است ، هم در موردComponentActivity
در اینجا و هم در قطعه1.3.0-alpha04
. ( AOSP/1278717 ) - قراردادهای
GetContents
،OpenDocuments
وRequestPermissions
به ترتیب بهGetMultipleContents
،OpenMultipleDocuments
وRequestMultiplePermissions
تغییر نام داده اند. ( AOSP/1280161 ) -
ComponentActivity
اکنون رابطActivityResultRegisteryOwner
را پیاده سازی می کند. ( AOSP/1290888 ) - - API های
startActivityForResult()
/onActivityResult()
وonRequestPermissionsResult()
درComponentActivity
در آن کاهش یافته است. لطفاً از API های نتیجه فعالیت استفاده کنید. ( b/154751887 )
رفع اشکال
- هنگام استفاده از قراردادهای
GetMultipleContents
وOpenMultipleDocuments
و انتخاب یک مورد واحد ، اکنون به درستی به پاسخ به تماس شما بازگردانده شده است. ( b/152941153 )
نسخه 1.2.0-alpha03
1 آوریل 2020
androidx.activity:activity:1.2.0-alpha03
و androidx.activity:activity-ktx:1.2.0-alpha03
منتشر می شود. نسخه 1.2.0-alpha03 شامل این تعهدات است.
ویژگی های جدید
- افزود:
TakeVideo
،PickContact
،GetContent
،GetContents
،OpenDocument
،OpenDocuments
،OpenDocumentTree
وCreateDocument
قراردادهای ایجاد شده به مجموعه قراردادهای از پیش ساخته ارائه شده توسطActivityResultContracts
. ( AOSP/1262482 ، AOSP/1266916 ، AOSP/1268960 ) - API های نتیجه فعالیت اکنون از راه اندازی یک فعالیت برای نتیجه با یک
ActivityOptionsCompat
اختیاری OPTIONSCOMPAT پشتیبانی می کنند. ( b/151860054 )
تغییرات API
- قرارداد
TakePicture
در حال حاضر ورودیUri
را برای جایی که باید تصویر ذخیره شود ، می گیرد. قرارداد قبلی که هیچ ورودی را نمی گیرد ، بهTakePicturePreview
تغییر نام داده است. ( AOSP/1262482 ) - روش
registerActivityResultCallback()
در موردActivityResultRegistry
بهregister()
تغییر نام داده است. ( AOSP/1267621 ) - روش
dispose()
در موردActivityResultLauncher
بهunregister()
تغییر نام داده شده است وunregisterResultCallback()
درActivityResultRegistry
حذف شده است. ( AOSP/1267621 ) - روش
createIntent()
ActivityResultContact
اکنون علاوه بر ورودی ،Context
نیز در بر می گیرد تا امکان ایجاد اهداف صریح را فراهم کند. ( AOSP/1238800 ) -
ActivityResultContract
اکنون می تواندgetSynchronousResult()
را نادیده بگیرد تا نتیجه ای را بدون فراخوانیstartActivityForResult
ارائه دهد. این مورد توسط قراردادهایRequestPermission
وRequestPermissions
برای ارائه صحیح وضعیت "اعطا شده" در صورت اعطای مجوزهای درخواست شده استفاده می شود. ( b/151110799 ) - قرارداد
Dial
قبلی در دسترس حذف شده است زیرا اینIntent
به معنای استفاده ازstartActivityForResult()
نیست. ( AOSP/1266916 ) - بسیاری از API های نتیجه فعالیت که به معنای گسترش نیستند ، اکنون
final
هستند. این شاملgetActivityResultRegistry()
، روش هایprepareCall()
، تمام روش هایActivityResultRegistry
به جزinvoke()
و تعدادی از قراردادهای پیش فرض که از موارد اضافی اختیاری پشتیبانی نمی کنند. ( b/152439361 )
رفع اشکال
- رفع یک
NullPointerException
درActivityResultRegistry
هنگام تلاش برای ارائه نتایج به پاسخ به تماس که هنوز پس از تغییر پیکربندی دوباره ثبت نشده است.ActivityResultRegistry
اکنون بر روی این نتایج در حال تعلیق قرار دارد و هنگام ثبت نام مجدد تماس ، آنها را تحویل می دهد. ( b/152137004 )
نسخه 1.2.0-alpha02
18 مارس 2020
androidx.activity:activity:1.2.0-alpha02
و androidx.activity:activity-ktx:1.2.0-alpha02
منتشر می شود. نسخه 1.2.0-alpha02 شامل این تعهدات است.
ویژگی های جدید
- ActivityResultRegistry :
ComponentActivity
now provides anActivityResultRegistry
that lets you handle thestartActivityForResult()
+onActivityResult()
as well asrequestPermissions()
+onRequestPermissionsResult()
flows without overriding methods in your Activity or Fragment, brings increased type safety viaActivityResultContract
, and provides hooks for testing these flows. See the updated Getting a Result from an Activity . ( b/125158199 )
Version 1.2.0-alpha01
4 مارس 2020
androidx.activity:activity:1.2.0-alpha01
and androidx.activity:activity-ktx:1.2.0-alpha01
are released. Version 1.2.0-alpha01 contains these commits.
ویژگی های جدید
- Added support for the
ViewTreeLifecycleOwner.get(View)
API added in Lifecycle2.3.0-alpha01
such that it will return the Activity as theLifecycleOwner
for any Views directly added to the Activity. ( aosp/1182955 )
رفع اشکال
- Fixed a regression introduced in Activity
1.1.0
when running on older versions of the platform whereonBackPressed()
would cause anIllegalStateException
due to a bug in theandroid.app.FragmentManager
. ( b/146290338 )
نسخه 1.1.0
نسخه 1.1.0
22 ژانویه 2020
androidx.activity:activity:1.1.0
is released. Version 1.1.0 contains these commits .
Important changes since 1.0.0
- Lifecycle ViewModel SavedState Integration :
SavedStateViewModelFactory
is now the default factory used when usingby viewModels()
, theViewModelProvider
constructor, orViewModelProviders.of()
with aComponentActivity
or its subclasses.
Version 1.1.0-rc03
4 دسامبر 2019
androidx.activity:activity:1.1.0-rc03
and androidx.activity:activity-ktx:1.1.0-rc03
are released. Version 1.1.0-rc03 contains these commits .
تغییر وابستگی
- Activity now depends on Lifecycle
2.2.0-rc03
and Lifecycle ViewModel SavedState1.0.0-rc03
.
Version 1.1.0-rc02
7 نوامبر 2019
androidx.activity:activity:1.1.0-rc02
and androidx.activity:activity-ktx:1.1.0-rc02
are released. Version 1.1.0-rc02 contains these commits .
تغییر وابستگی
- Activity now depends on lifecycle
2.2.0-rc02
.
Version 1.1.0-rc01
23 اکتبر 2019
androidx.activity:activity:1.1.0-rc01
and androidx.activity:activity-ktx:1.1.0-rc01
are released with no changes from 1.1.0-beta01
. Version 1.1.0-rc01 contains these commits .
Version 1.1.0-beta01
9 اکتبر 2019
androidx.activity:activity:1.1.0-beta01
and androidx.activity:activity-ktx:1.1.0-beta01
are released. Version 1.1.0-beta01 contains these commits .
تغییر وابستگی
- Activity now depends on SavedState 1.0.0 stable.
Version 1.1.0-alpha03
5 سپتامبر 2019
androidx.activity:activity:1.1.0-alpha03
and androidx.activity:activity-ktx:1.1.0-alpha03
are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.
ویژگی های جدید
- Activity now depends on Core 1.1.0 stable.
رفع اشکال
- Activity now depends on Lifecycle
2.2.0-alpha04
.
Version 1.1.0-alpha02
August 7, 2019
androidx.activity:activity:1.1.0-alpha02
and androidx.activity:activity-ktx:1.1.0-alpha02
are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.
ویژگی های جدید
-
SavedStateViewModelFactory
is now the default factory used when usingby viewModels()
, theViewModelProvider
constructor, orViewModelProviders.of()
with aComponentActivity
( b/135716331 )
Version 1.1.0-alpha01
2 جولای 2019
androidx.activity:activity:1.1.0-alpha01
and androidx.activity:activity-ktx:1.1.0-alpha01
are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.
ویژگی های جدید
-
activity
now depends on Lifecycle2.2.0-alpha02
. ( aosp/1007817 ) -
activity-ktx
added a dependency onlifecycle-runtime-ktx
; you no longer need to explicitly add it to your dependencies when usingactivity-ktx
or libraries that depend onactivity-ktx
(such asfragment-ktx
). ( aosp/987162 )
Version 1.0.0
Version 1.0.0
5 سپتامبر 2019
androidx.activity:activity:1.0.0
and androidx.activity:activity-ktx:1.0.0
are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.
Major Features of 1.0.0
- ComponentActivity :
ComponentActivity
serves as the new base class forFragmentActivity
in Fragment1.1.0
and, by extension,AppCompatActivity
in AppCompat1.1.0
. - activity-ktx : The
activity-ktx
module includes aby viewModels
Kotlin property extension for accessing ViewModels. This module is automatically included when you includefragment-ktx
from Fragment1.1.0
. - OnBackPressedDispatcher : As a composable alternative to overriding
onBackPressed()
, you can now register aOnBackPressedCallback
from anyLifecycleOwner
(such as a fragment) to intercept system back button events. A lambda with receiver versionaddCallback
has been added toactivity-ktx
. See Provide custom back navigation documentation for more details. - onRetainCustomNonConfigurationInstance deprecation : the
onRetainCustomNonConfigurationInstance()
and the relatedgetLastCustomNonConfigurationInstance()
APIs have been deprecated. It is strongly recommended to use ViewModels to store non-configuration state as they offer a composable solution suitable for anyViewModelStoreOwner
that makes the ownership of the retained objects clear and provides anonCleared()
callback for cleaning up resources when the activity is finally destroyed.
نسخه 1.0.0-RC01
2 جولای 2019
androidx.activity:activity:1.0.0-rc01
and androidx.activity:activity-ktx:1.0.0-rc01
are released with no changes from 1.0.0-beta01
. تعهدات موجود در این نسخه را می توان در اینجا یافت.
نسخه 1.0.0-beta01
5 ژوئن 2019
androidx.activity::activity:1.0.0-beta01
and androidx.activity:activity-ktx:1.0.0-beta01
are released with no changes from 1.0.0-alpha08
. تعهدات موجود در این نسخه را می توان در اینجا یافت.
Version 1.0.0-alpha08
7 مه 2019
androidx.activity:activity:1.0.0-alpha08
and androidx.activity:activity-ktx:1.0.0-alpha08
are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.
API تغییر می کند
- Breaking change: The previously deprecated
addOnBackPressedCallback
andremoveOnBackPressedCallback
methods onComponentActivity
have been removed. aosp/953857 - The
setEnabled()
andisEnabled()
methods ofOnBackPressedCallback
are now final. b/131416833 - The
remove()
method ofOnBackPressedCallback
is now final. aosp/952720 -
OnBackPressedDispatcher
now has public constructors, allowing you to construct your own instances for testing, etc. aosp/953431 -
onBackPressed()
forComponentActivity
is now explicitly marked as@MainThread
aosp/952721
رفع اشکال
- Fixed a
ConcurrentModificationException
when callingremove()
from within thehandleOnBackPressed()
method of aOnBackPressedCalback
that was added with aLifecycleOwner
. b/131765095
نسخه 1.0.0-alpha07
April 25th, 2019
androidx.activity:activity:1.0.0-alpha07
and androidx.activity:activity-ktx:1.0.0-alpha07
are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.
API تغییر می کند
This release makes significant changes to the handling of the onBackPressed()
. See the updated custom back documentation for more details.
- The methods for
OnBackPressedCallback
andOnBackPressedDispatcher
have been marked as@MainThread
. ( aosp/943813 ) - The
handleOnBackPressed()
method no longer returns aboolean
. Instead,OnBackPressedCallback
is now an abstract class that can be enabled or disabled - only when the newisEnabled()
method returns true willhandleOnBackPressed()
be called, in which you must handle the back button. ( aosp/944518 ) - The
addCallback
methods ofOnBackPressedDispatcher
no longer return aCancellable
instance.OnBackPressedCallback
now contain aremove()
method that fulfill this functionality, allowing you to callremove()
duringhandleOnBackPressed()
. ( aosp/944519 ) ( aosp/946316 ) -
activity-ktx
now contains a receiver scoped callback foraddCallback
that accepts a lamdba that implementshandleOnBackPressed()
and has access toisEnabled
andremove()
( aosp/944520 )
Version 1.0.0-alpha06
April 3rd, 2019
androidx.activity:activity:1.0.0-alpha06
and androidx.activity:activity-ktx:1.0.0-alpha06
are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.
API تغییر می کند
- ComponentActivity now contain a second constructor that takes a
@LayoutRes int
, which replaces the previous behavior of annotating your AppCompatActivity class with@ContentView
. This approach works in both app and library modules. ( b/128352521 ) - The
OnBackPressedCallback
related APIs on ComponentActivity have been deprecated in favor of the newOnBackPressedDispatcher
, retrievable viagetOnBackPressedDispatcher()
. ( aosp/922523 ) - Methods to add a new
OnBackPressedCallback
to theOnBackPressedDispatcher
now return aCancellable
object, allowing removal of the callback without requiring an explicit reference to theOnBackPressedDispatcher
. ( aosp/922523 ) - Adding a
OnBackPressedCallback
with an associatedLifecycleOwner
now results in adding and removing theOnBackPressedCallback
as the Lifecycle is started and stopped, respectively. ( aosp/922523 )
نسخه 1.0.0-alpha05
March 13th, 2019
androidx.activity:activity:1.0.0-alpha05
and androidx.activity:activity-ktx:1.0.0-alpha05
are released. The full list of commits included in this release can be found here .
ویژگی های جدید
-
@ContentView
annotation lookups are now cached ( b/123709449 )
نسخه 1.0.0-alpha04
30 ژانویه 2019
androidx.activity:activity 1.0.0-alpha04
and androidx.activity:activity-ktx 1.0.0-alpha04
are released.
ویژگی های جدید
- Added support for the
@ContentView
class annotation that allows you to indicate which layout XML file should be inflated as an alternative to usingsetContentView()
. ( aosp/837619 )
API تغییر می کند
- Added a note that
getViewModelStore()
should not be overridden and will be made final in a future release. Please file a feature request if you are currently overriding this method. ( aosp/837619 )
رفع اشکال
- The
activity
module now depends on version 2.1.0-alpha02 of ViewModel to match theactivity-ktx
module's dependency.
نسخه 1.0.0-alpha03
17 دسامبر 2018
androidx.activity 1.0.0-alpha03
is released.
ویژگی های جدید
- ComponentActivity now implements
BundleSavedStateRegistryOwner
and depends on the newly released SavedState library [ aosp/815133 ] - ComponentActivity now works around an Android framework bug that would cause InputMethodManager to leak the last focused view [ b/37122102 ]
Version 1.0.0-alpha02
3 دسامبر 2018
API تغییر می کند
- Added a note that
getLifecycle()
should not be overridden and will be madefinal
in a future release. Please file a feature request if you are currently overriding this method. ( aosp/815834 )
Version 1.0.0-alpha01
5 نوامبر 2018
androidx.activity 1.0.0-alpha01
introduces ComponentActivity
, a new base class of the existing FragmentActivity
and AppCompatActivity
.
ویژگی های جدید
- You can now register an
OnBackPressedCallback
viaaddOnBackPressedCallback
to receiveonBackPressed()
callbacks without needing to override the method in your activity. - Added a new
by viewModels()
Kotlin property delegate for retrievingViewModel
s from aComponentActivity
. - Pending input events (such as clicks) are now canceled in
onStop()
.
API تغییر می کند
- The implementation of
LifecycleOwner
andViewModelStoreOwner
have been moved fromFragmentActivity
toComponentActivity
. -
onRetainCustomNonConfigurationInstance
has been deprecated. Use aViewModel
for storing objects that need to survive configuration changes.