فعالیت

اعلام وابستگی ها

برای افزودن وابستگی به Activity، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

dependencies {
    def activity_version = "1.10.1"

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

dependencies {
    val activity_version = "1.10.1"

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

برای اطلاعات بیشتر درباره وابستگی‌ها، به افزودن وابستگی‌های ساخت نگاه کنید.

بازخورد

بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 1.11

نسخه 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 حاوی این commit ها است.

تغییرات API

• EDGE_NONE و frameTimeMillis جدید از Android 16 Beta03 را در BackEventCompat ارائه شده توسط توابع OnBackPressedCallback 's handleOnBackStarted و handleOnBackProgressed ادغام کرد.

به روز رسانی های وابستگی

• اکنون فعالیت با API 36 کامپایل شده است. ( I510e8 , b/301910674 )

نسخه 1.11.0-alpha01

12 مارس 2025

androidx.activity:activity:1.11.0-alpha01 ، androidx.activity:activity-compose:1.11.0-alpha01 و androidx.activity:activity-ktx:1.11.0-alpha01 منتشر شدند. نسخه 1.11.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

• 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 شامل این commit ها است.

رفع اشکال

• ViewTree OnBackPressedDispatcherOwners و FullyDrawnReporterOwners اکنون می توانند از طریق والدین مجزای یک view، مانند 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 حاوی این commit ها است.

تغییرات مهم از 1.9.0

• PhotoPicker اکنون اجازه می دهد تا تصاویر را به ترتیب انتخاب کنید و انتخاب کنید کدام برگه (چه آلبوم ها یا تصاویر) در ابتدا قابل مشاهده باشد.
• قراردادهای PickVisualMedia و PickMultipleVisualMedia Activity Result که فعال می‌شوند، اگر انتخابگر عکس سیستم در دسترس نباشد، Photo Picker دیگر مستقیماً به خدمات Google Play واگذار نمی‌شود، اما از کنش عمومی ACTION_SYSTEM_FALLBACK_PICK_IMAGES و موارد اضافی مرتبط برای ارائه یک تجربه منسجم Photo Picker به‌عنوان برنامه‌های OEM و سیستم بازگشتی استفاده می‌کند.
• ترکیب محلی 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 حاوی این commit ها است.

رفع اشکال

• رفع مشکلی که در آن تغییر حالت فعال در حالی که 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 حاوی این commit ها است.

تغییرات API

• یک ترکیب محلی LocalActivity جدید اضافه کرد که Activity برای محدوده فعلی فراهم می کند و نیازی به برنامه نویسان برای دریافت یک Activity از LocalContext را از بین می برد. همچنین با یک قانون پرز جدید همراه است که بررسی می کند LocalContext به اشتباه به یک Activity فرستاده می شود. ( I7746a , b/283009666 )

رفع اشکال

• از فعالیت 1.9.3 : PredictiveBackHandler دیگر پس از غیرفعال شدن کنترل کننده، پاسخ تماس خود را انجام نمی دهد. این مشکلی را برطرف می‌کند که در آن NavHost از Navigation Compose یک IndexOutOfBoundsException ایجاد می‌کند. ( I3f75e , b/365027664 , b/340202286 )

به روز رسانی وابستگی

• Activity Compose اکنون به Compose Runtime 1.7.0 بستگی دارد ( I7746a , b/283009666 )

نسخه 1.10.0-alpha02

4 سپتامبر 2024

androidx.activity:activity:1.10.0-alpha02 ، androidx.activity:activity-compose:1.10.0-alpha02 و androidx.activity:activity-ktx:1.10.0-alpha02 منتشر شدند. نسخه 1.10.0-alpha02 حاوی این تعهدات است.

تغییرات رفتار

• قراردادهای PickVisualMedia و PickMultipleVisualMedia 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 Compose PredictiveBackHandler 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.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 حاوی این commit ها است.

رفع اشکال

• 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 حاوی این 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 ارسال می کنید، اکنون می توانید پارامتر lambda detectDarkMode لغو کنید تا منطق سفارشی برای تشخیص حالت شب ارائه دهید. ( aosp/2546393 , b/278263793 )

نسخه 1.8.0-alpha05

7 ژوئن 2023

androidx.activity:activity:1.8.0-alpha05 ، androidx.activity:activity-compose:1.8.0-alpha05 و androidx.activity:activity-ktx:1.8.0-alpha05 منتشر شدند. این نسخه در یک شعبه داخلی توسعه یافته است.

تغییرات API

• Activity اکنون یک کلاس BackEventCompat را ارائه می دهد که به عنوان یک نسخه سازگار با عقب از BackEvent که از کلاس BackEvent چارچوب جدا شده است، عمل می کند.
• شکستن تغییر: روش های handleOnBackStarted و handleOnBackProgressed OnBackPressedCallback اکنون به جای یک کلاس 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 اکنون به جای جاوا از Kotlin Random استفاده می کند. ( 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، اجازه می‌دهد تا با پیاده‌سازی سطوح عملکرد بازگشتی API، تجربه یکدستی از 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 را ارائه می دهد:

این کلاس‌ها نیز به 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 استفاده خواهد کرد. API isPhotoPickerAvailable() که فقط سیستم 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 شامل این تعهدات است.

رفع اشکال

• OnBackPressedDispatcher اکنون به جای PRIORITY_OVERLAY OnBackInvokedCallback با PRIORITY_DEFAULT به ثبت می رساند. ( i3901f )
• کلاس هایی که ComponentActivity را گسترش می دهند ، اکنون همیشه هر دو تماس تلفنی onMultiWindowModeChanged() را اعزام می کنند. ( IC4D85 )
• هنگامی که تماس launch هر Exception به وجود می آورد و پاسخ به تماس بدون LifecycleOwner ثبت می کند ActivityResultCallback ActivityResultRegistry . ( ia7ff7 ، b/238350794 )
• ComponentActivity اکنون بدون نیاز به تماس با عملکرد فوق العاده در فعالیت شما ، به درستی تماس می گیرد. ( IE33C5 ، B/238057118 )

به روزرسانی وابستگی

• کتابخانه Activity اکنون به چرخه عمر 2.5.1 بستگی دارد. ( IF6697 )

نسخه 1.6.0-RC01

24 آگوست 2022

androidx.activity:activity:1.6.0-rc01 ، androidx.activity:activity-compose:1.6.0-rc01 و androidx.activity:activity-ktx:1.6.0-rc01 منتشر می شود. نسخه 1.6.0-RC01 شامل این تعهدات است.

رفع اشکال

• اولیه سازی یک OnBackPressedDispatcher با استفاده از نسخه های SDK قبل از 33 ، دیگر باعث ایجاد ClassVerificationError نمی شود. ( IC32E1 )
• کلاس هایی که از ComponentActivity ' onPictureInPictureModeChanged() پاسخ می دهند ، اکنون همیشه تماس های خود را ارسال می کنند. ( IB7FDB )

نسخه 1.6.0-beta01

10 آگوست 2022

androidx.activity:activity:1.6.0-beta01 ، androidx.activity:activity-compose:1.6.0-beta01 ، و androidx.activity:activity-ktx:1.6.0-beta01 منتشر می شود. نسخه 1.6.0-beta01 شامل این تعهدات است.

تغییرات API

• روشهای startActivityForResult و startIntentSenderForResult را در ComponentActivity با @NonNull نشان داده است زیرا عبور null همیشه منجر به تصادف شده است. ( id2a25 ، b/231476082 )

رفع اشکال

• از فعالیت 1.5.1 : ActivityResultRegistry دیگر نتیجه ای را به ActivityResultCallback بازگرداند وقتی تماس launch هر Exception انجام می دهد و پاسخ به تماس بدون LifecycleOwner ثبت می شود. ( ia7ff7 ، b/238350794 )
• از فعالیت 1.5.1 : ComponentActivity اکنون به درستی تماس های منو را به onPrepareOptionMenu() ، onCreateOptionsMenu() و onOptionsItemSelected() بدون نیاز به تماس با عملکرد فوق العاده ارسال می کند. ( IE33C5 ، B/238057118 )

به روزرسانی وابستگی

• از فعالیت 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 برای ActivityResultContract PickVisualMedia resultContract را بررسی کنید تا اکنون باید با 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 برطرف کرد که در آن تلاش برای ایجاد یک درخواست ، چه از طریق سازنده یا عملکرد سطح بالای کوتلین ، منجر به سرریز پشته می شود.
• 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 Beta 1 SDK کامپایل خواهد شد.

ویژگی های جدید

• اضافه شده ActivityResultContracts.PickVisualMedia و ActivityResultContracts.PickMultipleVisualMedia برای ارائه یک قرارداد سازگار با عقب که MediaStore.ACTION_PICK_IMAGES استفاده می کند. ACTION_PICK_IMAGES هنگامی که انتخاب کننده عکس در دسترس است و Intent.ACTION_OPEN_DOCUMENT ندارد.
• OnBackInvokedCallback در Android 13 Dev Beta 1 در OnBackPressedDispatcher ارائه شده توسط ComponentActivity یکپارچه کرد. این تضمین می کند که تمام API ها در هنگام فعال کردن یک ژست پیش بینی کننده پشتی ، روی کار OnBackPressedDispatcher استفاده می کنند.

نسخه 1.6.0-alpha01

23 مارس 2022

androidx.activity:activity:1.6.0-alpha01 ، androidx.activity:activity-compose:1.6.0-alpha01 ، و androidx.activity:activity-ktx:1.6.0-alpha01 منتشر می شود.

• توجه: این نسخه فقط در برابر Android 13 Developer Preview 2 SDK کامپایل خواهد شد.

ویژگی های جدید

• تغییرات یکپارچه در Android 13 Dev Preview 2 به ComponentActivity .

نسخه 1.5.1

نسخه 1.5.1

27 جولای 2022

androidx.activity:activity:1.5.1 ، androidx.activity:activity-compose:1.5.1 ، و androidx.activity:activity-ktx:1.5.1 منتشر می شود. نسخه 1.5.1 شامل این تعهدات است.

رفع اشکال

• ActivityResultRegistry دیگر نتیجه ای را به ActivityResultCallback باز نمی گرداند وقتی launch() تماس هرگونه Exception را انجام می دهد و پاسخ به تماس بدون LifecycleOwner ثبت می شود. ( ia7ff7 ، b/238350794 )

• ComponentActivity اکنون به طور صحیح مکالمه منوی را به onPrepareOptionMenu() ، onCreateOptionsMenu() و onOptionsItemSelected() بدون نیاز به تماس با عملکرد فوق العاده ارسال می کند. ( IE33C5 ، B/238057118 )

به روز رسانی وابستگی

• کتابخانه Activity اکنون به چرخه عمر 2.5.1 بستگی دارد. ( IF6697 )

نسخه 1.5.0

نسخه 1.5.0

29 ژوئن 2022

androidx.activity:activity:1.5.0 ، androidx.activity:activity-compose:1.5.0 و androidx.activity:activity-ktx:1.5.0 منتشر می شود. نسخه 1.5.0 شامل این تعهدات است.

تغییرات مهم از 1.4.0

• ComponentDialog - ComponentDialog یک زیر کلاس از Dialog است که شامل یک OnBackPressedDispatcher است که هنگام فشار دادن دکمه برگشت سیستم و گفتگو قابل مشاهده است. نکته مهم این است که این زیر کلاس همچنین ViewTreeOnBackPressedDispatcherOwner تنظیم می کند ، و به نمایش می دهد یک روش عمومی برای بازیابی توزیع کننده صحیح اعم از موجود در یک ComponentActivity یا یک ComponentDialog .
• رابط های پاسخ به تماس - ComponentActivity اکنون مجموعه ای از رابط های پاسخ به تماس ماژولار را پیاده سازی می کند که می توانند به جای تماس با فعالیت های Activity استفاده شوند. این رابط ها شامل موارد زیر هستند: OnNewIntentProvider ، OnConfigurationChangedProvider ، OnTrimMemoryProvider ، OnPictureInPictureModeChangedProvider ، OnMultiWindowModeChangedProvider
• ادغام CreationExtras - ComponentActivity اکنون این توانایی را دارد که یک ViewModelProvider.Factory ارائه دهد. از طریق CreationExtras از طریق چرخه عمر 2.5.0 .

تغییرات دیگر

• سازنده NO Parameter for ActivityResultContracts.CreateDocument با یک سازنده جدید که یک نوع میمون بتونی (به عنوان Intent.ACTION_CREATE_DOCUMENT ، "تصویر/png") را می گیرد ، مستهلک شده و جایگزین شده است.

نسخه 1.5.0-RC01

11 مه 2022

androidx.activity:activity:1.5.0-rc01 ، androidx.activity:activity-compose:1.5.0-rc01 ، و androidx.activity:activity-ktx:1.5.0-rc01 بدون تغییر از 1.5.0-beta01 منتشر نمی شود. نسخه 1.5.0-RC01 شامل این تعهدات است.

نسخه 1.5.0-beta01

20 آوریل 2022

androidx.activity:activity:1.5.0-beta01 ، androidx.activity:activity-compose:1.5.0-beta01 ، و androidx.activity:activity-ktx:1.5.0-beta01 منتشر می شود. نسخه 1.5.0-beta01 شامل این تعهدات است.

به روزرسانی های وابستگی

• فعالیت اکنون به چرخه عمر 2.4.0-beta01 بستگی دارد.

نسخه 1.5.0-alpha05

6 آوریل 2022

androidx.activity:activity:1.5.0-alpha05 ، androidx.activity:activity-compose:1.5.0-alpha05 ، و androidx.activity:activity-ktx:1.5.0-alpha05 منتشر می شود. نسخه 1.5.0-alpha05 شامل این تعهدات است.

رفع اشکال

• Onpanelclosed () ComponentActivity 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 ادغام شده است ، به عنوان بخشی از چرخه عمر 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 با یک سازنده جدید که یک نوع میمون بتونی (به عنوان Intent.ACTION_CREATE_DOCUMENT ، "image/png" ) را می گیرد ، مستهلک شده و جایگزین شده است. ( 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 شامل این تعهدات است.

تغییرات مهم از 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 شامل این تعهدات است.

رفع اشکال

• هنگامی که تماس 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 - activity-compose -Composion روش پسوند 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 یک بولی را به 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 and LocalActivityResultRegistryOwner.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 سفارشی ResultContract که دارای واحد 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 برطرف کرد که در آن Lambda که قبلاً onBack شده بود ، پس از بازپرداخت هنوز مورد استفاده قرار می گرفت. ( 8EB5EB )

نسخه 1.3.0-alpha03

24 فوریه 2021

androidx.activity:activity:1.3.0-alpha03 ، androidx.activity:activity-compose:1.3.0-alpha03 و androidx.activity:activity-ktx:1.3.0-alpha03 منتشر می شود. نسخه 1.3.0-alpha03 شامل این تعهدات است.

ویژگی های جدید

• در حال حاضر یک تابع registerForActivityResult برای بدست آوردن نتیجه از فعالیت های موجود در ترکیبات وجود دارد. ( IA7851 ، B/172690553 )

تغییرات API

• LocalOnBackPressedDispatcherOwner اکنون عملکردی را provides می دهد که می تواند با CompositionLocalProvider مورد استفاده قرار گیرد و API asProvidableCompositionLocal() را جایگزین کند. ( i45d24 )

نسخه 1.3.0-alpha02

10 فوریه 2021

androidx.activity:activity:1.3.0-alpha02 ، androidx.activity:activity-compose:1.3.0-alpha02 ، و androidx.activity:activity-ktx:1.3.0-alpha02 منتشر می شود. نسخه 1.3.0-alpha02 شامل این تعهدات است.

رفع اشکال

• رفع یک مسئله در فعالیت آهنگسازی 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 سفارشی ResultContract که دارای واحد 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 بررسی که منجر به مثبت کاذب هنگام استفاده از قطعه 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 فراهم می کند ، و در حال فراهم کردن هوک است. آزمایش این جریان ها. مشاهده به روز شده نتیجه یک فعالیت را مشاهده کنید.

• ContextAware : ComponentActivity اکنون ContextAware پیاده سازی می کند و به شما امکان می دهد یک یا چند مورد OnContextAvailableListener را اضافه کنید که قبل از Activity.onCreate() پایه ، یک پاسخ به تماس دریافت می کنند.

  • یک پسوند Kotlin به حالت تعلیق withContextAvailable() به شما امکان می دهد تا در صورت در دسترس بودن زمینه ، یک بلوک غیر تعلیق را اجرا کنید و نتیجه را برگردانید.
  • این API توسط FragmentActivity در قطعه 1.3.0 برای بازگرداندن وضعیت FragmentManager استفاده می شود. هر شنونده اضافه شده به زیر کلاسهای FragmentActivity بعد از آن شنونده اجرا می شود.
  • این API توسط AppCompatActivity در AppCompat 1.3.0-alpha02 یا بالاتر استفاده می شود. هر شنونده اضافه شده به زیر کلاسهای AppCompatActivity پس از آن شنونده اجرا می شود.

• پشتیبانی ViewTree : ComponentActivity اکنون از ViewTreeLifecycleOwner.get(View) ، ViewTreeViewModelStoreOwner.get(View) ، و ViewTreeSavedStateRegistryOwner API اضافه شده در Lifecycle 2.3.0 و SaveEdState 1.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 )
  • A suspending Kotlin extension withContextAvailable() allows you to run a non-suspending block when the Context becomes available and return a result. ( I8290c )
  • This API is used by FragmentActivity in Fragment 1.3.0-alpha08 to restore the state of the FragmentManager . Any listeners added to subclasses of FragmentActivity will run after that listener. ( I513da )
  • This API is used by AppCompatActivity in AppCompat 1.3.0-alpha02 . Any listeners added to subclasses of AppCompatActivity will run after that listener. ( I513da )

رفع اشکال

• Fixed an issue with the ActivityResultFragmentVersionDetector Lint check that caused it to break when using Lint 27.1.0 or higher. ( b/162155191 )

Version 1.2.0-alpha07

July 22, 2020

androidx.activity:activity:1.2.0-alpha07 and androidx.activity:activity-ktx:1.2.0-alpha07 are released. Version 1.2.0-alpha07 contains these commits.

ویژگی های جدید

• Added a new InvalidFragmentVersionForActivityResult lint check that verifies that you are using Fragment 1.3.0-alpha07 when using the Activity Result API , avoiding runtime crashes due to “invalid request code” issues and non-functioning permission requests caused by using older versions of Fragments. ( b/152554847 )

External Contribution

• Fixed an ArrayIndexOutOfBoundsException when parsing the results for the RequestPermission Activity Result contract. ( I8f9e3 , b/161057605 )

Version 1.2.0-alpha06

10 ژوئن 2020

androidx.activity:activity:1.2.0-alpha06 and androidx.activity:activity-ktx:1.2.0-alpha06 are released. Version 1.2.0-alpha06 contains these commits.

ویژگی های جدید

• You can now destructure the ActivityResult class in kotlin to directly access the requestCode and intent . ( b/157212935 )
• ActivityResultLauncher now allows you to get the ActivityResultContract that was used to register the launcher. ( b/156875743 )

تغییرات API

• Breaking change : The invoke() method on ActivityResultRegistry has been renamed to onLaunch() . ( b/157496491 )
• The OpenMultipleDocuments contract now returns an empty list instead of null to the registered callback if no result is returned. ( b/157348014 )

Version 1.2.0-alpha05

20 مه 2020

androidx.activity:activity:1.2.0-alpha05 and androidx.activity:activity-ktx:1.2.0-alpha05 are released. Version 1.2.0-alpha05 contains these commits.

ویژگی های جدید

• Added support for ViewTreeViewModelStoreOwner from Lifecycle 2.3.0-alpha03 , and ViewTreeSavedStateRegistryOwner from SavedState 1.1.0-alpha01 when using a View within a ComponentActivity . ( aosp/1297993 , aosp/1300264 )

تغییرات API

• The TakePicture contract now returns a boolean indicating success rather than a thumbnail Bitmap as this was very rarely supported by camera apps when writing the image to the provided Uri . ( b/154302879 )
• The invoke() extensions on ActivityResultLauncher have been removed in favor of explicitly using launch() to better indicate that these are asynchronous operations. Kotlin extensions for launch have been added to the androidx.activity.result package for ActivityResultLauncher<Void> and ActivityResultLauncher<Unit> that remove the need to pass in null or Unit , respectively, mirroring that behavior from the previously invoke() extensions. ( aosp/1304674 , aosp/1304675 )
• The IntentSenderRequest.Builder methods for setFlagsMask() and setFlagsValues() has been combined into a single setFlags() method. ( aosp/1302111 )

رفع اشکال

• When registering an ActivityResultCallback with a LifecycleOwner , fixed an issue where the callback would be triggered before the state reaches STARTED . ( aosp/1309744 )

تغییرات رفتار

• The ActivityResultRegistry now generates request codes starting at 0xFFFF rather than at 0 , preventing overlap when using startActivityForResult() or requestPermissions() in an activity. ( aosp/1302324 )

Version 1.2.0-alpha04

29 آوریل 2020

androidx.activity:activity:1.2.0-alpha04 and androidx.activity:activity-ktx:1.2.0-alpha04 are released. Version 1.2.0-alpha04 contains these commits.

ویژگی های جدید

• Added a contract that can call startIntentSenderForResult to the ActivityResult APIs. ( b/153007517 )

تغییرات API

• The prepareCall() method has been renamed to registerForActivityResult() , both on ComponentActivity here and in Fragment 1.3.0-alpha04 . ( aosp/1278717 )
• The GetContents , OpenDocuments , and RequestPermissions contracts have been renamed to GetMultipleContents , OpenMultipleDocuments , and RequestMultiplePermissions , respectively. ( aosp/1280161 )
• ComponentActivity now implements the ActivityResultRegisteryOwner interface. ( aosp/1290888 )
• - The startActivityForResult() / onActivityResult() and onRequestPermissionsResult() APIs on ComponentActivity have been deprecated. Please use the Activity Result APIs . ( b/154751887 )

رفع اشکال

• When using the GetMultipleContents and OpenMultipleDocuments contracts and selecting a single item, it is now correctly returned to your callback. ( b/152941153 )

Version 1.2.0-alpha03

1 آوریل 2020

androidx.activity:activity:1.2.0-alpha03 and androidx.activity:activity-ktx:1.2.0-alpha03 are released. Version 1.2.0-alpha03 contains these commits.

ویژگی های جدید

• Added the TakeVideo , PickContact , GetContent , GetContents , OpenDocument , OpenDocuments , OpenDocumentTree , and CreateDocument contracts to the set of pre-built contracts provided by ActivityResultContracts . ( aosp/1262482 , aosp/1266916 , aosp/1268960 )
• The Activity Result APIs now support launching an activity for result with an optional ActivityOptionsCompat . ( b/151860054 )

تغییرات API

• The TakePicture contract now takes a Uri input for where the image should be stored. The previous contract that does not take any input has been renamed to TakePicturePreview . ( aosp/1262482 )
• The registerActivityResultCallback() method on ActivityResultRegistry has been renamed to register() . ( aosp/1267621 )
• The dispose() method on ActivityResultLauncher has been renamed to unregister() and the unregisterResultCallback() on ActivityResultRegistry has been removed. ( aosp/1267621 )
• The createIntent() method of ActivityResultContact now takes a Context in addition to the input to make it possible to create explicit Intents. ( aosp/1238800 )
• An ActivityResultContract can now override getSynchronousResult() to deliver a result without calling startActivityForResult . This is used by the RequestPermission and RequestPermissions contracts to correctly deliver a 'granted' status if the requested permissions are already granted. ( b/151110799 )
• The previously available Dial contract has been removed as that Intent is not meant to be used with startActivityForResult() . ( aosp/1266916 )
• Many of the Activity Result APIs not meant to be extended are now final . This includes getActivityResultRegistry() , the prepareCall() methods, all methods of ActivityResultRegistry except invoke() , and a number of the default contracts that do not support optional extras. ( b/152439361 )

رفع اشکال

• Fixed a NullPointerException in ActivityResultRegistry when attempting to deliver results to a callback that has not yet been re-registered after a configuration change; ActivityResultRegistry now holds onto these pending results and delivers them when the callback is re-registered. ( b/152137004 )

Version 1.2.0-alpha02

18 مارس 2020

androidx.activity:activity:1.2.0-alpha02 and androidx.activity:activity-ktx:1.2.0-alpha02 are released. Version 1.2.0-alpha02 contains these commits.

ویژگی های جدید

• ActivityResultRegistry : ComponentActivity now provides an ActivityResultRegistry that lets you handle the startActivityForResult() + onActivityResult() as well as requestPermissions() + onRequestPermissionsResult() flows without overriding methods in your Activity or Fragment, brings increased type safety via ActivityResultContract , 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 Lifecycle 2.3.0-alpha01 such that it will return the Activity as the LifecycleOwner 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 where onBackPressed() would cause an IllegalStateException due to a bug in the android.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 using by viewModels() , the ViewModelProvider constructor, or ViewModelProviders.of() with a ComponentActivity 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 .

Dependency changes

• Activity now depends on Lifecycle 2.2.0-rc03 and Lifecycle ViewModel SavedState 1.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 .

Dependency changes

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

Dependency changes

• 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. The commits included in this version can be found here .

ویژگی های جدید

• Activity now depends on Core 1.1.0 stable.

رفع اشکال

• Activity now depends on Lifecycle 2.2.0-alpha04 .

Version 1.1.0-alpha02

7 آگوست 2019

androidx.activity:activity:1.1.0-alpha02 and androidx.activity:activity-ktx:1.1.0-alpha02 are released. The commits included in this version can be found here .

ویژگی های جدید

• SavedStateViewModelFactory is now the default factory used when using by viewModels() , the ViewModelProvider constructor, or ViewModelProviders.of() with a ComponentActivity ( 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. The commits included in this version can be found here .

ویژگی های جدید

• activity now depends on Lifecycle 2.2.0-alpha02 . ( aosp/1007817 )
• activity-ktx added a dependency on lifecycle-runtime-ktx ; you no longer need to explicitly add it to your dependencies when using activity-ktx or libraries that depend on activity-ktx (such as fragment-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. The commits included in this version can be found here .

Major Features of 1.0.0

• ComponentActivity : ComponentActivity serves as the new base class for FragmentActivity in Fragment 1.1.0 and, by extension, AppCompatActivity in AppCompat 1.1.0 .
• activity-ktx : The activity-ktx module includes a by viewModels Kotlin property extension for accessing ViewModels. This module is automatically included when you include fragment-ktx from Fragment 1.1.0 .
• OnBackPressedDispatcher : As a composable alternative to overriding onBackPressed() , you can now register a OnBackPressedCallback from any LifecycleOwner (such as a fragment) to intercept system back button events. A lambda with receiver version addCallback has been added to activity-ktx . See Provide custom back navigation documentation for more details.
• onRetainCustomNonConfigurationInstance deprecation : the onRetainCustomNonConfigurationInstance() and the related getLastCustomNonConfigurationInstance() APIs have been deprecated. It is strongly recommended to use ViewModels to store non-configuration state as they offer a composable solution suitable for any ViewModelStoreOwner that makes the ownership of the retained objects clear and provides an onCleared() callback for cleaning up resources when the activity is finally destroyed.

Version 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 . The commits included in this version can be found here .

Version 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 . The commits included in this version can be found here .

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. The commits included in this version can be found here .

API changes

• Breaking change: The previously deprecated addOnBackPressedCallback and removeOnBackPressedCallback methods on ComponentActivity have been removed. aosp/953857
• The setEnabled() and isEnabled() methods of OnBackPressedCallback are now final. b/131416833
• The remove() method of OnBackPressedCallback is now final. aosp/952720
• OnBackPressedDispatcher now has public constructors, allowing you to construct your own instances for testing, etc. aosp/953431
• onBackPressed() for ComponentActivity is now explicitly marked as @MainThread aosp/952721

رفع اشکال

• Fixed a ConcurrentModificationException when calling remove() from within the handleOnBackPressed() method of a OnBackPressedCalback that was added with a LifecycleOwner . b/131765095

Version 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. The commits included in this version can be found here .

API changes

This release makes significant changes to the handling of the onBackPressed() . See the updated custom back documentation for more details.

• The methods for OnBackPressedCallback and OnBackPressedDispatcher have been marked as @MainThread . ( aosp/943813 )
• The handleOnBackPressed() method no longer returns a boolean . Instead, OnBackPressedCallback is now an abstract class that can be enabled or disabled - only when the new isEnabled() method returns true will handleOnBackPressed() be called, in which you must handle the back button. ( aosp/944518 )
• The addCallback methods of OnBackPressedDispatcher no longer return a Cancellable instance. OnBackPressedCallback now contain a remove() method that fulfill this functionality, allowing you to call remove() during handleOnBackPressed() . ( aosp/944519 ) ( aosp/946316 )
• activity-ktx now contains a receiver scoped callback for addCallback that accepts a lamdba that implements handleOnBackPressed() and has access to isEnabled and remove() ( aosp/944520 )

Version 1.0.0-alpha06

3 آوریل 2019

androidx.activity:activity:1.0.0-alpha06 and androidx.activity:activity-ktx:1.0.0-alpha06 are released. The commits included in this version can be found here .

API changes

• 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 new OnBackPressedDispatcher , retrievable via getOnBackPressedDispatcher() . ( aosp/922523 )
• Methods to add a new OnBackPressedCallback to the OnBackPressedDispatcher now return a Cancellable object, allowing removal of the callback without requiring an explicit reference to the OnBackPressedDispatcher . ( aosp/922523 )
• Adding a OnBackPressedCallback with an associated LifecycleOwner now results in adding and removing the OnBackPressedCallback as the Lifecycle is started and stopped, respectively. ( aosp/922523 )

Version 1.0.0-alpha05

13 مارس 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 )

Version 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 using setContentView() . ( aosp/837619 )

API changes

• 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 the activity-ktx module's dependency.

Version 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 changes

• Added a note that getLifecycle() 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/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 via addOnBackPressedCallback to receive onBackPressed() callbacks without needing to override the method in your activity.
• Added a new by viewModels() Kotlin property delegate for retrieving ViewModel s from a ComponentActivity .
• Pending input events (such as clicks) are now canceled in onStop() .

API changes

• The implementation of LifecycleOwner and ViewModelStoreOwner have been moved from FragmentActivity to ComponentActivity .
• onRetainCustomNonConfigurationInstance has been deprecated. Use a ViewModel for storing objects that need to survive configuration changes.

فعالیت

اعلام وابستگی ها

To add a dependency on Activity, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

dependencies {
    def activity_version = "1.10.1"

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

dependencies {
    val activity_version = "1.10.1"

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

For more information about dependencies, see Add build dependencies .

بازخورد

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

یک شماره جدید ایجاد کنید

See the Issue Tracker documentation for more information.

نسخه 1.11

Version 1.11.0-beta01

9 آوریل 2025

androidx.activity:activity:1.11.0-beta01 , androidx.activity:activity-compose:1.11.0-beta01 , and androidx.activity:activity-ktx:1.11.0-beta01 are released. Version 1.11.0-beta01 contains these commits .

Version 1.11.0-alpha02

26 مارس 2025

androidx.activity:activity:1.11.0-alpha02 , androidx.activity:activity-compose:1.11.0-alpha02 , and androidx.activity:activity-ktx:1.11.0-alpha02 are released. Version 1.11.0-alpha02 contains these commits .

تغییرات API

• Integrated the new EDGE_NONE and frameTimeMillis from Android 16 Beta03 into the BackEventCompat provided by OnBackPressedCallback 's handleOnBackStarted and handleOnBackProgressed functions.

Dependency Updates

• Activity is now compiled with API 36. ( I510e8 , b/301910674 )

Version 1.11.0-alpha01

12 مارس 2025

androidx.activity:activity:1.11.0-alpha01 , androidx.activity:activity-compose:1.11.0-alpha01 , and androidx.activity:activity-ktx:1.11.0-alpha01 are released. Version 1.11.0-alpha01 contains these commits .

ویژگی های جدید

• Added MediaCapabilities API to PickVisualMediaRequest to let applications specify its media capabilities, such as supported HDR Types. ( Ic3ee7 )

نسخه 1.10

نسخه 1.10.1

26 فوریه 2025

androidx.activity:activity:1.10.1 , androidx.activity:activity-compose:1.10.1 , and androidx.activity:activity-ktx:1.10.1 are released. Version 1.10.1 contains these commits .

رفع اشکال

• ViewTree OnBackPressedDispatcherOwners and FullyDrawnReporterOwners can now be resolved through disjoint parents of a view, such as a ViewOverlay . See the release notes of core or the documentation in ViewTree.setViewTreeDisjointParent for more information on disjoint view parents. ( Ie7750 )

نسخه 1.10.0

15 ژانویه 2025

androidx.activity:activity:1.10.0 , androidx.activity:activity-compose:1.10.0 , and androidx.activity:activity-ktx:1.10.0 are released. Version 1.10.0 contains these commits .

Important changes since 1.9.0

• PhotoPicker now allows picking images in order and choosing which tab (either albums or images) should be initially visible.
• The PickVisualMedia and PickMultipleVisualMedia Activity Result contracts that trigger the Photo Picker no longer directly delegates to Google Play services if the system Photo picker is not available, but uses the public ACTION_SYSTEM_FALLBACK_PICK_IMAGES action and related extras to provide a consistent Photo Picker experience to OEMs and system apps as a fallback.
• New LocalActivity composition local that provides the Activity for the current scope, removing the need for developers to get an Activity from the LocalContext .

Version 1.10.0-rc01

11 دسامبر 2024

androidx.activity:activity:1.10.0-rc01 , androidx.activity:activity-compose:1.10.0-rc01 , and androidx.activity:activity-ktx:1.10.0-rc01 are released. Version 1.10.0-rc01 contains these commits .

رفع اشکال

• Fixed an issue where changing the enabled state while the PredictiveBackHandler is currently active would short circuit the callback immediately. It will now finish the current callback regardless of the enabled status changes. ( Ib8719 )

Version 1.10.0-beta01

13 نوامبر 2024

androidx.activity:activity:1.10.0-beta01 , androidx.activity:activity-compose:1.10.0-beta01 , and androidx.activity:activity-ktx:1.10.0-beta01 are released with no changes since the last alpha. Version 1.10.0-beta01 contains these commits .

Version 1.10.0-alpha03

30 اکتبر 2024

androidx.activity:activity:1.10.0-alpha03 , androidx.activity:activity-compose:1.10.0-alpha03 , and androidx.activity:activity-ktx:1.10.0-alpha03 are released. Version 1.10.0-alpha03 contains these commits .

تغییرات API

• Added a new LocalActivity composition local that provides the Activity for the current scope, removing the need for developers to get an Activity from the LocalContext . It also comes with a new lint rule that checks when the LocalContext is incorrectly being cast to an Activity . ( I7746a , b/283009666 )

رفع اشکال

• From Activity 1.9.3 : PredictiveBackHandler will no longer fire it's callback after the handler has been disabled. This will fix an issue where the NavHost from Navigation Compose would throw an IndexOutOfBoundsException . ( I3f75e , b/365027664 , b/340202286 )

Dependency Update

• Activity Compose now depends on Compose Runtime 1.7.0 ( I7746a , b/283009666 )

Version 1.10.0-alpha02

4 سپتامبر 2024

androidx.activity:activity:1.10.0-alpha02 , androidx.activity:activity-compose:1.10.0-alpha02 , and androidx.activity:activity-ktx:1.10.0-alpha02 are released. Version 1.10.0-alpha02 contains these commits .

تغییرات رفتار

• The PickVisualMedia and PickMultipleVisualMedia Activity Result contracts that trigger the Photo Picker no longer directly delegates to Google Play services if the system Photo picker is not available, but uses the public ACTION_SYSTEM_FALLBACK_PICK_IMAGES action and related extras to provide a consistent Photo Picker experience to OEMs and system apps as a fallback. This should have no effect on the user experience for devices that have a recent version of Google Play services. ( I3513d )

رفع اشکال

• Removed manual outlining of access to new platform APIs since this happens automatically via API modeling when using R8 with AGP 7.3 or later (eg R8 version 3.3) and for all builds when using AGP 8.1 or later (eg D8 version 8.1). Clients who are not using AGP are advised to update to D8 version 8.1 or later. برای جزئیات بیشتر به این مقاله مراجعه کنید. ( I9496c , b/345472586 )
• From Activity 1.9.2 : Fixed an issue where the Activity Compose PredictiveBackHandler API would continue to handle the system back gesture on the frame it was disabled, which could result in libraries like Navigation Compose to handle back even with an empty back stack, resulting in it throwing an IndexOutOfBoundsException . ( Ie3301 , b/340202286 )
• From Activity 1.9.1 : Fixed an issue with PredictiveBackHandler where after doing system back, attempting to do onBackPressed from the OnBackPressedDispatcher would fail. ( I5f1f8 )

Version 1.10.0-alpha01

26 ژوئن 2024

androidx.activity:activity:1.10.0-alpha01 , androidx.activity:activity-compose:1.10.0-alpha01 , and androidx.activity:activity-ktx:1.10.0-alpha01 are released. This version is developed in an internal branch.

ویژگی های جدید

• Added support for new PhotoPicker features introduced in Android V including being able to pick images in order and choose which tab (either albums or images) should be initially visible.

نسخه 1.9

نسخه 1.9.3

16 اکتبر 2024

androidx.activity:activity:1.9.3 , androidx.activity:activity-compose:1.9.3 , and androidx.activity:activity-ktx:1.9.3 are released. Version 1.9.3 contains these commits .

رفع اشکال

• PredictiveBackHandler will no longer fire it's callback after the handler has been disabled. This will fix an issue where the NavHost from Navigation Compose would throw an IndexOutOfBoundsException . ( I3f75e , b/340202286 )

Version 1.9.2

4 سپتامبر 2024

androidx.activity:activity:1.9.2 , androidx.activity:activity-compose:1.9.2 , and androidx.activity:activity-ktx:1.9.2 are released. Version 1.9.2 contains these lthcocommits .

رفع اشکال

• Fixed an issue where the Activity Compose PredictiveBackHandler API would continue to handle the system back gesture on the frame it was disabled, which could result in libraries like Navigation Compose to handle back even with an empty back stack, resulting in it throwing an IndexOutOfBoundsException . ( Ie3301 , b/340202286 )

Version 1.9.1

24 جولای 2024

androidx.activity:activity:1.9.1 , androidx.activity:activity-compose:1.9.1 , and androidx.activity:activity-ktx:1.9.1 are released. Version 1.9.1 contains these commits .

رفع اشکال

• Fixed an issue with PredictiveBackHandler where after doing system back, attempting to do onBackPressed from the OnBackPressedDispatcher would fail. ( I5f1f8 )

نسخه 1.9.0

17 آوریل 2024

androidx.activity:activity:1.9.0 , androidx.activity:activity-compose:1.9.0 , and androidx.activity:activity-ktx:1.9.0 are released. Version 1.9.0 contains these commits .

Important changes since 1.8.0

• ComponentActivity now implements OnUserLeaveHintProvider to allow components to callbacks for onUserLeaveHint events.
• The OnBackPressedCallback , BackHandler , and PredictiveBackHandler APIs now warn when calling onBackPressedDispatcher.onBackPressed() when handling back as that will always break the Predictive Back Animation . See the best practices guide for more details.
• The remainder of the Activity APIs have been rewritten in Kotlin and all extensions previously available in activity-ktx have been moved to activity . activity-ktx is now completely empty.
  • As part of the conversion of ActivityResultLauncher to Kotlin, the getContract method is now an abstract Kotlin property. This is a binary compatible change, but source breaking if your implementation of ActivityResultLauncher is written in Kotlin.

Version 1.9.0-rc01

3 آوریل 2024

androidx.activity:activity:1.9.0-rc01 , androidx.activity:activity-compose:1.9.0-rc01 , and androidx.activity:activity-ktx:1.9.0-rc01 are released. Version 1.9.0-rc01 contains these commits .

به روز رسانی وابستگی

• Activity now depends on Profile Installer 1.3.1 .

Version 1.9.0-beta01

20 مارس 2024

androidx.activity:activity:1.9.0-beta01 , androidx.activity:activity-compose:1.9.0-beta01 , and androidx.activity:activity-ktx:1.9.0-beta01 are released. Version 1.9.0-beta01 contains these commits .

رفع اشکال

• Fixed an Activity startup performance regression introduced in Activity 1.9.0-alpha02 caused by calling the OnBackPressedDispatcher as part of the creation of the Activity. ( Ie75e3 )

Version 1.9.0-alpha03

7 فوریه 2024

androidx.activity:activity:1.9.0-alpha03 , androidx.activity:activity-compose:1.9.0-alpha03 , and androidx.activity:activity-ktx:1.9.0-alpha03 are released. Version 1.9.0-alpha03 contains these commits.

Lint Warning

• The OnBackPressedCallback , BackHandler , and PredictiveBackHandler APIs now warn when calling onBackPressedDispatcher.onBackPressed() when handling back as that will always break the Predictive Back Animation . See the best practices guide for more details. ( 1e4222 , 2c950d , b/287505200 )

رفع اشکال

• If a back event is sent from the system started during an already running Predictive Back Gesture, the currently running Predictive Back Gesture is canceled and the new back event takes over to begin a new Predictive Back Gesture. ( I3482e )
• Fixed a crash when accessing the onBackPressedDispatcher from a ComponentActivity for the first time from a background thread. It is now safe to access the onBackPressedDispatcher on any thread. ( I79955 )

Version 1.9.0-alpha02

24 ژانویه 2024

androidx.activity:activity:1.9.0-alpha02 , androidx.activity:activity-compose:1.9.0-alpha02 , and androidx.activity:activity-ktx:1.9.0-alpha02 are released. Version 1.9.0-alpha02 contains these commits.

Kotlin Conversions

• ActivityResultRegistry has been rewritten in Kotlin. This ensures that the nullability of the generics on the contract passed to register will correctly be passed through to the ActivityResultLauncher returned to you. ( I121f0 )
• ActivityResult has been rewritten in Kotlin. The ActivityResult Kotlin extensions that support destructuring into the resultCode and data fields have been moved from activity-ktx to activity . ( I0565a )
• The Kotlin extensions of by viewModels() for ComponentActivity and trackPipAnimationHintView have been moved from activity-ktx to activity . The activity-ktx artifact is now completely empty. ( I0a444 )

رفع اشکال

• The enableEdgeToEdge API now draws around any display cutouts. ( a3644b , b/311173461 )
• From Activity 1.8.2 : Fixed the extra passed to the Photo Picker Activity Contract's ACTION_SYSTEM_FALLBACK_PICK_IMAGES to correctly pass it the EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX key, rather than using the extra with the key "com.google.android.gms.provider.extra.PICK_IMAGES_MAX" . It is strongly recommended if you are an OEM who implements a system fallback Photo Picker to support both extras to ensure the widest compatibility. ( I96a00 )

Version 1.9.0-alpha01

29 نوامبر 2023

androidx.activity:activity:1.9.0-alpha01 , androidx.activity:activity-compose:1.9.0-alpha01 , and androidx.activity:activity-ktx:1.9.0-alpha01 are released. Version 1.9.0-alpha01 contains these commits.

ویژگی های جدید

• ComponentActivity now implements OnUserLeaveHintProvider to allow components to callbacks for onUserLeaveHint events. ( I54892 )

تغییرات API

• ComponentActivity has been rewritten in Kotlin. ( I14f31 )
• ActivityResultCaller has been rewritten in Kotlin. ( Ib02e4 )
• ActivityResultLauncher has been rewritten in Kotlin. As part of that conversion, the getContract method is now an abstract Kotlin property. This is a binary compatible change, but source breaking if your implementation of ActivityResultLauncher is written in Kotlin. ( Id4615 )
• PickVisualMediaRequest now has the same minimum API level of 19 as the PickVisualMedia Activity Result contract. ( Id6e21 )

Dependency Update

• Activity now depends on 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 , and androidx.activity:activity-ktx:1.8.2 are released. Version 1.8.2 contains these commits.

رفع اشکال

• Fixed the extra passed to the Photo Picker Activity Contract's ACTION_SYSTEM_FALLBACK_PICK_IMAGES to correctly pass it the EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX key, rather than using the extra with the key "com.google.android.gms.provider.extra.PICK_IMAGES_MAX" . It is strongly recommended if you are an OEM who implements a system fallback Photo Picker to support both extras to ensure the widest compatibility. ( I96a00 )

نسخه 1.8.1

15 نوامبر 2023

androidx.activity:activity:1.8.1 , androidx.activity:activity-compose:1.8.1 , and androidx.activity:activity-ktx:1.8.1 are released. Version 1.8.1 contains these commits.

رفع اشکال

• OnBackPressedDispatcher now continues to dispatch to the correct OnBackPressedCallback even after a new OnBackPressedCallback is added while the back gesture is being handled. ( Id0ff6 )

نسخه 1.8.0

4 اکتبر 2023

androidx.activity:activity:1.8.0 , androidx.activity:activity-compose:1.8.0 , and androidx.activity:activity-ktx:1.8.0 are released. Version 1.8.0 contains these commits.

Important changes since 1.7.0

• Predictive Back - The OnBackPressedCallback now offers new Predictive Back callbacks for handling the back gesture starting, progress throughout the gesture, and the back gesture being canceled in addition to the previous handleOnBackPressed() callback for when the back gesture is committed. This also comes with the PredictiveBackHandler Composable to handle predictive back gesture events in Activity Compose. It provides a Flow of BackEventCompat objects that must be collected in the suspending lamba you provide:

  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() has now been deprecated in favor of the APIs for handling back. Developers should now utilize the OnBackPressedDispatcher , rather than overriding this method.

• EdgeToEdge - ComponentActivity.enableEdgeToEdge() has been added to easily set up the edge-to-edge display in a backward-compatible manner.

Version 1.8.0-rc01

20 سپتامبر 2023

androidx.activity:activity:1.8.0-rc01 , androidx.activity:activity-compose:1.8.0-rc01 , and androidx.activity:activity-ktx:1.8.0-rc01 are released. Version 1.8.0-rc01 contains these commits.

Version 1.8.0-beta01

6 سپتامبر 2023

androidx.activity:activity:1.8.0-beta01 , androidx.activity:activity-compose:1.8.0-beta01 , and androidx.activity:activity-ktx:1.8.0-beta01 are released. Version 1.8.0-beta01 contains these commits.

Documentation Improvement

• Improved the documentation of BackEventCompat . ( aosp/2722254 )

Version 1.8.0-alpha07

23 آگوست 2023

androidx.activity:activity:1.8.0-alpha07 , androidx.activity:activity-compose:1.8.0-alpha07 , and androidx.activity:activity-ktx:1.8.0-alpha07 are released. Version 1.8.0-alpha07 contains these commits.

ویژگی های جدید

• Activity Compose has added a new PredictiveBackHandler Composable to handle predictive back gesture events. It provides a Flow of BackEventCompat objects that must be collected in the suspending lamba you provide:

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

  It also comes with a compile time warning via lint rule to ensure the Flow calls collect() . ( Id2773 , b/294884345 )

• The onBackPressedDispatcher in ComponentActivity is now initialized lazily so that it is only created when required. ( I0bf8e )

رفع اشکال

• ComponentActivity will no longer show a NPE on Android 13 when it gets an onBackPressed() callback and the Activity has already been DESTROYED . ( Idb055 , b/291869278 )
• Removed usages of experimental isAtLeastU() API ( Ie9117 , b/289269026 )

Version 1.8.0-alpha06

21 ژوئن 2023

androidx.activity:activity:1.8.0-alpha06 , androidx.activity:activity-compose:1.8.0-alpha06 , and androidx.activity:activity-ktx:1.8.0-alpha06 are released. Version 1.8.0-alpha06 contains these commits.

ویژگی های جدید

• The OnBackPressedDispatcher now correctly cancels any callbacks that are removed during a Predictive Back Gesture. ( I3f90f )

تغییرات API

• When passing SystemBarStyle.auto to the enableEdgeToEdge API, you can now override the detectDarkMode lambda parameter to provide custom logic for detecting night mode. ( aosp/2546393 , b/278263793 )

Version 1.8.0-alpha05

7 ژوئن 2023

androidx.activity:activity:1.8.0-alpha05 , androidx.activity:activity-compose:1.8.0-alpha05 , and androidx.activity:activity-ktx:1.8.0-alpha05 are released. This version is developed in an internal branch.

تغییرات API

• Activity now provides a BackEventCompat class that serves as a backward compatible version of BackEvent that is decoupled from the framework BackEvent class.
• Breaking change: The handleOnBackStarted and handleOnBackProgressed methods of OnBackPressedCallback now receive an androidx.activity.BackEventCompat instance rather than a framework android.window.BackEvent class. The equivalent @VisibleForTesting APIs on OnBackPressedDispatcher have also been updated.
• The constructor for OnBackPressedDispatcher now takes an optional Consumer<Boolean> instance that allows the owners of the dispatcher to receive a callback whenever the number of enabled callbacks changes from zero to non-zero or vice versa.

رفع اشکال

• From Activity 1.7.2 : Fix ReportDrawn crashing when navigating away from a screen before report is called. ( Ic46f1 , b/260506820 )

Version 1.8.0-alpha04

10 مه 2023

androidx.activity:activity:1.8.0-alpha04 , androidx.activity:activity-compose:1.8.0-alpha04 , and androidx.activity:activity-ktx:1.8.0-alpha04 are released. This was released from an internal branch.

رفع اشکال

• From Activity 1.7.1 : - The ReportFullyDrawExecuter no longer leaks when using ComponentActivity with ActivityScenario . ( Id2ff2 , b/277434271 )

Version 1.8.0-alpha03

12 آوریل 2023

androidx.activity:activity:1.8.0-alpha03 , androidx.activity:activity-compose:1.8.0-alpha03 , and androidx.activity:activity-ktx:1.8.0-alpha03 are released. This was released from an internal branch.

ویژگی های جدید

• Added ComponentActivity.setUpEdgeToEdge() to easily set up the edge-to-edge display in a backward-compatible manner.

تغییرات API

• ComponentActivity.onBackPressed() has now been deprecated in favor of the APIs for handling back. Developers should now utilize the OnBackPressedDispatcher , rather than overriding this method. ( Ibce2f , b/271596918 )
• ComponentDialog and ComponentActivity now contain public API initViewTreeOwners() to be used to initialize all view tree owners before setting the content view. ( Ibdce0 , b/261314581 )

رفع اشکال

• Fixed an issue where Fragments were incorrectly invalidating MenuHosts and causing other menus in the Activity to have unexpected behavior. ( I9404e , b/244336571 )

سایر تغییرات

• The ActivityResultRegister now uses Kotlin Random instead of Java. ( I4d98f , b/272096025 )

Version 1.8.0-alpha02

8 مارس 2023

androidx.activity:activity:1.8.0-alpha02 , androidx.activity:activity-compose:1.8.0-alpha02 , and androidx.activity:activity-ktx:1.8.0-alpha02 are released. Developed from an internal branch.

به روز رسانی وابستگی

• From Activity 1.7.0-rc01 : Activity now depends on Lifecycle 2.6.0 .

Version 1.8.0-alpha01

8 فوریه 2023

androidx.activity:activity:1.8.0-alpha01 , androidx.activity:activity-compose:1.8.0-alpha01 , and androidx.activity:activity-ktx:1.8.0-alpha01 are released. This was built from an internal branch.

ویژگی های جدید

• The OnBackPressedCallback class now contains new Predictive Back progress callbacks for handling the back gesture starting, progress throughout the gesture, and the back gesture being canceled in addition to the previous handleOnBackPressed() callback for when the back gesture is committed.

نسخه 1.7

نسخه 1.7.2

24 مه 2023

androidx.activity:activity:1.7.2 , androidx.activity:activity-compose:1.7.2 , and androidx.activity:activity-ktx:1.7.2 are released. Version 1.7.2 contains these commits.

رفع اشکال

• Fix ReportDrawn crashing when navigating away from a screen before report is called. ( Ic46f1 , b/260506820 )

نسخه 1.7.1

19 آوریل 2023

androidx.activity:activity:1.7.1 , androidx.activity:activity-compose:1.7.1 , and androidx.activity:activity-ktx:1.7.1 are released. Version 1.7.1 contains these commits.

رفع اشکال

• The ReportFullyDrawExecuter no longer leaks when using ComponentActivity with ActivityScenario . ( Id2ff2 , b/277434271 )

نسخه 1.7.0

22 مارس 2023

androidx.activity:activity:1.7.0 , androidx.activity:activity-compose:1.7.0 , and androidx.activity:activity-ktx:1.7.0 are released. Version 1.7.0 contains these commits.

Important changes since 1.6.0

• The Photo Picker activity contracts in PickVisualMedia and PickMultipleVisualMedia have been updated to contain an additional fallback for when MediaStore.ACTION_PICK_IMAGES is unavailable that allows OEMs and system apps, such as Google Play services, to provide a consistent Photo Picker experience on a wider range of Android devices and API levels by implementing the fallback action . The Photo Picker will use this fallback if it is available before falling back to using Intent.ACTION_OPEN_DOCUMENT , which remains to support all API 19 and higher devices.
• ComponentDialog now implements SavedStateRegistryOwner and has access to its own SavedStateRegistry and sets the SavedStateRegistryOwner for its ViewTree . It is now possible to use Jetpack Compose within a ComponentDialog as it meets both the LifecycleOwner and SavedStateRegistryOwner attached to the Window via the ViewTree APIs requirements.
• IntentSenderRequest.Builder.setFlags() now allows you to set multiple flags from Intent , rather than only a single flag.

Kotlin Conversion

A number of Activity classes have been converted to Kotlin. All converted classes still retain their binary compatibility with previous versions. The following classes have source incompatible changes for classes written in Kotlin: ActivityResultRegistryOwner , OnBackPressedDispatcherOwner .

The table below provides the source conversions for the new version of Activity:

These classes were also converted to Kotlin, but remain source compatible: ContextAware , ContextAwareHelper , OnContextAvailableListener , IntentSenderRequest , and OnBackPressedDispatcher

FullyDrawnReporter APIs

ComponentActivity now provides a FullyDrawnReporter instance that allows multiple components to report when they are ready for interaction. ComponentActivity will wait for all components to complete before calling reportFullyDrawn() on your behalf. These APIs take care of the timing requirements for you and do not need to be called as part of an onDraw call.

These APIs are encouraged to enable:

• Signaling the Android Runtime when startup completes, to ensure all of the code run during a multi-frame startup sequence is included and prioritized for background compilation.
• Signaling Macrobenchmark and Play Vitals when your application should be considered fully drawn for startup metrics, so you can track performance.

Three Activity Compose APIs have been added to make it more convenient to use the FullyDrawnReporter from individual composables:

• ReportDrawn indicates that your composable is immediately ready for interaction.
• ReportDrawnWhen takes a predicate (ie, list.count > 0 ) to indicate when your composable is ready for interaction.
• ReportDrawnAfter takes a suspending method that, when it completes, indicates that you are ready for interaction.

Dependency Updates

• Activity now depends on Lifecycle 2.6.1 . ( 8fc31d )
• Activity now depends on ProfileInstaller 1.3.0 . ( 83d3b1 )

Version 1.7.0-rc01

8 مارس 2023

androidx.activity:activity:1.7.0-rc01 , androidx.activity:activity-compose:1.7.0-rc01 , and androidx.activity:activity-ktx:1.7.0-rc01 are released. Version 1.7.0-rc01 contains these commits.

به روز رسانی وابستگی

• Activity now depends on Lifecycle 2.6.0 .

Version 1.7.0-beta02

22 فوریه 2023

androidx.activity:activity:1.7.0-beta02 , androidx.activity:activity-compose:1.7.0-beta02 , and androidx.activity:activity-ktx:1.7.0-beta02 are released. Version 1.7.0-beta02 contains these commits.

تغییرات API

• The action and extra used by the PickVisualMedia and PickMultipleVisualMedia contracts as a fallback for when MediaStore.ACTION_PICK_IMAGES is unavailable are now public constants that provide API stability to OEMs and system apps that want to provide a consistent Photo Picker experience. The implementation of this fallback is still limited to only system apps. ( Icd320 )

Version 1.7.0-beta01

8 فوریه 2023

androidx.activity:activity:1.7.0-beta01 , androidx.activity:activity-compose:1.7.0-beta01 , and androidx.activity:activity-ktx:1.7.0-beta01 are released. Version 1.7.0-beta01 contains these commits.

ویژگی های جدید

• IntentSenderRequest.Builder.setFlags() now allows you to set multiple flags from Intent , rather than only a single flag. ( Iac04c )

رفع اشکال

• The fallback for PickVisualMedia for when the framework Photo Picker is unavailable now correctly limits the handling to apps installed in the device's system image. ( If8ae6 )

Kotlin Conversions

• ActivityResultRegistryOwner is now written in Kotlin. This is a source incompatible change for those classes written in Kotlin - you must now override the activityResultRegistry property rather than implementing the previous getActivityResultRegistry() function. ( I0b00e )
• OnBackPressedDispatcherOwner is now written in Kotlin. This is a source incompatible change for those classes written in Kotlin - you must now override the onBackPressedDispatcher property rather than implementing the previous getOnBackPressedDispatcher function. ( Ia277d )
• ContextAware , ContextAwareHelper , OnContextAvailableListener , IntentSenderRequest and OnBackPressedDispatcher are now written in Kotlin. ( I1a73e , Iada92 , aosp/2410754 , I18ac7 , b/257291701 )

Version 1.7.0-alpha04

25 ژانویه 2023

androidx.activity:activity:1.7.0-alpha04 , androidx.activity:activity-compose:1.7.0-alpha04 , and androidx.activity:activity-ktx:1.7.0-alpha04 are released. Version 1.7.0-alpha04 contains these commits.

ویژگی های جدید

• The PickVisualMedia and PickMultipleVisualMedia Activity Result contracts will now use a Google Play services provided Photo Picker where available in cases where the Android system provided Photo Picker (eg, MediaStore.ACTION_PICK_IMAGES ) is not available. The isPhotoPickerAvailable() API that only detects the Android system provided Photo Picker has been deprecated. It is recommended to use the new isPhotoPickerAvailable(Context) API, which will return if either Photo Picker is available. ( I55be6 )

Version 1.7.0-alpha03

11 ژانویه 2023

androidx.activity:activity:1.7.0-alpha03 , androidx.activity:activity-compose:1.7.0-alpha03 , and androidx.activity:activity-ktx:1.7.0-alpha03 are released. Version 1.7.0-alpha03 contains these commits.

ویژگی های جدید

• ComponentDialog now implements SavedStateRegistryOwner and has access to its own SavedStateRegistry and sets the SavedStateRegistryOwner for its ViewTree. It is now possible to use Jetpack Compose within a ComponentDialog as it meets both the LifecycleOwner and SavedStateRegistryOwner attached to the Window via the ViewTree APIs requirements. ( Idca17 , I73468 b/261162296 )

تغییرات API

• Added a ReportDrawn composable that immediately marks the activity as ready to call reportFullyDrawn . ( Ic5b14 , b/259687964 )

Kotlin Conversions

• The ActvitiyResultCallback and OnBackPressedCallback classes have both been converted to Kotlin while maintaining source and binary compatibility. ( Ifc5e5 , Ide1b0 , b/257291701 )

Version 1.7.0-alpha02

24 اکتبر 2022

androidx.activity:activity:1.7.0-alpha02 , androidx.activity:activity-compose:1.7.0-alpha02 , and androidx.activity:activity-ktx:1.7.0-alpha02 are released. Version 1.7.0-alpha02 contains these commits.

رفع اشکال

• From Activity 1.6.1 : Fixed an issue with the PickMultipleVisualMedia Activity Result contract not launching on Android R devices when using the default value for maxItems . ( Ie2776 , b/249182130 )

Version 1.7.0-alpha01

5 اکتبر 2022

androidx.activity:activity:1.7.0-alpha01 , androidx.activity:activity-compose:1.7.0-alpha01 , and androidx.activity:activity-ktx:1.7.0-alpha01 are released. Version 1.7.0-alpha01 contains these commits.

FullyDrawnReporter APIs

ComponentActivity now provides a FullyDrawnReporter instance that allows multiple components to report when they are ready for interaction. ComponentActivity will wait for all components to complete before calling reportFullyDrawn() on your behalf. These APIs take care of the timing requirements for you and do not need to be called as part of an onDraw call.

These APIs are encouraged to enable:

• Signaling the Android Runtime when startup completes, to ensure all of the code run during a multi-frame startup sequence is included and prioritized for background compilation.
• Signaling Macrobenchmark and Play Vitals when your application should be considered fully drawn for startup metrics, so you can track performance.

Two Activity Compose APIs have been added to make it more convenient to use the FullyDrawnReporter from individual composables:

• ReportDrawnWhen takes a predicate (ie, list.count > 0 ) to indicate when your composable is ready for interaction.
• ReportDrawnAfter takes a suspending method that, when it completes, indicates that you are ready for interaction.

نسخه 1.6.1

نسخه 1.6.1

24 اکتبر 2022

androidx.activity:activity:1.6.1 , androidx.activity:activity-compose:1.6.1 , and androidx.activity:activity-ktx:1.6.1 are released. Version 1.6.1 contains these commits.

رفع اشکال

• Fixed an issue with the PickMultipleVisualMedia Activity Result contract not launching on Android R devices when using the default value for 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 , and androidx.activity:activity-ktx:1.6.0 are released. Version 1.6.0 contains these commits.

Important changes since 1.5.0

• Added ActivityResultContracts.PickVisualMedia and ActivityResultContracts.PickMultipleVisualMedia for providing a backward compatible contract that uses MediaStore.ACTION_PICK_IMAGES when the Photo Picker is available and Intent.ACTION_OPEN_DOCUMENT when it is not available.
• Integrated the OnBackInvokedCallback in Android 13 into the OnBackPressedDispatchers provided by ComponentActivity and ComponentDialog . This ensures that all APIs built on OnBackPressedDispatcher work when enabling a predictive back gesture .

Version 1.6.0-rc02

7 سپتامبر 2022

androidx.activity:activity:1.6.0-rc02 , androidx.activity:activity-compose:1.6.0-rc02 , and androidx.activity:activity-ktx:1.6.0-rc02 are released. Version 1.6.0-rc02 contains these commits.

رفع اشکال

• OnBackPressedDispatcher now registers the OnBackInvokedCallback with the PRIORITY_DEFAULT instead of PRIORITY_OVERLAY . ( I3901f )
• Classes that extend ComponentActivity will now always have both of their onMultiWindowModeChanged() callbacks dispatched. ( Ic4d85 )
• The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch call throws any Exception and the callback was registered without a LifecycleOwner . ( Ia7ff7 , b/238350794 )
• ComponentActivity will now properly dispatch menu calls without the need to call the super function in your activity. ( Ie33c5 , b/238057118 )

Dependency Update

• The Activity library now depends on Lifecycle 2.5.1 . ( If6697 )

Version 1.6.0-rc01

24 آگوست 2022

androidx.activity:activity:1.6.0-rc01 , androidx.activity:activity-compose:1.6.0-rc01 , and androidx.activity:activity-ktx:1.6.0-rc01 are released. Version 1.6.0-rc01 contains these commits.

رفع اشکال

• Initializing an OnBackPressedDispatcher will no longer cause ClassVerificationError s when using SDK versions prior to 33. ( Ic32e1 )
• Classes that override ComponentActivity 's onPictureInPictureModeChanged() callback will now always have their callbacks dispatched. ( Ib7fdb )

Version 1.6.0-beta01

August 10, 2022

androidx.activity:activity:1.6.0-beta01 , androidx.activity:activity-compose:1.6.0-beta01 , and androidx.activity:activity-ktx:1.6.0-beta01 are released. Version 1.6.0-beta01 contains these commits.

تغییرات API

• Marked the deprecated startActivityForResult and startIntentSenderForResult methods on ComponentActivity with @NonNull because passing null has always resulted in a crash. ( Id2a25 , b/231476082 )

رفع اشکال

• From Activity 1.5.1 : The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch call throws any Exception and the callback was registered without a LifecycleOwner . ( Ia7ff7 , b/238350794 )
• From Activity 1.5.1 : ComponentActivity will now properly dispatch menu calls to onPrepareOptionMenu() , onCreateOptionsMenu() and onOptionsItemSelected() overrides without the need to call the super function. ( Ie33c5 , b/238057118 )

Dependency Update

• From Activity 1.5.1 : The Activity library now depends on the Lifecycle version 2.5.1 . ( If6697 )

Version 1.6.0-alpha05

15 ژوئن 2022

androidx.activity:activity:1.6.0-alpha05 , androidx.activity:activity-compose:1.6.0-alpha05 , and androidx.activity:activity-ktx:1.6.0-alpha05 are released. Version 1.6.0-alpha05 was developed in a private pre-release branch and has no public commits.

تغییرات API

• minCompileSdk is now 33 to align with Tiramisu Beta 3 SDK

رفع اشکال

• Fixed crash on older devices when doing SDK extension check for the PickVisualMedia ActivityResultContract so that it should now work with ACTION_OPEN_DOCUMENT on devices running Android 10 and lower.

Version 1.6.0-alpha04

18 مه 2022

androidx.activity:activity:1.6.0-alpha04 and androidx.activity:activity-ktx:1.6.0-alpha04 are released.

رفع اشکال

• Fixed an error in PickVisualMediaRequest where attempting to create a request, either via the Builder or the top level Kotlin function, would result in a stack overflow.
• Integrated the OnBackInvokedCallback in Android 13 Dev Beta 2 into the OnBackPressedDispatcher provided by ComponentDialog . This ensures that all APIs built on OnBackPressedDispatcher work when enabling a predictive back gesture .

Version 1.6.0-alpha03

27 آوریل 2022

androidx.activity:activity:1.6.0-alpha03 , androidx.activity:activity-compose:1.6.0-alpha03 , and androidx.activity:activity-ktx:1.6.0-alpha03 are released.

• Note: This version will only compile against the Android 13 Developer Beta 1 SDK.

ویژگی های جدید

• Added ActivityResultContracts.PickVisualMedia and ActivityResultContracts.PickMultipleVisualMedia for providing a backward compatible contract that uses MediaStore.ACTION_PICK_IMAGES when the Photo Picker is available and Intent.ACTION_OPEN_DOCUMENT when it is not available.
• Integrated the OnBackInvokedCallback in Android 13 Dev Beta 1 into the OnBackPressedDispatcher provided by ComponentActivity . This ensures that all APIs built on OnBackPressedDispatcher work when enabling a predictive back gesture .

Version 1.6.0-alpha01

23 مارس 2022

androidx.activity:activity:1.6.0-alpha01 , androidx.activity:activity-compose:1.6.0-alpha01 , and androidx.activity:activity-ktx:1.6.0-alpha01 are released.

• Note: This version will only compile against the Android 13 Developer Preview 2 SDK.

ویژگی های جدید

• Integrated changes in Android 13 Dev Preview 2 into ComponentActivity .

نسخه 1.5.1

نسخه 1.5.1

27 جولای 2022

androidx.activity:activity:1.5.1 , androidx.activity:activity-compose:1.5.1 , and androidx.activity:activity-ktx:1.5.1 are released. Version 1.5.1 contains these commits.

رفع اشکال

• The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch() call throws any Exception and the callback was registered without a LifecycleOwner . ( Ia7ff7 , b/238350794 )

• ComponentActivity will now properly dispatch menu calls to onPrepareOptionMenu() , onCreateOptionsMenu() and onOptionsItemSelected() overrides without the need to call the super function. ( Ie33c5 , b/238057118 )

به روز رسانی وابستگی

• The Activity library now depends on the Lifecycle 2.5.1 . ( If6697 )

نسخه 1.5.0

نسخه 1.5.0

29 ژوئن 2022

androidx.activity:activity:1.5.0 , androidx.activity:activity-compose:1.5.0 , and androidx.activity:activity-ktx:1.5.0 are released. Version 1.5.0 contains these commits.

Important changes since 1.4.0

• ComponentDialog - ComponentDialog is a subclass of Dialog that includes an OnBackPressedDispatcher that will be called when the system back button is pressed and the dialog is visible. Importantly, this subclass also sets the ViewTreeOnBackPressedDispatcherOwner , allowing views a generic way to retrieve the correct dispatcher whether it exists in a ComponentActivity or a ComponentDialog .
• Callback Interfaces - ComponentActivity now implements a set of modular callback interfaces that can be used instead of the Activity callbacks. These interfaces include the following: OnNewIntentProvider , OnConfigurationChangedProvider , OnTrimMemoryProvider , OnPictureInPictureModeChangedProvider , OnMultiWindowModeChangedProvider
• CreationExtras Integration - ComponentActivity now has the ability to provide a stateless ViewModelProvider.Factory via Lifecycle 2.5.0 's CreationExtras .

تغییرات دیگر

• The no parameter constructor for ActivityResultContracts.CreateDocument has been deprecated and replaced with a new constructor that takes a concrete mime type (eg, "image/png") as is required by Intent.ACTION_CREATE_DOCUMENT .

Version 1.5.0-rc01

11 مه 2022

androidx.activity:activity:1.5.0-rc01 , androidx.activity:activity-compose:1.5.0-rc01 , and androidx.activity:activity-ktx:1.5.0-rc01 are released with no changes from 1.5.0-beta01. Version 1.5.0-rc01 contains these commits.

Version 1.5.0-beta01

20 آوریل 2022

androidx.activity:activity:1.5.0-beta01 , androidx.activity:activity-compose:1.5.0-beta01 , and androidx.activity:activity-ktx:1.5.0-beta01 are released. Version 1.5.0-beta01 contains these commits.

Dependency updates

• Activity now depends on Lifecycle 2.4.0-beta01 .

Version 1.5.0-alpha05

6 آوریل 2022

androidx.activity:activity:1.5.0-alpha05 , androidx.activity:activity-compose:1.5.0-alpha05 , and androidx.activity:activity-ktx:1.5.0-alpha05 are released. Version 1.5.0-alpha05 contains these commits.

رفع اشکال

• ComponentActivity 's onPanelClosed() now calls the super onPanelClosed() as well, fixing an issue where the onContextMenuClosed method would not be called. ( Ib6f77 )

Version 1.5.0-alpha04

23 مارس 2022

androidx.activity:activity:1.5.0-alpha04 , androidx.activity:activity-compose:1.5.0-alpha04 , and androidx.activity:activity-ktx:1.5.0-alpha04 are released. Version 1.5.0-alpha04 contains these commits.

رفع اشکال

• SavedStateViewFactory now supports using CreationExtras even when it was initialized with a SavedStateRegistryOwner . If extras are provided, the initialized arguments are ignored. ( I6c43b , b/224844583 )

Version 1.5.0-alpha03

23 فوریه 2022

androidx.activity:activity:1.5.0-alpha03 , androidx.activity:activity-compose:1.5.0-alpha03 , and androidx.activity:activity-ktx:1.5.0-alpha03 are released. Version 1.5.0-alpha03 contains these commits.

تغییرات API

• You can now pass CreationExtras to the activity by viewModels() function ( I6a3e6 , b/217600303 )

Version 1.5.0-alpha02

9 فوریه 2022

androidx.activity:activity:1.5.0-alpha02 , androidx.activity:activity-compose:1.5.0-alpha02 , and androidx.activity:activity-ktx:1.5.0-alpha02 are released. Version 1.5.0-alpha02 contains these commits.

ویژگی های جدید

• ComponentActivity now implements the OnPictureInPictureModeChangedProvider interface to allow any component to receive picture-in-picture mode change events. ( I9f567 )
• ComponentActivity now implements the OnMultiWindowModeChangedProvider interface to allow any component to receive multi-window mode change events. ( I62d91 )

Version 1.5.0-alpha01

26 ژانویه 2022

androidx.activity:activity:1.5.0-alpha01 , androidx.activity:activity-compose:1.5.0-alpha01 , and androidx.activity:activity-ktx:1.5.0-alpha01 are released. Version 1.5.0-alpha01 contains these commits.

ویژگی های جدید

• ComponentActivity now integrates with ViewModel CreationExtras, introduced as part of Lifecycle 2.5.0-alpha01 . ( Ie7e00 , b/207012584 )
• Added ComponentDialog , a subclass of Dialog that includes an OnBackPressedDispatcher that will be called when the system back button is pressed when the dialog is visible. Importantly, this subclass also sets the ViewTreeOnBackPressedDispatcherOwner , allowing views a generic way to retrieve the correct dispatcher whether it exists in a ComponentActivity or a ComponentDialog . ( I8a1bc )
• ComponentActivity now implements the new OnNewIntentProvider interface to allow any component to receive these events. ( If1f8b )
• ComponentActivity now implements the new OnConfigurationChangedProvider interface to allow any component to receive these events. ( If623b )
• ComponentActivity now implements the new OnTrimMemoryProvider interface to allow any component to receive these events. ( Ia9295 )

تغییرات API

• The no parameter constructor for ActivityResultContracts.CreateDocument has been deprecated and replaced with a new constructor that takes a concrete mime type (eg, "image/png" ) as is required by Intent.ACTION_CREATE_DOCUMENT . ( I2bec6 )
• The OnBackPressedDispatcherOwner associated with a View can now be retrieved via the ViewTreeOnBackPressedDispatcherOwner , rather than relying on casting the Context . ( I74685 )

رفع اشکال

• Fixed a crash when accessing a ViewModel for the very first time from a registerForActivityResult() callback or the callbacks to a LifecycleObserver added as part of init of a ComponentActivity . ( Ife83f )

نسخه 1.4.0

نسخه 1.4.0

27 اکتبر 2021

androidx.activity:activity:1.4.0 , androidx.activity:activity-compose:1.4.0 , and androidx.activity:activity-ktx:1.4.0 are released. Version 1.4.0 contains these commits.

Important changes since 1.3.0

• AndroidX ComponentActivity now implements the MenuHost interface. This allows any component to add menu items to the ActionBar by adding a MenuProvider instance to the activity. Each MenuProvider can optionally be added with a Lifecycle that will automatically control the visibility of those menu items based on the Lifecycle state and handle the removal of the MenuProvider when the Lifecycle is destroyed.
• The ActivityResultContract class has been rewritten in Kotlin to ensure that developers writing custom contracts in Kotlin can define the correct nullability for their input and output classes.
• The ActivityResultContracts class and its contracts have been rewritten in Kotlin to ensure the proper nullability.

Version 1.4.0-rc01

13 اکتبر 2021

androidx.activity:activity:1.4.0-rc01 , androidx.activity:activity-compose:1.4.0-rc01 , and androidx.activity:activity-ktx:1.4.0-rc01 are released. Version 1.4.0-rc01 contains these commits.

رفع اشکال

• The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch call throws any Exception . ( If4f91 , b/200845664 )

Version 1.4.0-beta01

29 سپتامبر 2021

androidx.activity:activity:1.4.0-beta01 , androidx.activity:activity-compose:1.4.0-beta01 , and androidx.activity:activity-ktx:1.4.0-beta01 are released. Version 1.4.0-beta01 contains these commits.

تغییرات API

• Fixed the type for the ActivityResultContracts.OpenMultipleDocuments and ActivityResultContracts.GetMultipleContents that caused then to use an output type of List<? extends Uri> when using the code from the Java programming language. ( If71de )
• Public constants within the ActivityResultContracts.StartActivityForResult , ActivityResultContracts.StartIntentSenderForResult , and ActivityResultContracts.RequestMultiplePermissions classes are now accessible when using Kotlin via their now public Companion objects. ( aosp/1832555 )

به روز رسانی اسناد

• The deprecation message for APIs now handled by the Activity Result APIs , namely startActivityForResult , startIntentSenderForResult , onActivityResult , requestPermissions , and onRequestPermissionsResult , have all been expanded with more details. ( cce80f )

Version 1.4.0-alpha02

15 سپتامبر 2021

androidx.activity:activity:1.4.0-alpha02 , androidx.activity:activity-compose:1.4.0-alpha02 , and androidx.activity:activity-ktx:1.4.0-alpha02 are released. Version 1.4.0-alpha02 contains these commits.

ویژگی های جدید

• The activity-compose artifact now contains a LaunchDuringComposition lint error that prevents you from calling the launch method of ActivityResultLauncher as part of composition as composition should be side-effect free. Use the APIs for handling side-effects . ( 7c2bbe , b/191347220 )

تغییرات API

• The ActivityResultContract class has been rewritten in Kotlin to ensure that developers writing custom contracts in Kotlin can define the correct nullability for their input and output classes. ( I8a8f5 )
• The ActivityResultContracts class and its contracts have been rewritten in Kotlin to ensure the proper nullability. ( I69802 )

Version 1.4.0-alpha01

1 سپتامبر 2021

androidx.activity:activity:1.4.0-alpha01 , androidx.activity:activity-compose:1.4.0-alpha01 , and androidx.activity:activity-ktx:1.4.0-alpha01 are released. Version 1.4.0-alpha01 contains these commits.

ویژگی های جدید

• AndroidX ComponentActivity now implements the MenuHost interface.. This allows any component to add menu items to the ActionBar by adding a MenuProvider instance to the activity. Each MenuProvider can optionally be added with a Lifecycle that will automatically control the visibility of those menu items based on the Lifecycle state and handle the removal of the MenuProvider when the Lifecycle is destroyed. ( 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)
  }

تغییرات رفتار

• The ActivityResultRegistry will now throw an IllegalStateException when attempting to call launch() on an ActivityResultLauncher that has not be registered or that has been unregistered. ( Ida75d , b/192567522 )

External Contribution

• Thanks dmitrilc for fixing a typo in the ActivityResult documentation. ( #221 )

نسخه 1.3.1

نسخه 1.3.1

4 آگوست 2021

androidx.activity:activity:1.3.1 , androidx.activity:activity-compose:1.3.1 , and androidx.activity:activity-ktx:1.3.1 are released. Version 1.3.1 contains these commits.

Dependency updates

• Activity now depends on Kotlin 1.5.21 .
• Activity Compose now depends on Compose 1.0.1 .

Version 1.3.0

Version 1.3.0

28 ژوئیه 2021

androidx.activity:activity:1.3.0 , androidx.activity:activity-compose:1.3.0 , and androidx.activity:activity-ktx:1.3.0 are released. Version 1.3.0 contains these commits.

Important changes since 1.2.0

• Activity Compose artifact - The activity-compose artifact provides the setContent extension method for hosting your Jetpack Compose UI in an activity and Compose specific wrappers for interacting with the ComponentActivity APIs for handling the system back button and the Activity Result APIs. برای جزئیات بیشتر به مستندات مراجعه کنید.
• CaptureVideo contract - The CaptureVideo ActivityResultContract replaces the now deprecated TakeVideo contract and returns a boolean denoting success that works across many camera apps.
• Picture-In-Picture Hint View Tracking - Users of activity-ktx can now use the trackPipAnimationHintView extension method on Activity to automatically rebuild the PictureInPictureParams with the new position of the view as it changes position relative to the window.

Version 1.3.0-rc02

14 جولای 2021

androidx.activity:activity:1.3.0-rc02 , androidx.activity:activity-compose:1.3.0-rc02 , and androidx.activity:activity-ktx:1.3.0-rc02 are released. Version 1.3.0-rc02 contains these commits.

رفع اشکال

• The ActivityResultRegistry callbacks are now properly saved and restored so callbacks are not duplicated in the savedState. ( I97816 , b/191893160 )

Version 1.3.0-rc01

1 ژوئیه 2021

androidx.activity:activity:1.3.0-rc01 , androidx.activity:activity-compose:1.3.0-rc01 , and androidx.activity:activity-ktx:1.3.0-rc01 are released with no changes from 1.3.0-beta02 . Version 1.3.0-rc01 contains these commits.

Version 1.3.0-beta02

16 ژوئن 2021

androidx.activity:activity:1.3.0-beta02 , androidx.activity:activity-compose:1.3.0-beta02 , and androidx.activity:activity-ktx:1.3.0-beta02 are released. Version 1.3.0-beta02 contains these commits.

Updated activity-compose to depend on Compose 1.0.0-beta09 . androidx.compose.ui:ui-test-junit4 now has a compile time dependency on activity-compose .

Version 1.3.0-beta01

2 ژوئن 2021

androidx.activity:activity:1.3.0-beta01 , androidx.activity:activity-compose:1.3.0-beta01 , and androidx.activity:activity-ktx:1.3.0-beta01 are released. Version 1.3.0-beta01 contains these commits.

تغییرات API

• The previously deprecated @Composable registerForActivityResult() method has been removed. Please use rememberLauncherForActivityResult() . ( Ic39d3 )

Version 1.3.0-alpha08

18 مه 2021

androidx.activity:activity:1.3.0-alpha08 , androidx.activity:activity-compose:1.3.0-alpha08 , and androidx.activity:activity-ktx:1.3.0-alpha08 are released. Version 1.3.0-alpha08 contains these commits.

ویژگی های جدید

• The new CaptureVideo ActivityResultContract returns a boolean to your ActivityResultCallback indicating if your video was successfully saved to the given URI. This replaces the now deprecated TakeVideo contract as camera apps very rarely supported returning a thumbnail bitmap, making the result unhelpful. ( Ie21f2 , b/185938070 )
• Added new API Activity#setPipAnimationHintView to update the PipParams' source rect hint whenever the view moves. ( I9063d )

تغییرات API

• The rememberLauncherForActivityResult function now returns a launcher that deprecates the unregister() function - registration and unregistering the launcher is handled automatically by rememberLauncherForActivityResult . ( I2443e )

Compose Compatibility

• androidx.activity:activity-compose:1.3.0-alpha08 is only compatible with Compose version 1.0.0-beta07 and above.

Version 1.3.0-alpha07

21 آوریل 2021

androidx.activity:activity:1.3.0-alpha07 , androidx.activity:activity-compose:1.3.0-alpha07 , and androidx.activity:activity-ktx:1.3.0-alpha07 are released. Version 1.3.0-alpha07 contains these commits.

رفع اشکال

• rememberLauncherForActivityResult now returns a stable reference to the same ActivityResultLauncher instance even if the contract changes due to recompositions. ( Id2d6d )
• Using unstable versions of Fragments above 1.3.0 will no longer throw a false positive lint error telling you to use 1.3.0 . ( aosp/1670206 , b/184847092 )

Version 1.3.0-alpha06

7 آوریل 2021

androidx.activity:activity:1.3.0-alpha06 , androidx.activity:activity-compose:1.3.0-alpha06 , and androidx.activity:activity-ktx:1.3.0-alpha06 are released. Version 1.3.0-alpha06 contains these commits.

تغییرات API

• The registerForActivityResult() API has been renamed to rememberLauncherForActivityResult() to better indicate that the returned ActivityResultLauncher is a managed object that is remembered on your behalf. Attempting to call unregister the returned ActivityResultLauncher will now throw an error. ( I2bb6d )
• LocalOnBackPressedDispatcherOwner.current and LocalActivityResultRegistryOwner.current now return a nullable value to better determine whether it is available in the current composition. APIs that requires those APIs, such as BackHandler and rememberLauncherForActivityResult() , respectively, will now throw a more descriptive error if the underlying owner is not found. NavHost now works even when an OnBackPressedDispatcherOwner is not found, such is the case when previewing the NavHost . ( I7d8b4 )

رفع اشکال

• The BackHandler will now properly intercept back presses in the event that the Activity is STOPPED , then STARTED again, and other callbacks were added with a LifecycleOwner. ( I71de6 , b/182284739 )
• Using the launch() method extension with a custom ActivityResultContract that has a Unit input will no longer cause a NullPointerException ( I76282 , b/183837954 )

Version 1.3.0-alpha05

24 مارس 2021

androidx.activity:activity:1.3.0-alpha05 , androidx.activity:activity-compose:1.3.0-alpha05 , and androidx.activity:activity-ktx:1.3.0-alpha05 are released. Version 1.3.0-alpha05 contains these commits.

رفع اشکال

• From Activity 1.2.2 : Fixed an issue in the InvalidFragmentVersionForActivityResult lint check that led to a false positive when using Fragment 1.3.1 or higher. ( I54da1 , b/182388985 )
• From Activity 1.2.2 : ComponentActivity now avoids a ClassNotFoundException when launching an Intent from an ActivityResultContract that was previously held as an extra in another Intent . ( Ieff05 , b/182906230 )

Dependency Updates

• From Activity 1.2.2 : Activity now depends on Lifecycle 2.3.1 .

Version 1.3.0-alpha04

10 مارس 2021

androidx.activity:activity:1.3.0-alpha04 , androidx.activity:activity-compose:1.3.0-alpha04 , and androidx.activity:activity-ktx:1.3.0-alpha04 are released. Version 1.3.0-alpha04 contains these commits.

رفع اشکال

• From Activity 1.2.1 : RequestMultiplePermissions now always returns results for all requested permissions instead of only permissions that weren't previously granted. ( I50bc3 , b/180884668 )
• From Activity 1.2.1 : ActivityResultRegistry now ensures that in progress launch() requests will return their results even if you unregister() , then register() again with the same key. ( I9ef34 , b/181267562 )
• Activity Compose no longer adds test dependencies to the runtime classpath. ( Ifd8b3 )
• Fixed an issue with BackHandler where the previously set onBack lambda was still being used after recomposition. ( 8eb5eb )

Version 1.3.0-alpha03

24 فوریه 2021

androidx.activity:activity:1.3.0-alpha03 , androidx.activity:activity-compose:1.3.0-alpha03 , and androidx.activity:activity-ktx:1.3.0-alpha03 are released. Version 1.3.0-alpha03 contains these commits.

ویژگی های جدید

• There is a now a Composable registerForActivityResult function for getting results from activities within composables. ( Ia7851 , b/172690553 )

تغییرات API

• LocalOnBackPressedDispatcherOwner now has a provides functions that can be used with CompositionLocalProvider , replacing the asProvidableCompositionLocal() API. ( I45d24 )

Version 1.3.0-alpha02

10 فوریه 2021

androidx.activity:activity:1.3.0-alpha02 , androidx.activity:activity-compose:1.3.0-alpha02 , and androidx.activity:activity-ktx:1.3.0-alpha02 are released. Version 1.3.0-alpha02 contains these commits.

رفع اشکال

• Fixed an issue in Activity Compose 1.3.0-alpha01 that causes a NoSuchMethodError: No static method setContent exception when using Compose 1.0.0-alpha12 . All Compose users should depend on 1.3.0-alpha02 and above. ( b/179911234 )

تغییرات API

• The BackHandler API can be used to allow a Composable to intercept the system back button. ( I58ed5 , b/172154006 )

Version 1.3.0-alpha01

10 فوریه 2021

androidx.activity:activity:1.3.0-alpha01 , androidx.activity:activity-compose:1.3.0-alpha01 , and androidx.activity:activity-ktx:1.3.0-alpha01 are released. Version 1.3.0-alpha01 contains these commits.

ویژگی های جدید

• The new activity-compose artifact provides Jetpack Compose specific helpers for androidx.activity specific APIs.
  • ComponentActivity.setContent has moved from androidx.compose.ui.platform.setContent to androidx.activity.compose.setContent . ( Icf416 )

مسائل شناخته شده

• Using Activity Compose 1.3.0-alpha01 and libraries that depend on it, such as androidx.compose.ui:ui-test-junit4:1.0.0-alpha12 , will result in a NoSuchMethodError: No static method setContent exception. ( b/179911234 )

نسخه 1.2.4

نسخه 1.2.4

21 جولای 2021

androidx.activity:activity:1.2.4 and androidx.activity:activity-ktx:1.2.4 are released. Version 1.2.4 contains these commits.

رفع اشکال

• From Activity 1.3.0-rc02 : The ActivityResultRegistry callbacks are now properly saved and restored so callbacks are not duplicated in the savedState. ( I97816 , b/191893160 )

Version 1.2.3

Version 1.2.3

5 مه 2021

androidx.activity:activity:1.2.3 and androidx.activity:activity-ktx:1.2.3 are released. Version 1.2.3 contains these commits.

رفع اشکال

• Using the launch() method extension with a custom ActivityResultContract that has a Unit input will no longer cause a NullPointerException ( I76282 , b/183837954 )
• Fixed a false positive lint error telling you to use Fragment 1.3.0 when using an snapshot, alpha, beta, or RC build of a newer version of Fragments. ( f4a57e , b/184847092 )

نسخه 1.2.2

نسخه 1.2.2

24 مارس 2021

androidx.activity:activity:1.2.2 and androidx.activity:activity-ktx:1.2.2 are released. Version 1.2.2 contains these commits.

رفع اشکال

• Fixed an issue in the InvalidFragmentVersionForActivityResult lint check that led to a false positive when using Fragment 1.3.1 or higher. ( I54da1 , b/182388985 )
• ComponentActivity now avoids a ClassNotFoundException when launching an Intent from an ActivityResultContract that was previously held as an extra in another Intent . ( Ieff05 , b/182906230 )

Dependency Updates

• Activity now depends on Lifecycle 2.3.1 .

نسخه 1.2.1

نسخه 1.2.1

10 مارس 2021

androidx.activity:activity:1.2.1 and androidx.activity:activity-ktx:1.2.1 are released. Version 1.2.1 contains these commits.

رفع اشکال

• RequestMultiplePermissions now always returns results for all requested permissions instead of only permissions that weren't previously granted. ( I50bc3 , b/180884668 )
• ActivityResultRegistry now ensures that in progress launch() requests will return their results even if you unregister() , then register() again with the same key. ( I9ef34 , b/181267562 )

نسخه 1.2.0

نسخه 1.2.0

10 فوریه 2021

androidx.activity:activity:1.2.0 and androidx.activity:activity-ktx:1.2.0 are released. Version 1.2.0 contains these commits.

Major changes since 1.1.0

• Activity Result APIs : ComponentActivity now provides an ActivityResultRegistry that lets you handle startActivityForResult() + onActivityResult() as well as requestPermissions() + onRequestPermissionsResult() flows without overriding methods in your Activity or Fragment, brings increased type safety via ActivityResultContract , and provides hooks for testing these flows. See the updated Getting a Result from an Activity .

• ContextAware : ComponentActivity now implements ContextAware , allowing you to add one or more OnContextAvailableListener instances which will receive a callback before the base Activity.onCreate() .

  • A suspending Kotlin extension withContextAvailable() allows you to run a non-suspending block when the Context becomes available and return a result.
  • This API is used by FragmentActivity in Fragment 1.3.0 to restore the state of the FragmentManager . Any listeners added to subclasses of FragmentActivity will run after that listener.
  • This API is used by AppCompatActivity in AppCompat 1.3.0-alpha02 or higher. Any listeners added to subclasses of AppCompatActivity will run after that listener.

• ViewTree Support : ComponentActivity now supports the ViewTreeLifecycleOwner.get(View) , ViewTreeViewModelStoreOwner.get(View) , and ViewTreeSavedStateRegistryOwner APIs added in Lifecycle 2.3.0 and SavedState 1.1.0 such that it will return the Activity as the LifecycleOwner , ViewModelStoreOwner , and SavedStateRegistryOwner for any Views directly added to the ComponentActivity .

• reportFullyDrawn() backport - The Activity method of reportFullyDrawn() has been backported in ComponentActivity to work on all API levels, fixing a crash on API 19 and adding tracing for this method for all API levels.

Version 1.2.0-rc01

16 دسامبر 2020

androidx.activity:activity:1.2.0-rc01 and androidx.activity:activity-ktx:1.2.0-rc01 are released. Version 1.2.0-rc01 contains these commits.

رفع اشکال

• The ActivityResultRegistry now always restores the exact state that was saved. ( Idd56b )
• Add tracing to ComponentActivity.reportFullyDrawn ( Ic7632 )

External Contribution

• ComponentActivity now overrides reportFullyDrawn() , allowing it to be called on all API levels and fixing a crash when calling this method without the appropriate system permission on API 19 devices. Thanks Simon Schiller! ( b/163239764 , #103 )

Version 1.2.0-beta02

2 دسامبر 2020

androidx.activity:activity:1.2.0-beta02 and androidx.activity:activity-ktx:1.2.0-beta02 are released. Version 1.2.0-beta02 contains these commits.

رفع اشکال

• Fixed an issue where the Activity Result API would not wait for the Lifecycle to be STARTED before delivering results when registered with a Lifecycle . ( I109ea )

External Contribution

• Updated the documentation for launch() to explicitly call out that it can throw an ActivityNotFoundException . Thanks Michał Zieliński! ( aosp/1493580 )

Version 1.2.0-beta01

1 اکتبر 2020

androidx.activity:activity:1.2.0-beta01 and androidx.activity:activity-ktx:1.2.0-beta01 are released. Version 1.2.0-beta01 contains these commits.

رفع اشکال

• The ActivityResultRegistry now randomly generates integers until it finds one that is unallocated to use as a request code register() , thus preventing the possible integer overflow caused by incrementing request codes. ( b/168779518 )

• Lifecycle observers are properly removed when calling unregister() on an ActivityResultLauncher . ( b/165608393 )

تغییرات رفتار

• The ActivityResultRegistry now throws an IllegalStateException when attempting to call register() with a LifecycleOwner whose Lifecycle has already reached STARTED . ( b/165435866 )

اسناد به روز شد

• ContextAware documentation links to LifecycleOwner to highlight Lifecycle callbacks as the appropriate place for creation and destruction events. ( aosp/1414152 )

Version 1.2.0-alpha08

19 آگوست 2020

androidx.activity:activity:1.2.0-alpha08 and androidx.activity:activity-ktx:1.2.0-alpha08 are released. Version 1.2.0-alpha08 contains these commits.

ویژگی های جدید

• ComponentActivity now implements ContextAware , allowing you to add one or more OnContextAvailableListener instances which will receive a callback before the base Activity.onCreate() . ( b/161390636 )
  • A suspending Kotlin extension withContextAvailable() allows you to run a non-suspending block when the Context becomes available and return a result. ( I8290c )
  • This API is used by FragmentActivity in Fragment 1.3.0-alpha08 to restore the state of the FragmentManager . Any listeners added to subclasses of FragmentActivity will run after that listener. ( I513da )
  • This API is used by AppCompatActivity in AppCompat 1.3.0-alpha02 . Any listeners added to subclasses of AppCompatActivity will run after that listener. ( I513da )

رفع اشکال

• Fixed an issue with the ActivityResultFragmentVersionDetector Lint check that caused it to break when using Lint 27.1.0 or higher. ( b/162155191 )

Version 1.2.0-alpha07

July 22, 2020

androidx.activity:activity:1.2.0-alpha07 and androidx.activity:activity-ktx:1.2.0-alpha07 are released. Version 1.2.0-alpha07 contains these commits.

ویژگی های جدید

• Added a new InvalidFragmentVersionForActivityResult lint check that verifies that you are using Fragment 1.3.0-alpha07 when using the Activity Result API , avoiding runtime crashes due to “invalid request code” issues and non-functioning permission requests caused by using older versions of Fragments. ( b/152554847 )

External Contribution

• Fixed an ArrayIndexOutOfBoundsException when parsing the results for the RequestPermission Activity Result contract. ( I8f9e3 , b/161057605 )

Version 1.2.0-alpha06

10 ژوئن 2020

androidx.activity:activity:1.2.0-alpha06 and androidx.activity:activity-ktx:1.2.0-alpha06 are released. Version 1.2.0-alpha06 contains these commits.

ویژگی های جدید

• You can now destructure the ActivityResult class in kotlin to directly access the requestCode and intent . ( b/157212935 )
• ActivityResultLauncher now allows you to get the ActivityResultContract that was used to register the launcher. ( b/156875743 )

تغییرات API

• Breaking change : The invoke() method on ActivityResultRegistry has been renamed to onLaunch() . ( b/157496491 )
• The OpenMultipleDocuments contract now returns an empty list instead of null to the registered callback if no result is returned. ( b/157348014 )

Version 1.2.0-alpha05

20 مه 2020

androidx.activity:activity:1.2.0-alpha05 and androidx.activity:activity-ktx:1.2.0-alpha05 are released. Version 1.2.0-alpha05 contains these commits.

ویژگی های جدید

• Added support for ViewTreeViewModelStoreOwner from Lifecycle 2.3.0-alpha03 , and ViewTreeSavedStateRegistryOwner from SavedState 1.1.0-alpha01 when using a View within a ComponentActivity . ( aosp/1297993 , aosp/1300264 )

تغییرات API

• The TakePicture contract now returns a boolean indicating success rather than a thumbnail Bitmap as this was very rarely supported by camera apps when writing the image to the provided Uri . ( b/154302879 )
• The invoke() extensions on ActivityResultLauncher have been removed in favor of explicitly using launch() to better indicate that these are asynchronous operations. Kotlin extensions for launch have been added to the androidx.activity.result package for ActivityResultLauncher<Void> and ActivityResultLauncher<Unit> that remove the need to pass in null or Unit , respectively, mirroring that behavior from the previously invoke() extensions. ( aosp/1304674 , aosp/1304675 )
• The IntentSenderRequest.Builder methods for setFlagsMask() and setFlagsValues() has been combined into a single setFlags() method. ( aosp/1302111 )

رفع اشکال

• When registering an ActivityResultCallback with a LifecycleOwner , fixed an issue where the callback would be triggered before the state reaches STARTED . ( aosp/1309744 )

تغییرات رفتار

• The ActivityResultRegistry now generates request codes starting at 0xFFFF rather than at 0 , preventing overlap when using startActivityForResult() or requestPermissions() in an activity. ( aosp/1302324 )

Version 1.2.0-alpha04

29 آوریل 2020

androidx.activity:activity:1.2.0-alpha04 and androidx.activity:activity-ktx:1.2.0-alpha04 are released. Version 1.2.0-alpha04 contains these commits.

ویژگی های جدید

• Added a contract that can call startIntentSenderForResult to the ActivityResult APIs. ( b/153007517 )

تغییرات API

• The prepareCall() method has been renamed to registerForActivityResult() , both on ComponentActivity here and in Fragment 1.3.0-alpha04 . ( aosp/1278717 )
• The GetContents , OpenDocuments , and RequestPermissions contracts have been renamed to GetMultipleContents , OpenMultipleDocuments , and RequestMultiplePermissions , respectively. ( aosp/1280161 )
• ComponentActivity now implements the ActivityResultRegisteryOwner interface. ( aosp/1290888 )
• - The startActivityForResult() / onActivityResult() and onRequestPermissionsResult() APIs on ComponentActivity have been deprecated. Please use the Activity Result APIs . ( b/154751887 )

رفع اشکال

• When using the GetMultipleContents and OpenMultipleDocuments contracts and selecting a single item, it is now correctly returned to your callback. ( b/152941153 )

Version 1.2.0-alpha03

1 آوریل 2020

androidx.activity:activity:1.2.0-alpha03 and androidx.activity:activity-ktx:1.2.0-alpha03 are released. Version 1.2.0-alpha03 contains these commits.

ویژگی های جدید

• Added the TakeVideo , PickContact , GetContent , GetContents , OpenDocument , OpenDocuments , OpenDocumentTree , and CreateDocument contracts to the set of pre-built contracts provided by ActivityResultContracts . ( aosp/1262482 , aosp/1266916 , aosp/1268960 )
• The Activity Result APIs now support launching an activity for result with an optional ActivityOptionsCompat . ( b/151860054 )

تغییرات API

• The TakePicture contract now takes a Uri input for where the image should be stored. The previous contract that does not take any input has been renamed to TakePicturePreview . ( aosp/1262482 )
• The registerActivityResultCallback() method on ActivityResultRegistry has been renamed to register() . ( aosp/1267621 )
• The dispose() method on ActivityResultLauncher has been renamed to unregister() and the unregisterResultCallback() on ActivityResultRegistry has been removed. ( aosp/1267621 )
• The createIntent() method of ActivityResultContact now takes a Context in addition to the input to make it possible to create explicit Intents. ( aosp/1238800 )
• An ActivityResultContract can now override getSynchronousResult() to deliver a result without calling startActivityForResult . This is used by the RequestPermission and RequestPermissions contracts to correctly deliver a 'granted' status if the requested permissions are already granted. ( b/151110799 )
• The previously available Dial contract has been removed as that Intent is not meant to be used with startActivityForResult() . ( aosp/1266916 )
• Many of the Activity Result APIs not meant to be extended are now final . This includes getActivityResultRegistry() , the prepareCall() methods, all methods of ActivityResultRegistry except invoke() , and a number of the default contracts that do not support optional extras. ( b/152439361 )

رفع اشکال

• Fixed a NullPointerException in ActivityResultRegistry when attempting to deliver results to a callback that has not yet been re-registered after a configuration change; ActivityResultRegistry now holds onto these pending results and delivers them when the callback is re-registered. ( b/152137004 )

Version 1.2.0-alpha02

18 مارس 2020

androidx.activity:activity:1.2.0-alpha02 and androidx.activity:activity-ktx:1.2.0-alpha02 are released. Version 1.2.0-alpha02 contains these commits.

ویژگی های جدید

• ActivityResultRegistry : ComponentActivity now provides an ActivityResultRegistry that lets you handle the startActivityForResult() + onActivityResult() as well as requestPermissions() + onRequestPermissionsResult() flows without overriding methods in your Activity or Fragment, brings increased type safety via ActivityResultContract , 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 Lifecycle 2.3.0-alpha01 such that it will return the Activity as the LifecycleOwner 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 where onBackPressed() would cause an IllegalStateException due to a bug in the android.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 using by viewModels() , the ViewModelProvider constructor, or ViewModelProviders.of() with a ComponentActivity 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 .

Dependency changes

• Activity now depends on Lifecycle 2.2.0-rc03 and Lifecycle ViewModel SavedState 1.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 .

Dependency changes

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

Dependency changes

• 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. The commits included in this version can be found here .

ویژگی های جدید

• Activity now depends on Core 1.1.0 stable.

رفع اشکال

• Activity now depends on Lifecycle 2.2.0-alpha04 .

Version 1.1.0-alpha02

7 آگوست 2019

androidx.activity:activity:1.1.0-alpha02 and androidx.activity:activity-ktx:1.1.0-alpha02 are released. The commits included in this version can be found here .

ویژگی های جدید

• SavedStateViewModelFactory is now the default factory used when using by viewModels() , the ViewModelProvider constructor, or ViewModelProviders.of() with a ComponentActivity ( 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. The commits included in this version can be found here .

ویژگی های جدید

• activity now depends on Lifecycle 2.2.0-alpha02 . ( aosp/1007817 )
• activity-ktx added a dependency on lifecycle-runtime-ktx ; you no longer need to explicitly add it to your dependencies when using activity-ktx or libraries that depend on activity-ktx (such as fragment-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. The commits included in this version can be found here .

Major Features of 1.0.0

• ComponentActivity : ComponentActivity serves as the new base class for FragmentActivity in Fragment 1.1.0 and, by extension, AppCompatActivity in AppCompat 1.1.0 .
• activity-ktx : The activity-ktx module includes a by viewModels Kotlin property extension for accessing ViewModels. This module is automatically included when you include fragment-ktx from Fragment 1.1.0 .
• OnBackPressedDispatcher : As a composable alternative to overriding onBackPressed() , you can now register a OnBackPressedCallback from any LifecycleOwner (such as a fragment) to intercept system back button events. A lambda with receiver version addCallback has been added to activity-ktx . See Provide custom back navigation documentation for more details.
• onRetainCustomNonConfigurationInstance deprecation : the onRetainCustomNonConfigurationInstance() and the related getLastCustomNonConfigurationInstance() APIs have been deprecated. It is strongly recommended to use ViewModels to store non-configuration state as they offer a composable solution suitable for any ViewModelStoreOwner that makes the ownership of the retained objects clear and provides an onCleared() callback for cleaning up resources when the activity is finally destroyed.

Version 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 . The commits included in this version can be found here .

Version 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 . The commits included in this version can be found here .

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. The commits included in this version can be found here .

API changes

• Breaking change: The previously deprecated addOnBackPressedCallback and removeOnBackPressedCallback methods on ComponentActivity have been removed. aosp/953857
• The setEnabled() and isEnabled() methods of OnBackPressedCallback are now final. b/131416833
• The remove() method of OnBackPressedCallback is now final. aosp/952720
• OnBackPressedDispatcher now has public constructors, allowing you to construct your own instances for testing, etc. aosp/953431
• onBackPressed() for ComponentActivity is now explicitly marked as @MainThread aosp/952721

رفع اشکال

• Fixed a ConcurrentModificationException when calling remove() from within the handleOnBackPressed() method of a OnBackPressedCalback that was added with a LifecycleOwner . b/131765095

Version 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. The commits included in this version can be found here .

API changes

This release makes significant changes to the handling of the onBackPressed() . See the updated custom back documentation for more details.

• The methods for OnBackPressedCallback and OnBackPressedDispatcher have been marked as @MainThread . ( aosp/943813 )
• The handleOnBackPressed() method no longer returns a boolean . Instead, OnBackPressedCallback is now an abstract class that can be enabled or disabled - only when the new isEnabled() method returns true will handleOnBackPressed() be called, in which you must handle the back button. ( aosp/944518 )
• The addCallback methods of OnBackPressedDispatcher no longer return a Cancellable instance. OnBackPressedCallback now contain a remove() method that fulfill this functionality, allowing you to call remove() during handleOnBackPressed() . ( aosp/944519 ) ( aosp/946316 )
• activity-ktx now contains a receiver scoped callback for addCallback that accepts a lamdba that implements handleOnBackPressed() and has access to isEnabled and remove() ( aosp/944520 )

Version 1.0.0-alpha06

3 آوریل 2019

androidx.activity:activity:1.0.0-alpha06 and androidx.activity:activity-ktx:1.0.0-alpha06 are released. The commits included in this version can be found here .

API changes

• 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 new OnBackPressedDispatcher , retrievable via getOnBackPressedDispatcher() . ( aosp/922523 )
• Methods to add a new OnBackPressedCallback to the OnBackPressedDispatcher now return a Cancellable object, allowing removal of the callback without requiring an explicit reference to the OnBackPressedDispatcher . ( aosp/922523 )
• Adding a OnBackPressedCallback with an associated LifecycleOwner now results in adding and removing the OnBackPressedCallback as the Lifecycle is started and stopped, respectively. ( aosp/922523 )

Version 1.0.0-alpha05

13 مارس 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 )

Version 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 using setContentView() . ( aosp/837619 )

API changes

• 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 the activity-ktx module's dependency.

Version 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 changes

• Added a note that getLifecycle() 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/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 via addOnBackPressedCallback to receive onBackPressed() callbacks without needing to override the method in your activity.
• Added a new by viewModels() Kotlin property delegate for retrieving ViewModel s from a ComponentActivity .
• Pending input events (such as clicks) are now canceled in onStop() .

API changes

• The implementation of LifecycleOwner and ViewModelStoreOwner have been moved from FragmentActivity to ComponentActivity .
• onRetainCustomNonConfigurationInstance has been deprecated. Use a ViewModel for storing objects that need to survive configuration changes.

فعالیت

اعلام وابستگی ها

To add a dependency on Activity, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

dependencies {
    def activity_version = "1.10.1"

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

dependencies {
    val activity_version = "1.10.1"

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

For more information about dependencies, see Add build dependencies .

بازخورد

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

یک شماره جدید ایجاد کنید

See the Issue Tracker documentation for more information.

نسخه 1.11

Version 1.11.0-beta01

9 آوریل 2025

androidx.activity:activity:1.11.0-beta01 , androidx.activity:activity-compose:1.11.0-beta01 , and androidx.activity:activity-ktx:1.11.0-beta01 are released. Version 1.11.0-beta01 contains these commits .

Version 1.11.0-alpha02

26 مارس 2025

androidx.activity:activity:1.11.0-alpha02 , androidx.activity:activity-compose:1.11.0-alpha02 , and androidx.activity:activity-ktx:1.11.0-alpha02 are released. Version 1.11.0-alpha02 contains these commits .

تغییرات API

• Integrated the new EDGE_NONE and frameTimeMillis from Android 16 Beta03 into the BackEventCompat provided by OnBackPressedCallback 's handleOnBackStarted and handleOnBackProgressed functions.

Dependency Updates

• Activity is now compiled with API 36. ( I510e8 , b/301910674 )

Version 1.11.0-alpha01

12 مارس 2025

androidx.activity:activity:1.11.0-alpha01 , androidx.activity:activity-compose:1.11.0-alpha01 , and androidx.activity:activity-ktx:1.11.0-alpha01 are released. Version 1.11.0-alpha01 contains these commits .

ویژگی های جدید

• Added MediaCapabilities API to PickVisualMediaRequest to let applications specify its media capabilities, such as supported HDR Types. ( Ic3ee7 )

نسخه 1.10

نسخه 1.10.1

26 فوریه 2025

androidx.activity:activity:1.10.1 , androidx.activity:activity-compose:1.10.1 , and androidx.activity:activity-ktx:1.10.1 are released. Version 1.10.1 contains these commits .

رفع اشکال

• ViewTree OnBackPressedDispatcherOwners and FullyDrawnReporterOwners can now be resolved through disjoint parents of a view, such as a ViewOverlay . See the release notes of core or the documentation in ViewTree.setViewTreeDisjointParent for more information on disjoint view parents. ( Ie7750 )

نسخه 1.10.0

15 ژانویه 2025

androidx.activity:activity:1.10.0 , androidx.activity:activity-compose:1.10.0 , and androidx.activity:activity-ktx:1.10.0 are released. Version 1.10.0 contains these commits .

Important changes since 1.9.0

• PhotoPicker now allows picking images in order and choosing which tab (either albums or images) should be initially visible.
• The PickVisualMedia and PickMultipleVisualMedia Activity Result contracts that trigger the Photo Picker no longer directly delegates to Google Play services if the system Photo picker is not available, but uses the public ACTION_SYSTEM_FALLBACK_PICK_IMAGES action and related extras to provide a consistent Photo Picker experience to OEMs and system apps as a fallback.
• New LocalActivity composition local that provides the Activity for the current scope, removing the need for developers to get an Activity from the LocalContext .

Version 1.10.0-rc01

11 دسامبر 2024

androidx.activity:activity:1.10.0-rc01 , androidx.activity:activity-compose:1.10.0-rc01 , and androidx.activity:activity-ktx:1.10.0-rc01 are released. Version 1.10.0-rc01 contains these commits .

رفع اشکال

• Fixed an issue where changing the enabled state while the PredictiveBackHandler is currently active would short circuit the callback immediately. It will now finish the current callback regardless of the enabled status changes. ( Ib8719 )

Version 1.10.0-beta01

13 نوامبر 2024

androidx.activity:activity:1.10.0-beta01 , androidx.activity:activity-compose:1.10.0-beta01 , and androidx.activity:activity-ktx:1.10.0-beta01 are released with no changes since the last alpha. Version 1.10.0-beta01 contains these commits .

Version 1.10.0-alpha03

30 اکتبر 2024

androidx.activity:activity:1.10.0-alpha03 , androidx.activity:activity-compose:1.10.0-alpha03 , and androidx.activity:activity-ktx:1.10.0-alpha03 are released. Version 1.10.0-alpha03 contains these commits .

تغییرات API

• Added a new LocalActivity composition local that provides the Activity for the current scope, removing the need for developers to get an Activity from the LocalContext . It also comes with a new lint rule that checks when the LocalContext is incorrectly being cast to an Activity . ( I7746a , b/283009666 )

رفع اشکال

• From Activity 1.9.3 : PredictiveBackHandler will no longer fire it's callback after the handler has been disabled. This will fix an issue where the NavHost from Navigation Compose would throw an IndexOutOfBoundsException . ( I3f75e , b/365027664 , b/340202286 )

Dependency Update

• Activity Compose now depends on Compose Runtime 1.7.0 ( I7746a , b/283009666 )

Version 1.10.0-alpha02

4 سپتامبر 2024

androidx.activity:activity:1.10.0-alpha02 , androidx.activity:activity-compose:1.10.0-alpha02 , and androidx.activity:activity-ktx:1.10.0-alpha02 are released. Version 1.10.0-alpha02 contains these commits .

تغییرات رفتار

• The PickVisualMedia and PickMultipleVisualMedia Activity Result contracts that trigger the Photo Picker no longer directly delegates to Google Play services if the system Photo picker is not available, but uses the public ACTION_SYSTEM_FALLBACK_PICK_IMAGES action and related extras to provide a consistent Photo Picker experience to OEMs and system apps as a fallback. This should have no effect on the user experience for devices that have a recent version of Google Play services. ( I3513d )

رفع اشکال

• Removed manual outlining of access to new platform APIs since this happens automatically via API modeling when using R8 with AGP 7.3 or later (eg R8 version 3.3) and for all builds when using AGP 8.1 or later (eg D8 version 8.1). Clients who are not using AGP are advised to update to D8 version 8.1 or later. برای جزئیات بیشتر به این مقاله مراجعه کنید. ( I9496c , b/345472586 )
• From Activity 1.9.2 : Fixed an issue where the Activity Compose PredictiveBackHandler API would continue to handle the system back gesture on the frame it was disabled, which could result in libraries like Navigation Compose to handle back even with an empty back stack, resulting in it throwing an IndexOutOfBoundsException . ( Ie3301 , b/340202286 )
• From Activity 1.9.1 : Fixed an issue with PredictiveBackHandler where after doing system back, attempting to do onBackPressed from the OnBackPressedDispatcher would fail. ( I5f1f8 )

Version 1.10.0-alpha01

26 ژوئن 2024

androidx.activity:activity:1.10.0-alpha01 , androidx.activity:activity-compose:1.10.0-alpha01 , and androidx.activity:activity-ktx:1.10.0-alpha01 are released. This version is developed in an internal branch.

ویژگی های جدید

• Added support for new PhotoPicker features introduced in Android V including being able to pick images in order and choose which tab (either albums or images) should be initially visible.

نسخه 1.9

نسخه 1.9.3

16 اکتبر 2024

androidx.activity:activity:1.9.3 , androidx.activity:activity-compose:1.9.3 , and androidx.activity:activity-ktx:1.9.3 are released. Version 1.9.3 contains these commits .

رفع اشکال

• PredictiveBackHandler will no longer fire it's callback after the handler has been disabled. This will fix an issue where the NavHost from Navigation Compose would throw an IndexOutOfBoundsException . ( I3f75e , b/340202286 )

Version 1.9.2

4 سپتامبر 2024

androidx.activity:activity:1.9.2 , androidx.activity:activity-compose:1.9.2 , and androidx.activity:activity-ktx:1.9.2 are released. Version 1.9.2 contains these lthcocommits .

رفع اشکال

• Fixed an issue where the Activity Compose PredictiveBackHandler API would continue to handle the system back gesture on the frame it was disabled, which could result in libraries like Navigation Compose to handle back even with an empty back stack, resulting in it throwing an IndexOutOfBoundsException . ( Ie3301 , b/340202286 )

Version 1.9.1

24 جولای 2024

androidx.activity:activity:1.9.1 , androidx.activity:activity-compose:1.9.1 , and androidx.activity:activity-ktx:1.9.1 are released. Version 1.9.1 contains these commits .

رفع اشکال

• Fixed an issue with PredictiveBackHandler where after doing system back, attempting to do onBackPressed from the OnBackPressedDispatcher would fail. ( I5f1f8 )

نسخه 1.9.0

17 آوریل 2024

androidx.activity:activity:1.9.0 , androidx.activity:activity-compose:1.9.0 , and androidx.activity:activity-ktx:1.9.0 are released. Version 1.9.0 contains these commits .

Important changes since 1.8.0

• ComponentActivity now implements OnUserLeaveHintProvider to allow components to callbacks for onUserLeaveHint events.
• The OnBackPressedCallback , BackHandler , and PredictiveBackHandler APIs now warn when calling onBackPressedDispatcher.onBackPressed() when handling back as that will always break the Predictive Back Animation . See the best practices guide for more details.
• The remainder of the Activity APIs have been rewritten in Kotlin and all extensions previously available in activity-ktx have been moved to activity . activity-ktx is now completely empty.
  • As part of the conversion of ActivityResultLauncher to Kotlin, the getContract method is now an abstract Kotlin property. This is a binary compatible change, but source breaking if your implementation of ActivityResultLauncher is written in Kotlin.

Version 1.9.0-rc01

3 آوریل 2024

androidx.activity:activity:1.9.0-rc01 , androidx.activity:activity-compose:1.9.0-rc01 , and androidx.activity:activity-ktx:1.9.0-rc01 are released. Version 1.9.0-rc01 contains these commits .

به روز رسانی وابستگی

• Activity now depends on Profile Installer 1.3.1 .

Version 1.9.0-beta01

20 مارس 2024

androidx.activity:activity:1.9.0-beta01 , androidx.activity:activity-compose:1.9.0-beta01 , and androidx.activity:activity-ktx:1.9.0-beta01 are released. Version 1.9.0-beta01 contains these commits .

رفع اشکال

• Fixed an Activity startup performance regression introduced in Activity 1.9.0-alpha02 caused by calling the OnBackPressedDispatcher as part of the creation of the Activity. ( Ie75e3 )

Version 1.9.0-alpha03

7 فوریه 2024

androidx.activity:activity:1.9.0-alpha03 , androidx.activity:activity-compose:1.9.0-alpha03 , and androidx.activity:activity-ktx:1.9.0-alpha03 are released. Version 1.9.0-alpha03 contains these commits.

Lint Warning

• The OnBackPressedCallback , BackHandler , and PredictiveBackHandler APIs now warn when calling onBackPressedDispatcher.onBackPressed() when handling back as that will always break the Predictive Back Animation . See the best practices guide for more details. ( 1e4222 , 2c950d , b/287505200 )

رفع اشکال

• If a back event is sent from the system started during an already running Predictive Back Gesture, the currently running Predictive Back Gesture is canceled and the new back event takes over to begin a new Predictive Back Gesture. ( I3482e )
• Fixed a crash when accessing the onBackPressedDispatcher from a ComponentActivity for the first time from a background thread. It is now safe to access the onBackPressedDispatcher on any thread. ( I79955 )

Version 1.9.0-alpha02

24 ژانویه 2024

androidx.activity:activity:1.9.0-alpha02 , androidx.activity:activity-compose:1.9.0-alpha02 , and androidx.activity:activity-ktx:1.9.0-alpha02 are released. Version 1.9.0-alpha02 contains these commits.

Kotlin Conversions

• ActivityResultRegistry has been rewritten in Kotlin. This ensures that the nullability of the generics on the contract passed to register will correctly be passed through to the ActivityResultLauncher returned to you. ( I121f0 )
• ActivityResult has been rewritten in Kotlin. The ActivityResult Kotlin extensions that support destructuring into the resultCode and data fields have been moved from activity-ktx to activity . ( I0565a )
• The Kotlin extensions of by viewModels() for ComponentActivity and trackPipAnimationHintView have been moved from activity-ktx to activity . The activity-ktx artifact is now completely empty. ( I0a444 )

رفع اشکال

• The enableEdgeToEdge API now draws around any display cutouts. ( a3644b , b/311173461 )
• From Activity 1.8.2 : Fixed the extra passed to the Photo Picker Activity Contract's ACTION_SYSTEM_FALLBACK_PICK_IMAGES to correctly pass it the EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX key, rather than using the extra with the key "com.google.android.gms.provider.extra.PICK_IMAGES_MAX" . It is strongly recommended if you are an OEM who implements a system fallback Photo Picker to support both extras to ensure the widest compatibility. ( I96a00 )

Version 1.9.0-alpha01

29 نوامبر 2023

androidx.activity:activity:1.9.0-alpha01 , androidx.activity:activity-compose:1.9.0-alpha01 , and androidx.activity:activity-ktx:1.9.0-alpha01 are released. Version 1.9.0-alpha01 contains these commits.

ویژگی های جدید

• ComponentActivity now implements OnUserLeaveHintProvider to allow components to callbacks for onUserLeaveHint events. ( I54892 )

تغییرات API

• ComponentActivity has been rewritten in Kotlin. ( I14f31 )
• ActivityResultCaller has been rewritten in Kotlin. ( Ib02e4 )
• ActivityResultLauncher has been rewritten in Kotlin. As part of that conversion, the getContract method is now an abstract Kotlin property. This is a binary compatible change, but source breaking if your implementation of ActivityResultLauncher is written in Kotlin. ( Id4615 )
• PickVisualMediaRequest now has the same minimum API level of 19 as the PickVisualMedia Activity Result contract. ( Id6e21 )

Dependency Update

• Activity now depends on 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 , and androidx.activity:activity-ktx:1.8.2 are released. Version 1.8.2 contains these commits.

رفع اشکال

• Fixed the extra passed to the Photo Picker Activity Contract's ACTION_SYSTEM_FALLBACK_PICK_IMAGES to correctly pass it the EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX key, rather than using the extra with the key "com.google.android.gms.provider.extra.PICK_IMAGES_MAX" . It is strongly recommended if you are an OEM who implements a system fallback Photo Picker to support both extras to ensure the widest compatibility. ( I96a00 )

نسخه 1.8.1

15 نوامبر 2023

androidx.activity:activity:1.8.1 , androidx.activity:activity-compose:1.8.1 , and androidx.activity:activity-ktx:1.8.1 are released. Version 1.8.1 contains these commits.

رفع اشکال

• OnBackPressedDispatcher now continues to dispatch to the correct OnBackPressedCallback even after a new OnBackPressedCallback is added while the back gesture is being handled. ( Id0ff6 )

نسخه 1.8.0

4 اکتبر 2023

androidx.activity:activity:1.8.0 , androidx.activity:activity-compose:1.8.0 , and androidx.activity:activity-ktx:1.8.0 are released. Version 1.8.0 contains these commits.

Important changes since 1.7.0

• Predictive Back - The OnBackPressedCallback now offers new Predictive Back callbacks for handling the back gesture starting, progress throughout the gesture, and the back gesture being canceled in addition to the previous handleOnBackPressed() callback for when the back gesture is committed. This also comes with the PredictiveBackHandler Composable to handle predictive back gesture events in Activity Compose. It provides a Flow of BackEventCompat objects that must be collected in the suspending lamba you provide:

  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() has now been deprecated in favor of the APIs for handling back. Developers should now utilize the OnBackPressedDispatcher , rather than overriding this method.

• EdgeToEdge - ComponentActivity.enableEdgeToEdge() has been added to easily set up the edge-to-edge display in a backward-compatible manner.

Version 1.8.0-rc01

20 سپتامبر 2023

androidx.activity:activity:1.8.0-rc01 , androidx.activity:activity-compose:1.8.0-rc01 , and androidx.activity:activity-ktx:1.8.0-rc01 are released. Version 1.8.0-rc01 contains these commits.

Version 1.8.0-beta01

6 سپتامبر 2023

androidx.activity:activity:1.8.0-beta01 , androidx.activity:activity-compose:1.8.0-beta01 , and androidx.activity:activity-ktx:1.8.0-beta01 are released. Version 1.8.0-beta01 contains these commits.

Documentation Improvement

• Improved the documentation of BackEventCompat . ( aosp/2722254 )

Version 1.8.0-alpha07

23 آگوست 2023

androidx.activity:activity:1.8.0-alpha07 , androidx.activity:activity-compose:1.8.0-alpha07 , and androidx.activity:activity-ktx:1.8.0-alpha07 are released. Version 1.8.0-alpha07 contains these commits.

ویژگی های جدید

• Activity Compose has added a new PredictiveBackHandler Composable to handle predictive back gesture events. It provides a Flow of BackEventCompat objects that must be collected in the suspending lamba you provide:

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

  It also comes with a compile time warning via lint rule to ensure the Flow calls collect() . ( Id2773 , b/294884345 )

• The onBackPressedDispatcher in ComponentActivity is now initialized lazily so that it is only created when required. ( I0bf8e )

رفع اشکال

• ComponentActivity will no longer show a NPE on Android 13 when it gets an onBackPressed() callback and the Activity has already been DESTROYED . ( Idb055 , b/291869278 )
• Removed usages of experimental isAtLeastU() API ( Ie9117 , b/289269026 )

Version 1.8.0-alpha06

21 ژوئن 2023

androidx.activity:activity:1.8.0-alpha06 , androidx.activity:activity-compose:1.8.0-alpha06 , and androidx.activity:activity-ktx:1.8.0-alpha06 are released. Version 1.8.0-alpha06 contains these commits.

ویژگی های جدید

• The OnBackPressedDispatcher now correctly cancels any callbacks that are removed during a Predictive Back Gesture. ( I3f90f )

تغییرات API

• When passing SystemBarStyle.auto to the enableEdgeToEdge API, you can now override the detectDarkMode lambda parameter to provide custom logic for detecting night mode. ( aosp/2546393 , b/278263793 )

Version 1.8.0-alpha05

7 ژوئن 2023

androidx.activity:activity:1.8.0-alpha05 , androidx.activity:activity-compose:1.8.0-alpha05 , and androidx.activity:activity-ktx:1.8.0-alpha05 are released. This version is developed in an internal branch.

تغییرات API

• Activity now provides a BackEventCompat class that serves as a backward compatible version of BackEvent that is decoupled from the framework BackEvent class.
• Breaking change: The handleOnBackStarted and handleOnBackProgressed methods of OnBackPressedCallback now receive an androidx.activity.BackEventCompat instance rather than a framework android.window.BackEvent class. The equivalent @VisibleForTesting APIs on OnBackPressedDispatcher have also been updated.
• The constructor for OnBackPressedDispatcher now takes an optional Consumer<Boolean> instance that allows the owners of the dispatcher to receive a callback whenever the number of enabled callbacks changes from zero to non-zero or vice versa.

رفع اشکال

• From Activity 1.7.2 : Fix ReportDrawn crashing when navigating away from a screen before report is called. ( Ic46f1 , b/260506820 )

Version 1.8.0-alpha04

10 مه 2023

androidx.activity:activity:1.8.0-alpha04 , androidx.activity:activity-compose:1.8.0-alpha04 , and androidx.activity:activity-ktx:1.8.0-alpha04 are released. This was released from an internal branch.

رفع اشکال

• From Activity 1.7.1 : - The ReportFullyDrawExecuter no longer leaks when using ComponentActivity with ActivityScenario . ( Id2ff2 , b/277434271 )

Version 1.8.0-alpha03

12 آوریل 2023

androidx.activity:activity:1.8.0-alpha03 , androidx.activity:activity-compose:1.8.0-alpha03 , and androidx.activity:activity-ktx:1.8.0-alpha03 are released. This was released from an internal branch.

ویژگی های جدید

• Added ComponentActivity.setUpEdgeToEdge() to easily set up the edge-to-edge display in a backward-compatible manner.

تغییرات API

• ComponentActivity.onBackPressed() has now been deprecated in favor of the APIs for handling back. Developers should now utilize the OnBackPressedDispatcher , rather than overriding this method. ( Ibce2f , b/271596918 )
• ComponentDialog and ComponentActivity now contain public API initViewTreeOwners() to be used to initialize all view tree owners before setting the content view. ( Ibdce0 , b/261314581 )

رفع اشکال

• Fixed an issue where Fragments were incorrectly invalidating MenuHosts and causing other menus in the Activity to have unexpected behavior. ( I9404e , b/244336571 )

سایر تغییرات

• The ActivityResultRegister now uses Kotlin Random instead of Java. ( I4d98f , b/272096025 )

Version 1.8.0-alpha02

8 مارس 2023

androidx.activity:activity:1.8.0-alpha02 , androidx.activity:activity-compose:1.8.0-alpha02 , and androidx.activity:activity-ktx:1.8.0-alpha02 are released. Developed from an internal branch.

به روز رسانی وابستگی

• From Activity 1.7.0-rc01 : Activity now depends on Lifecycle 2.6.0 .

Version 1.8.0-alpha01

8 فوریه 2023

androidx.activity:activity:1.8.0-alpha01 , androidx.activity:activity-compose:1.8.0-alpha01 , and androidx.activity:activity-ktx:1.8.0-alpha01 are released. This was built from an internal branch.

ویژگی های جدید

• The OnBackPressedCallback class now contains new Predictive Back progress callbacks for handling the back gesture starting, progress throughout the gesture, and the back gesture being canceled in addition to the previous handleOnBackPressed() callback for when the back gesture is committed.

نسخه 1.7

نسخه 1.7.2

24 مه 2023

androidx.activity:activity:1.7.2 , androidx.activity:activity-compose:1.7.2 , and androidx.activity:activity-ktx:1.7.2 are released. Version 1.7.2 contains these commits.

رفع اشکال

• Fix ReportDrawn crashing when navigating away from a screen before report is called. ( Ic46f1 , b/260506820 )

نسخه 1.7.1

19 آوریل 2023

androidx.activity:activity:1.7.1 , androidx.activity:activity-compose:1.7.1 , and androidx.activity:activity-ktx:1.7.1 are released. Version 1.7.1 contains these commits.

رفع اشکال

• The ReportFullyDrawExecuter no longer leaks when using ComponentActivity with ActivityScenario . ( Id2ff2 , b/277434271 )

نسخه 1.7.0

22 مارس 2023

androidx.activity:activity:1.7.0 , androidx.activity:activity-compose:1.7.0 , and androidx.activity:activity-ktx:1.7.0 are released. Version 1.7.0 contains these commits.

Important changes since 1.6.0

• The Photo Picker activity contracts in PickVisualMedia and PickMultipleVisualMedia have been updated to contain an additional fallback for when MediaStore.ACTION_PICK_IMAGES is unavailable that allows OEMs and system apps, such as Google Play services, to provide a consistent Photo Picker experience on a wider range of Android devices and API levels by implementing the fallback action . The Photo Picker will use this fallback if it is available before falling back to using Intent.ACTION_OPEN_DOCUMENT , which remains to support all API 19 and higher devices.
• ComponentDialog now implements SavedStateRegistryOwner and has access to its own SavedStateRegistry and sets the SavedStateRegistryOwner for its ViewTree . It is now possible to use Jetpack Compose within a ComponentDialog as it meets both the LifecycleOwner and SavedStateRegistryOwner attached to the Window via the ViewTree APIs requirements.
• IntentSenderRequest.Builder.setFlags() now allows you to set multiple flags from Intent , rather than only a single flag.

Kotlin Conversion

A number of Activity classes have been converted to Kotlin. All converted classes still retain their binary compatibility with previous versions. The following classes have source incompatible changes for classes written in Kotlin: ActivityResultRegistryOwner , OnBackPressedDispatcherOwner .

The table below provides the source conversions for the new version of Activity:

These classes were also converted to Kotlin, but remain source compatible: ContextAware , ContextAwareHelper , OnContextAvailableListener , IntentSenderRequest , and OnBackPressedDispatcher

FullyDrawnReporter APIs

ComponentActivity now provides a FullyDrawnReporter instance that allows multiple components to report when they are ready for interaction. ComponentActivity will wait for all components to complete before calling reportFullyDrawn() on your behalf. These APIs take care of the timing requirements for you and do not need to be called as part of an onDraw call.

These APIs are encouraged to enable:

• Signaling the Android Runtime when startup completes, to ensure all of the code run during a multi-frame startup sequence is included and prioritized for background compilation.
• Signaling Macrobenchmark and Play Vitals when your application should be considered fully drawn for startup metrics, so you can track performance.

Three Activity Compose APIs have been added to make it more convenient to use the FullyDrawnReporter from individual composables:

• ReportDrawn indicates that your composable is immediately ready for interaction.
• ReportDrawnWhen takes a predicate (ie, list.count > 0 ) to indicate when your composable is ready for interaction.
• ReportDrawnAfter takes a suspending method that, when it completes, indicates that you are ready for interaction.

Dependency Updates

• Activity now depends on Lifecycle 2.6.1 . ( 8fc31d )
• Activity now depends on ProfileInstaller 1.3.0 . ( 83d3b1 )

Version 1.7.0-rc01

8 مارس 2023

androidx.activity:activity:1.7.0-rc01 , androidx.activity:activity-compose:1.7.0-rc01 , and androidx.activity:activity-ktx:1.7.0-rc01 are released. Version 1.7.0-rc01 contains these commits.

به روز رسانی وابستگی

• Activity now depends on Lifecycle 2.6.0 .

Version 1.7.0-beta02

22 فوریه 2023

androidx.activity:activity:1.7.0-beta02 , androidx.activity:activity-compose:1.7.0-beta02 , and androidx.activity:activity-ktx:1.7.0-beta02 are released. Version 1.7.0-beta02 contains these commits.

تغییرات API

• The action and extra used by the PickVisualMedia and PickMultipleVisualMedia contracts as a fallback for when MediaStore.ACTION_PICK_IMAGES is unavailable are now public constants that provide API stability to OEMs and system apps that want to provide a consistent Photo Picker experience. The implementation of this fallback is still limited to only system apps. ( Icd320 )

Version 1.7.0-beta01

8 فوریه 2023

androidx.activity:activity:1.7.0-beta01 , androidx.activity:activity-compose:1.7.0-beta01 , and androidx.activity:activity-ktx:1.7.0-beta01 are released. Version 1.7.0-beta01 contains these commits.

ویژگی های جدید

• IntentSenderRequest.Builder.setFlags() now allows you to set multiple flags from Intent , rather than only a single flag. ( Iac04c )

رفع اشکال

• The fallback for PickVisualMedia for when the framework Photo Picker is unavailable now correctly limits the handling to apps installed in the device's system image. ( If8ae6 )

Kotlin Conversions

• ActivityResultRegistryOwner is now written in Kotlin. This is a source incompatible change for those classes written in Kotlin - you must now override the activityResultRegistry property rather than implementing the previous getActivityResultRegistry() function. ( I0b00e )
• OnBackPressedDispatcherOwner is now written in Kotlin. This is a source incompatible change for those classes written in Kotlin - you must now override the onBackPressedDispatcher property rather than implementing the previous getOnBackPressedDispatcher function. ( Ia277d )
• ContextAware , ContextAwareHelper , OnContextAvailableListener , IntentSenderRequest and OnBackPressedDispatcher are now written in Kotlin. ( I1a73e , Iada92 , aosp/2410754 , I18ac7 , b/257291701 )

Version 1.7.0-alpha04

25 ژانویه 2023

androidx.activity:activity:1.7.0-alpha04 , androidx.activity:activity-compose:1.7.0-alpha04 , and androidx.activity:activity-ktx:1.7.0-alpha04 are released. Version 1.7.0-alpha04 contains these commits.

ویژگی های جدید

• The PickVisualMedia and PickMultipleVisualMedia Activity Result contracts will now use a Google Play services provided Photo Picker where available in cases where the Android system provided Photo Picker (eg, MediaStore.ACTION_PICK_IMAGES ) is not available. The isPhotoPickerAvailable() API that only detects the Android system provided Photo Picker has been deprecated. It is recommended to use the new isPhotoPickerAvailable(Context) API, which will return if either Photo Picker is available. ( I55be6 )

Version 1.7.0-alpha03

11 ژانویه 2023

androidx.activity:activity:1.7.0-alpha03 , androidx.activity:activity-compose:1.7.0-alpha03 , and androidx.activity:activity-ktx:1.7.0-alpha03 are released. Version 1.7.0-alpha03 contains these commits.

ویژگی های جدید

• ComponentDialog now implements SavedStateRegistryOwner and has access to its own SavedStateRegistry and sets the SavedStateRegistryOwner for its ViewTree. It is now possible to use Jetpack Compose within a ComponentDialog as it meets both the LifecycleOwner and SavedStateRegistryOwner attached to the Window via the ViewTree APIs requirements. ( Idca17 , I73468 b/261162296 )

تغییرات API

• Added a ReportDrawn composable that immediately marks the activity as ready to call reportFullyDrawn . ( Ic5b14 , b/259687964 )

Kotlin Conversions

• The ActvitiyResultCallback and OnBackPressedCallback classes have both been converted to Kotlin while maintaining source and binary compatibility. ( Ifc5e5 , Ide1b0 , b/257291701 )

Version 1.7.0-alpha02

24 اکتبر 2022

androidx.activity:activity:1.7.0-alpha02 , androidx.activity:activity-compose:1.7.0-alpha02 , and androidx.activity:activity-ktx:1.7.0-alpha02 are released. Version 1.7.0-alpha02 contains these commits.

رفع اشکال

• From Activity 1.6.1 : Fixed an issue with the PickMultipleVisualMedia Activity Result contract not launching on Android R devices when using the default value for maxItems . ( Ie2776 , b/249182130 )

Version 1.7.0-alpha01

5 اکتبر 2022

androidx.activity:activity:1.7.0-alpha01 , androidx.activity:activity-compose:1.7.0-alpha01 , and androidx.activity:activity-ktx:1.7.0-alpha01 are released. Version 1.7.0-alpha01 contains these commits.

FullyDrawnReporter APIs

ComponentActivity now provides a FullyDrawnReporter instance that allows multiple components to report when they are ready for interaction. ComponentActivity will wait for all components to complete before calling reportFullyDrawn() on your behalf. These APIs take care of the timing requirements for you and do not need to be called as part of an onDraw call.

These APIs are encouraged to enable:

• Signaling the Android Runtime when startup completes, to ensure all of the code run during a multi-frame startup sequence is included and prioritized for background compilation.
• Signaling Macrobenchmark and Play Vitals when your application should be considered fully drawn for startup metrics, so you can track performance.

Two Activity Compose APIs have been added to make it more convenient to use the FullyDrawnReporter from individual composables:

• ReportDrawnWhen takes a predicate (ie, list.count > 0 ) to indicate when your composable is ready for interaction.
• ReportDrawnAfter takes a suspending method that, when it completes, indicates that you are ready for interaction.

نسخه 1.6.1

نسخه 1.6.1

24 اکتبر 2022

androidx.activity:activity:1.6.1 , androidx.activity:activity-compose:1.6.1 , and androidx.activity:activity-ktx:1.6.1 are released. Version 1.6.1 contains these commits.

رفع اشکال

• Fixed an issue with the PickMultipleVisualMedia Activity Result contract not launching on Android R devices when using the default value for 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 , and androidx.activity:activity-ktx:1.6.0 are released. Version 1.6.0 contains these commits.

Important changes since 1.5.0

• Added ActivityResultContracts.PickVisualMedia and ActivityResultContracts.PickMultipleVisualMedia for providing a backward compatible contract that uses MediaStore.ACTION_PICK_IMAGES when the Photo Picker is available and Intent.ACTION_OPEN_DOCUMENT when it is not available.
• Integrated the OnBackInvokedCallback in Android 13 into the OnBackPressedDispatchers provided by ComponentActivity and ComponentDialog . This ensures that all APIs built on OnBackPressedDispatcher work when enabling a predictive back gesture .

Version 1.6.0-rc02

7 سپتامبر 2022

androidx.activity:activity:1.6.0-rc02 , androidx.activity:activity-compose:1.6.0-rc02 , and androidx.activity:activity-ktx:1.6.0-rc02 are released. Version 1.6.0-rc02 contains these commits.

رفع اشکال

• OnBackPressedDispatcher now registers the OnBackInvokedCallback with the PRIORITY_DEFAULT instead of PRIORITY_OVERLAY . ( I3901f )
• Classes that extend ComponentActivity will now always have both of their onMultiWindowModeChanged() callbacks dispatched. ( Ic4d85 )
• The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch call throws any Exception and the callback was registered without a LifecycleOwner . ( Ia7ff7 , b/238350794 )
• ComponentActivity will now properly dispatch menu calls without the need to call the super function in your activity. ( Ie33c5 , b/238057118 )

Dependency Update

• The Activity library now depends on Lifecycle 2.5.1 . ( If6697 )

Version 1.6.0-rc01

24 آگوست 2022

androidx.activity:activity:1.6.0-rc01 , androidx.activity:activity-compose:1.6.0-rc01 , and androidx.activity:activity-ktx:1.6.0-rc01 are released. Version 1.6.0-rc01 contains these commits.

رفع اشکال

• Initializing an OnBackPressedDispatcher will no longer cause ClassVerificationError s when using SDK versions prior to 33. ( Ic32e1 )
• Classes that override ComponentActivity 's onPictureInPictureModeChanged() callback will now always have their callbacks dispatched. ( Ib7fdb )

Version 1.6.0-beta01

August 10, 2022

androidx.activity:activity:1.6.0-beta01 , androidx.activity:activity-compose:1.6.0-beta01 , and androidx.activity:activity-ktx:1.6.0-beta01 are released. Version 1.6.0-beta01 contains these commits.

تغییرات API

• Marked the deprecated startActivityForResult and startIntentSenderForResult methods on ComponentActivity with @NonNull because passing null has always resulted in a crash. ( Id2a25 , b/231476082 )

رفع اشکال

• From Activity 1.5.1 : The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch call throws any Exception and the callback was registered without a LifecycleOwner . ( Ia7ff7 , b/238350794 )
• From Activity 1.5.1 : ComponentActivity will now properly dispatch menu calls to onPrepareOptionMenu() , onCreateOptionsMenu() and onOptionsItemSelected() overrides without the need to call the super function. ( Ie33c5 , b/238057118 )

Dependency Update

• From Activity 1.5.1 : The Activity library now depends on the Lifecycle version 2.5.1 . ( If6697 )

Version 1.6.0-alpha05

15 ژوئن 2022

androidx.activity:activity:1.6.0-alpha05 , androidx.activity:activity-compose:1.6.0-alpha05 , and androidx.activity:activity-ktx:1.6.0-alpha05 are released. Version 1.6.0-alpha05 was developed in a private pre-release branch and has no public commits.

تغییرات API

• minCompileSdk is now 33 to align with Tiramisu Beta 3 SDK

رفع اشکال

• Fixed crash on older devices when doing SDK extension check for the PickVisualMedia ActivityResultContract so that it should now work with ACTION_OPEN_DOCUMENT on devices running Android 10 and lower.

Version 1.6.0-alpha04

18 مه 2022

androidx.activity:activity:1.6.0-alpha04 and androidx.activity:activity-ktx:1.6.0-alpha04 are released.

رفع اشکال

• Fixed an error in PickVisualMediaRequest where attempting to create a request, either via the Builder or the top level Kotlin function, would result in a stack overflow.
• Integrated the OnBackInvokedCallback in Android 13 Dev Beta 2 into the OnBackPressedDispatcher provided by ComponentDialog . This ensures that all APIs built on OnBackPressedDispatcher work when enabling a predictive back gesture .

Version 1.6.0-alpha03

27 آوریل 2022

androidx.activity:activity:1.6.0-alpha03 , androidx.activity:activity-compose:1.6.0-alpha03 , and androidx.activity:activity-ktx:1.6.0-alpha03 are released.

• Note: This version will only compile against the Android 13 Developer Beta 1 SDK.

ویژگی های جدید

• Added ActivityResultContracts.PickVisualMedia and ActivityResultContracts.PickMultipleVisualMedia for providing a backward compatible contract that uses MediaStore.ACTION_PICK_IMAGES when the Photo Picker is available and Intent.ACTION_OPEN_DOCUMENT when it is not available.
• Integrated the OnBackInvokedCallback in Android 13 Dev Beta 1 into the OnBackPressedDispatcher provided by ComponentActivity . This ensures that all APIs built on OnBackPressedDispatcher work when enabling a predictive back gesture .

Version 1.6.0-alpha01

23 مارس 2022

androidx.activity:activity:1.6.0-alpha01 , androidx.activity:activity-compose:1.6.0-alpha01 , and androidx.activity:activity-ktx:1.6.0-alpha01 are released.

• Note: This version will only compile against the Android 13 Developer Preview 2 SDK.

ویژگی های جدید

• Integrated changes in Android 13 Dev Preview 2 into ComponentActivity .

نسخه 1.5.1

نسخه 1.5.1

27 جولای 2022

androidx.activity:activity:1.5.1 , androidx.activity:activity-compose:1.5.1 , and androidx.activity:activity-ktx:1.5.1 are released. Version 1.5.1 contains these commits.

رفع اشکال

• The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch() call throws any Exception and the callback was registered without a LifecycleOwner . ( Ia7ff7 , b/238350794 )

• ComponentActivity will now properly dispatch menu calls to onPrepareOptionMenu() , onCreateOptionsMenu() and onOptionsItemSelected() overrides without the need to call the super function. ( Ie33c5 , b/238057118 )

به روز رسانی وابستگی

• The Activity library now depends on the Lifecycle 2.5.1 . ( If6697 )

نسخه 1.5.0

نسخه 1.5.0

29 ژوئن 2022

androidx.activity:activity:1.5.0 , androidx.activity:activity-compose:1.5.0 , and androidx.activity:activity-ktx:1.5.0 are released. Version 1.5.0 contains these commits.

Important changes since 1.4.0

• ComponentDialog - ComponentDialog is a subclass of Dialog that includes an OnBackPressedDispatcher that will be called when the system back button is pressed and the dialog is visible. Importantly, this subclass also sets the ViewTreeOnBackPressedDispatcherOwner , allowing views a generic way to retrieve the correct dispatcher whether it exists in a ComponentActivity or a ComponentDialog .
• Callback Interfaces - ComponentActivity now implements a set of modular callback interfaces that can be used instead of the Activity callbacks. These interfaces include the following: OnNewIntentProvider , OnConfigurationChangedProvider , OnTrimMemoryProvider , OnPictureInPictureModeChangedProvider , OnMultiWindowModeChangedProvider
• CreationExtras Integration - ComponentActivity now has the ability to provide a stateless ViewModelProvider.Factory via Lifecycle 2.5.0 's CreationExtras .

تغییرات دیگر

• The no parameter constructor for ActivityResultContracts.CreateDocument has been deprecated and replaced with a new constructor that takes a concrete mime type (eg, "image/png") as is required by Intent.ACTION_CREATE_DOCUMENT .

Version 1.5.0-rc01

11 مه 2022

androidx.activity:activity:1.5.0-rc01 , androidx.activity:activity-compose:1.5.0-rc01 , and androidx.activity:activity-ktx:1.5.0-rc01 are released with no changes from 1.5.0-beta01. Version 1.5.0-rc01 contains these commits.

Version 1.5.0-beta01

20 آوریل 2022

androidx.activity:activity:1.5.0-beta01 , androidx.activity:activity-compose:1.5.0-beta01 , and androidx.activity:activity-ktx:1.5.0-beta01 are released. Version 1.5.0-beta01 contains these commits.

Dependency updates

• Activity now depends on Lifecycle 2.4.0-beta01 .

Version 1.5.0-alpha05

6 آوریل 2022

androidx.activity:activity:1.5.0-alpha05 , androidx.activity:activity-compose:1.5.0-alpha05 , and androidx.activity:activity-ktx:1.5.0-alpha05 are released. Version 1.5.0-alpha05 contains these commits.

رفع اشکال

• ComponentActivity 's onPanelClosed() now calls the super onPanelClosed() as well, fixing an issue where the onContextMenuClosed method would not be called. ( Ib6f77 )

Version 1.5.0-alpha04

23 مارس 2022

androidx.activity:activity:1.5.0-alpha04 , androidx.activity:activity-compose:1.5.0-alpha04 , and androidx.activity:activity-ktx:1.5.0-alpha04 are released. Version 1.5.0-alpha04 contains these commits.

رفع اشکال

• SavedStateViewFactory now supports using CreationExtras even when it was initialized with a SavedStateRegistryOwner . If extras are provided, the initialized arguments are ignored. ( I6c43b , b/224844583 )

Version 1.5.0-alpha03

23 فوریه 2022

androidx.activity:activity:1.5.0-alpha03 , androidx.activity:activity-compose:1.5.0-alpha03 , and androidx.activity:activity-ktx:1.5.0-alpha03 are released. Version 1.5.0-alpha03 contains these commits.

تغییرات API

• You can now pass CreationExtras to the activity by viewModels() function ( I6a3e6 , b/217600303 )

Version 1.5.0-alpha02

9 فوریه 2022

androidx.activity:activity:1.5.0-alpha02 , androidx.activity:activity-compose:1.5.0-alpha02 , and androidx.activity:activity-ktx:1.5.0-alpha02 are released. Version 1.5.0-alpha02 contains these commits.

ویژگی های جدید

• ComponentActivity now implements the OnPictureInPictureModeChangedProvider interface to allow any component to receive picture-in-picture mode change events. ( I9f567 )
• ComponentActivity now implements the OnMultiWindowModeChangedProvider interface to allow any component to receive multi-window mode change events. ( I62d91 )

Version 1.5.0-alpha01

26 ژانویه 2022

androidx.activity:activity:1.5.0-alpha01 , androidx.activity:activity-compose:1.5.0-alpha01 , and androidx.activity:activity-ktx:1.5.0-alpha01 are released. Version 1.5.0-alpha01 contains these commits.

ویژگی های جدید

• ComponentActivity now integrates with ViewModel CreationExtras, introduced as part of Lifecycle 2.5.0-alpha01 . ( Ie7e00 , b/207012584 )
• Added ComponentDialog , a subclass of Dialog that includes an OnBackPressedDispatcher that will be called when the system back button is pressed when the dialog is visible. Importantly, this subclass also sets the ViewTreeOnBackPressedDispatcherOwner , allowing views a generic way to retrieve the correct dispatcher whether it exists in a ComponentActivity or a ComponentDialog . ( I8a1bc )
• ComponentActivity now implements the new OnNewIntentProvider interface to allow any component to receive these events. ( If1f8b )
• ComponentActivity now implements the new OnConfigurationChangedProvider interface to allow any component to receive these events. ( If623b )
• ComponentActivity now implements the new OnTrimMemoryProvider interface to allow any component to receive these events. ( Ia9295 )

تغییرات API

• The no parameter constructor for ActivityResultContracts.CreateDocument has been deprecated and replaced with a new constructor that takes a concrete mime type (eg, "image/png" ) as is required by Intent.ACTION_CREATE_DOCUMENT . ( I2bec6 )
• The OnBackPressedDispatcherOwner associated with a View can now be retrieved via the ViewTreeOnBackPressedDispatcherOwner , rather than relying on casting the Context . ( I74685 )

رفع اشکال

• Fixed a crash when accessing a ViewModel for the very first time from a registerForActivityResult() callback or the callbacks to a LifecycleObserver added as part of init of a ComponentActivity . ( Ife83f )

نسخه 1.4.0

نسخه 1.4.0

27 اکتبر 2021

androidx.activity:activity:1.4.0 , androidx.activity:activity-compose:1.4.0 , and androidx.activity:activity-ktx:1.4.0 are released. Version 1.4.0 contains these commits.

Important changes since 1.3.0

• AndroidX ComponentActivity now implements the MenuHost interface. This allows any component to add menu items to the ActionBar by adding a MenuProvider instance to the activity. Each MenuProvider can optionally be added with a Lifecycle that will automatically control the visibility of those menu items based on the Lifecycle state and handle the removal of the MenuProvider when the Lifecycle is destroyed.
• The ActivityResultContract class has been rewritten in Kotlin to ensure that developers writing custom contracts in Kotlin can define the correct nullability for their input and output classes.
• The ActivityResultContracts class and its contracts have been rewritten in Kotlin to ensure the proper nullability.

Version 1.4.0-rc01

13 اکتبر 2021

androidx.activity:activity:1.4.0-rc01 , androidx.activity:activity-compose:1.4.0-rc01 , and androidx.activity:activity-ktx:1.4.0-rc01 are released. Version 1.4.0-rc01 contains these commits.

رفع اشکال

• The ActivityResultRegistry will no longer return a result to the ActivityResultCallback when the launch call throws any Exception . ( If4f91 , b/200845664 )

Version 1.4.0-beta01

29 سپتامبر 2021

androidx.activity:activity:1.4.0-beta01 , androidx.activity:activity-compose:1.4.0-beta01 , and androidx.activity:activity-ktx:1.4.0-beta01 are released. Version 1.4.0-beta01 contains these commits.

تغییرات API

• Fixed the type for the ActivityResultContracts.OpenMultipleDocuments and ActivityResultContracts.GetMultipleContents that caused then to use an output type of List<? extends Uri> when using the code from the Java programming language. ( If71de )
• Public constants within the ActivityResultContracts.StartActivityForResult , ActivityResultContracts.StartIntentSenderForResult , and ActivityResultContracts.RequestMultiplePermissions classes are now accessible when using Kotlin via their now public Companion objects. ( aosp/1832555 )

به روز رسانی اسناد

• The deprecation message for APIs now handled by the Activity Result APIs , namely startActivityForResult , startIntentSenderForResult , onActivityResult , requestPermissions , and onRequestPermissionsResult , have all been expanded with more details. ( cce80f )

Version 1.4.0-alpha02

15 سپتامبر 2021

androidx.activity:activity:1.4.0-alpha02 , androidx.activity:activity-compose:1.4.0-alpha02 , and androidx.activity:activity-ktx:1.4.0-alpha02 are released. Version 1.4.0-alpha02 contains these commits.

ویژگی های جدید

• The activity-compose artifact now contains a LaunchDuringComposition lint error that prevents you from calling the launch method of ActivityResultLauncher as part of composition as composition should be side-effect free. Use the APIs for handling side-effects . ( 7c2bbe , b/191347220 )

تغییرات API

• The ActivityResultContract class has been rewritten in Kotlin to ensure that developers writing custom contracts in Kotlin can define the correct nullability for their input and output classes. ( I8a8f5 )
• The ActivityResultContracts class and its contracts have been rewritten in Kotlin to ensure the proper nullability. ( I69802 )

Version 1.4.0-alpha01

1 سپتامبر 2021

androidx.activity:activity:1.4.0-alpha01 , androidx.activity:activity-compose:1.4.0-alpha01 , and androidx.activity:activity-ktx:1.4.0-alpha01 are released. Version 1.4.0-alpha01 contains these commits.

ویژگی های جدید

• AndroidX ComponentActivity now implements the MenuHost interface.. This allows any component to add menu items to the ActionBar by adding a MenuProvider instance to the activity. Each MenuProvider can optionally be added with a Lifecycle that will automatically control the visibility of those menu items based on the Lifecycle state and handle the removal of the MenuProvider when the Lifecycle is destroyed. ( 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)
  }