فعالیت

به APIهای قابل ترکیب ساخته شده در بالای Activity دسترسی داشته باشید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
13 نوامبر 2024 1.9.3 - 1.10.0-بتا01 -

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

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

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

شیار 

dependencies {
    def activity_version = "1.9.2"

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

کاتلین

dependencies {
    val activity_version = "1.9.2"

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

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

بازخورد

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

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

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

نسخه 1.10

نسخه 1.10.0-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 ها است.

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

نسخه 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 ها است.

اخطار لینت

رفع اشکال

  • اگر یک رویداد برگشتی از سیستم ارسال شود که در طول یک حرکت پیش‌گویانه برگشت پیش‌بینی‌شده از قبل اجرا شده است، ژست برگشت پیش‌بینی‌کننده فعلی لغو می‌شود و رویداد برگشت جدید برای شروع یک ژست برگشت پیش‌بینی‌کننده جدید انجام می‌شود. ( 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 )

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

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

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

نسخه 1.8.0-alpha01

8 فوریه 2023

androidx.activity:activity:1.8.0-alpha01 ، androidx.activity:activity-compose:1.8.0-alpha01 و androidx.activity:activity-ktx:1.8.0-alpha01 منتشر شدند. این از یک شاخه داخلی ساخته شده است.

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

  • کلاس OnBackPressedCallback اکنون شامل فراخوان‌های پیش‌بینی‌کننده پیشرفت بازگشتی جدید برای مدیریت شروع حرکت برگشتی، پیشرفت در طول ژست، و لغو ژست برگشتی علاوه بر تماس قبلی handleOnBackPressed() برای زمانی که ژست برگشتی متعهد است، می‌شود.

نسخه 1.7

نسخه 1.7.2

24 مه 2023

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

رفع اشکال

  • رفع خرابی ReportDrawn هنگام دور شدن از صفحه قبل از فراخوانی report . ( Ic46f1 , b/260506820 )

نسخه 1.7.1

19 آوریل 2023

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

رفع اشکال

  • هنگام استفاده از ComponentActivity با ActivityScenario ، ReportFullyDrawExecuter دیگر درز نمی کند. ( ID2ff2 , b/277434271 )

نسخه 1.7.0

22 مارس 2023

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

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

  • قراردادهای فعالیت Photo Picker در PickVisualMedia و PickMultipleVisualMedia به‌روزرسانی شده‌اند تا حاوی یک بک گراند اضافی برای زمانی که MediaStore.ACTION_PICK_IMAGES در دسترس نیست.ACTION_PICK_IMAGES که به OEMها و برنامه‌های سیستمی، مانند سرویس‌های Google Play اجازه می‌دهد تا تجربه یکدستی از Photo Picker را در گستره وسیع‌تری از Android ارائه دهند. دستگاه ها و سطوح API با اجرای عمل بازگشتی . در صورتی که Photo Picker قبل از استفاده از Intent.ACTION_OPEN_DOCUMENT در دسترس باشد، از این بازگشتی استفاده می‌کند، که همچنان از همه دستگاه‌های API 19 و بالاتر پشتیبانی می‌کند.
  • ComponentDialog اکنون SavedStateRegistryOwner پیاده سازی می کند و به SavedStateRegistry خود دسترسی دارد و SavedStateRegistryOwner را برای ViewTree خود تنظیم می کند. اکنون می‌توان از Jetpack Compose در یک ComponentDialog استفاده کرد، زیرا هم LifecycleOwner و هم SavedStateRegistryOwner که از طریق الزامات APIهای ViewTree به پنجره متصل شده‌اند، برآورده می‌کند.
  • IntentSenderRequest.Builder.setFlags() اکنون به شما اجازه می دهد تا به جای یک پرچم، چندین پرچم را از Intent تنظیم کنید.

تبدیل کاتلین

تعدادی از کلاس های Activity به Kotlin تبدیل شده اند. همه کلاس های تبدیل شده هنوز سازگاری باینری خود را با نسخه های قبلی حفظ می کنند. کلاس های زیر دارای تغییرات ناسازگار منبع برای کلاس های نوشته شده در Kotlin هستند: ActivityResultRegistryOwner ، OnBackPressedDispatcherOwner .

جدول زیر تبدیل منبع برای نسخه جدید Activity را ارائه می دهد:

فعالیت 1.5 فعالیت 1.6
override fun getActivityResultRegistry() = activityResultRegistry override val activityResultRegistry = activityResultRegistry
override fun getOnBackPressedDispatcher() = onBackPressedDispatcher override val onBackPressedDispatcher = onBackPressedDispatcher

این کلاس‌ها نیز به Kotlin تبدیل شدند، اما همچنان با منبع سازگار هستند: ContextAware ، ContextAwareHelper ، OnContextAvailableListener ، IntentSenderRequest ، و OnBackPressedDispatcher

API های FullyDrawnReporter

ComponentActivity اکنون یک نمونه FullyDrawnReporter را ارائه می دهد که به چندین مؤلفه اجازه می دهد زمانی که برای تعامل آماده هستند گزارش دهند. ComponentActivity قبل از فراخوانی reportFullyDrawn() از طرف شما منتظر می ماند تا تمام کامپوننت ها تکمیل شوند. این APIها از الزامات زمان‌بندی برای شما مراقبت می‌کنند و نیازی به فراخوانی به عنوان بخشی از تماس onDraw ندارند.

این APIها تشویق می شوند تا فعال شوند:

  • زمانی که راه‌اندازی کامل می‌شود، زمان اجرای Android را علامت‌گذاری کنید تا مطمئن شوید که تمام کد اجرا شده در طول یک دنباله راه‌اندازی چند فریمی گنجانده شده است و برای جمع‌آوری پس‌زمینه اولویت‌بندی می‌شود.
  • هنگامی که برنامه شما باید به طور کامل برای معیارهای راه اندازی در نظر گرفته شود، سیگنال Macrobenchmark و Play Vitals را نشان می دهد، بنابراین می توانید عملکرد را ردیابی کنید.

سه API Activity Compose اضافه شده‌اند تا استفاده از FullyDrawnReporter را از تک تک اجزای سازنده راحت‌تر کند:

  • ReportDrawn نشان می دهد که composable شما بلافاصله برای تعامل آماده است.
  • ReportDrawnWhen یک گزاره می گیرد (یعنی list.count > 0 ) تا نشان دهد که سازنده شما چه زمانی برای تعامل آماده است.
  • ReportDrawnAfter یک روش تعلیق را انتخاب می کند که وقتی کامل شد، نشان می دهد که شما برای تعامل آماده هستید.

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

نسخه 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 ها است.

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

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

رفع اشکال

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

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

نسخه 1.6.0-rc01

24 آگوست 2022

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

رفع اشکال

  • راه‌اندازی یک OnBackPressedDispatcher دیگر باعث خطای ClassVerificationError در هنگام استفاده از نسخه‌های SDK قبل از ۳۳ نمی‌شود. ( Ic32e1 )
  • کلاس هایی که فراخوانی onPictureInPictureModeChanged() ComponentActivity را لغو می کنند، اکنون همیشه تماس هایشان ارسال می شود. ( Ib7fdb )

نسخه 1.6.0-beta01

10 آگوست 2022

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

تغییرات API

  • متدهای منسوخ startActivityForResult و startIntentSenderForResult در ComponentActivity با @NonNull علامت‌گذاری کرد زیرا ارسال null همیشه منجر به خرابی می‌شود. ( ID2a25 , b/231476082 )

رفع اشکال

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

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

  • از Activity 1.5.1 : کتابخانه Activity اکنون به Lifecycle نسخه 2.5.1 بستگی دارد. ( If6697 )

نسخه 1.6.0-alpha05

15 ژوئن 2022

androidx.activity:activity:1.6.0-alpha05 ، androidx.activity:activity-compose:1.6.0-alpha05 و androidx.activity:activity-ktx:1.6.0-alpha05 منتشر شدند. نسخه 1.6.0-alpha05 در یک شعبه پیش از انتشار خصوصی توسعه یافته است و هیچ تعهد عمومی ندارد.

تغییرات API

  • minCompileSdk اکنون 33 است تا با Tiramisu Beta 3 SDK هماهنگ شود

رفع اشکال

  • خرابی دستگاه‌های قدیمی‌تر هنگام بررسی برنامه افزودنی SDK برای PickVisualMedia ActivityResultContract برطرف شد، به طوری که اکنون باید با ACTION_OPEN_DOCUMENT در دستگاه‌های دارای Android 10 و پایین‌تر کار کند.

نسخه 1.6.0-alpha04

18 مه 2022

androidx.activity:activity:1.6.0-alpha04 و androidx.activity:activity-ktx:1.6.0-alpha04 منتشر شدند.

رفع اشکال

  • رفع یک خطا در PickVisualMediaRequest که در آن تلاش برای ایجاد یک درخواست، از طریق Builder یا تابع سطح بالای Kotlin، منجر به سرریز پشته می‌شود.
  • OnBackInvokedCallback را در Android 13 Dev Beta 2 در OnBackPressedDispatcher ارائه شده توسط ComponentDialog ادغام کرد. این تضمین می‌کند که همه APIهای ساخته شده بر روی OnBackPressedDispatcher هنگام فعال کردن یک حرکت پیش‌بینی کننده برگشت کار می‌کنند.

نسخه 1.6.0-alpha03

27 آوریل 2022

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

  • توجه: این نسخه فقط در برابر توسعه دهنده Android 13 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 )

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

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

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

نسخه 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 - Artifact activity-compose روش پسوند setContent را برای میزبانی UI Jetpack شما در یک فعالیت فراهم می کند و بسته بندی های خاصی را برای تعامل با API های ComponentActivity برای دستیابی به دکمه پشت سیستم و API های نتیجه فعالیت ایجاد می کند. برای جزئیات بیشتر به مستندات مراجعه کنید.
  • CATTREVIDEO CONTRAPT - CaptureVideo ActivityResultContract جایگزین قرارداد TakeVideo در حال حاضر مستهلک شده است و یک موفقیت بولی را که در بسیاری از برنامه های دوربین کار می کند ، برمی گرداند.
  • ردیابی تصویر در تصویر در تصویر -کاربران activity-ktx هم اکنون می توانند از روش توسعه trackPipAnimationHintView در Activity استفاده کنند تا به طور خودکار PictureInPictureParams را با موقعیت جدید نمای بازسازی کنند زیرا موقعیت نسبت به پنجره را تغییر می دهد.

نسخه 1.3.0-RC02

14 جولای 2021

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

رفع اشکال

  • اکنون تماس های ActivityResultRegistry به درستی ذخیره شده و بازیابی می شوند ، بنابراین تماس های تماس تلفنی در SavedState کپی نمی شوند. ( i97816 ، b/191893160 )

نسخه 1.3.0-rc01

1 ژوئیه 2021

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

نسخه 1.3.0-beta02

16 ژوئن 2021

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

activity-compose به آهنگسازی 1.0.0-beta09 بستگی دارد. androidx.compose.ui:ui-test-junit4 اکنون وابستگی زمانی کامپایل به activity-compose دارد.

نسخه 1.3.0-beta01

2 ژوئن 2021

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

تغییرات API

  • روش قبلاً کاهش یافته @Composable registerForActivityResult() حذف شده است. لطفاً از rememberLauncherForActivityResult() استفاده کنید. ( IC39D3 )

نسخه 1.3.0-alpha08

18 مه 2021

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

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

  • فعالیت جدید CaptureVideo ActivityResultContract یک Boolean را به ActivityResultCallback شما باز می گرداند که نشان می دهد آیا فیلم شما با موفقیت در URI داده شده ذخیره شده است. این جایگزین قرارداد TakeVideo در حال حاضر مستهلک شده است زیرا برنامه های دوربین به ندرت از بازگشت یک مپ کوچک تصویر کوچک پشتیبانی می کنند و نتیجه را بی فایده می کنند. ( IE21F2 ، B/185938070 )
  • Activity#setPipAnimationHintView برای به روزرسانی اشاره رکورد منبع پیپرامز هر زمان که این نمایش حرکت می کند. ( i9063d )

تغییرات API

  • تابع rememberLauncherForActivityResult از عملکردی که عملکرد unregister() کاهش می دهد - ثبت نام و ثبت نام از پرتاب به طور خودکار توسط به یاد داشته می شود rememberLauncherForActivityResult . ( i2443e )

سازگاری را تشکیل می دهد

  • androidx.activity:activity-compose:1.3.0-alpha08 فقط با نسخه آهنگسازی 1.0.0-beta07 و بالاتر سازگار است.

نسخه 1.3.0-alpha07

21 آوریل 2021

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

رفع اشکال

  • rememberLauncherForActivityResult اکنون یک مرجع پایدار را به همان نمونه ActivityResultLauncher بازگرداند ، حتی اگر قرارداد به دلیل استفاده مجدد تغییر کند. ( id2d6d )
  • استفاده از نسخه های ناپایدار قطعات بالاتر از 1.3.0 دیگر خطای خط مثبت کاذب را به شما می گوید که از 1.3.0 استفاده کنید. ( AOSP/1670206 ، b/184847092 )

نسخه 1.3.0-alpha06

7 آوریل 2021

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

تغییرات API

  • API registerForActivityResult() rememberLauncherForActivityResult() به یادآوری شده است که به یاد داشته باشید که ActivityResultLauncher برگشتی یک شیء مدیریت شده است که از طرف شما به یاد می آید. تلاش برای فراخوانی unregister از ActivityResultLauncher برگشتی ، اکنون خطایی خواهد داشت. ( i2bb6d )
  • LocalOnBackPressedDispatcherOwner.current 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.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 حاوی این commit ها است.

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

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

رفع اشکال

  • با استفاده از پسوند روش 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 حاوی این commit ها است.

رفع اشکال

  • رفع مسئله در بررسی InvalidFragmentVersionForActivityResult fragmentionforactivityresult بررسی که منجر به مثبت کاذب هنگام استفاده از قطعه 1.3.1 یا بالاتر شد. ( I54DA1 ، B/182388985 )
  • ComponentActivity اکنون هنگام راه اندازی یک Intent از یک ActivityResultContract ، که قبلاً به عنوان یک اضافی در Intent دیگری برگزار می شد ، از یک ClassNotFoundException جلوگیری می کند. ( IEFF05 ، B/182906230 )

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

نسخه 1.2.1

نسخه 1.2.1

10 مارس 2021

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

رفع اشکال

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

تغییرات اساسی از 1.1.0

  • APIS نتیجه فعالیت : ComponentActivity اکنون یک ActivityResultRegistry فراهم می کند که به شما امکان می دهد startActivityForResult() + onActivityResult() و همچنین requestPermissions() + onRequestPermissionsResult() جریان را بدون روش های مهم در فعالیت یا قطعه خود ، افزایش ایمنی نوع را از طریق ActivityResultContract ایجاد می کند و Hooks را فراهم می کند. برای آزمایش این جریان ها. مشاهده به روز شده نتیجه یک فعالیت را مشاهده کنید.

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

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

  • پشتیبانی 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 حاوی این commit ها است.

رفع اشکال

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

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

  • ComponentActivity اکنون ContextAware پیاده سازی می کند و به شما امکان می دهد یک یا چند مورد OnContextAvailableListener اضافه کنید که قبل از Activity.onCreate() پاسخ به تماس دریافت می کنند. ( b/161390636 )
    • یک پسوند Kotlin به حالت تعلیق withContextAvailable() به شما امکان می دهد تا در صورت در دسترس بودن زمینه ، یک بلوک غیر تعلیق را اجرا کنید و نتیجه را برگردانید. ( i8290c )
    • این API توسط FragmentActivity در قطعه 1.3.0-alpha08 برای بازگرداندن وضعیت FragmentManager استفاده می شود. هر شنونده اضافه شده به زیر کلاسهای FragmentActivity بعد از آن شنونده اجرا می شود. ( i513da )
    • این API توسط AppCompatActivity در AppCompat 1.3.0-alpha02 استفاده می شود. هر شنونده اضافه شده به زیر کلاسهای AppCompatActivity پس از آن شنونده اجرا می شود. ( i513da )

رفع اشکال

  • مسئله را با بررسی LINT ActivityResultFragmentVersionDetector بررسی کرد که باعث شکسته شدن آن هنگام استفاده از LINT 27.1.0 یا بالاتر شد. ( b/162155191 )

نسخه 1.2.0-alpha07

22 جولای 2020

androidx.activity:activity:1.2.0-alpha07 و androidx.activity:activity-ktx:1.2.0-alpha07 منتشر می شود. نسخه 1.2.0-alpha07 حاوی این commit ها است.

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

  • اضافه کردن یک نام InvalidFragmentVersionForActivityResult ، بررسی می کند که تأیید می کند که شما هنگام استفاده از API نتیجه فعالیت از قطعه 1.3.0-alpha07 استفاده می کنید ، از تصادفات زمان اجرا به دلیل "کد درخواست نامعتبر" و درخواست های مجوز غیر عملکردی ناشی از استفاده از نسخه های قدیمی تر قطعات جلوگیری می کنید. ( b/152554847 )

سهم خارجی

  • هنگام تجزیه نتایج حاصل از قرارداد نتیجه فعالیت RequestPermission ، یک ArrayIndexOutOfBoundsException برطرف کرد. ( i8f9e3 ، b/161057605 )

نسخه 1.2.0-alpha06

10 ژوئن 2020

androidx.activity:activity:1.2.0-alpha06 و androidx.activity:activity-ktx:1.2.0-alpha06 منتشر می شود. نسخه 1.2.0-alpha06 حاوی این commit ها است.

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

  • اکنون می توانید کلاس ActivityResult را در کوتلین تخریب کنید تا مستقیماً به requestCode و intent دسترسی پیدا کنید. ( b/157212935 )
  • ActivityResultLauncher اکنون به شما امکان می دهد ActivityResultContract را که برای ثبت نام پرتاب استفاده شده است ، دریافت کنید. ( b/156875743 )

تغییرات API

  • Breaking Change : روش invoke() در مورد ActivityResultRegistry به onLaunch() تغییر نام داده است. ( b/157496491 )
  • در صورت عدم بازگشت نتیجه ، قرارداد OpenMultipleDocuments اکنون لیست خالی را به جای null به پاسخ به تماس ثبت شده باز می گرداند. ( b/157348014 )

نسخه 1.2.0-alpha05

20 مه 2020

androidx.activity:activity:1.2.0-alpha05 و androidx.activity:activity-ktx:1.2.0-alpha05 منتشر می شود. نسخه 1.2.0-alpha05 حاوی این commit ها است.

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

تغییرات API

  • قرارداد TakePicture در حال حاضر یک boolean را نشان می دهد که نشان دهنده موفقیت است نه یک Bitmap کوچک ، زیرا این کار به ندرت توسط برنامه های دوربین هنگام نوشتن تصویر به Uri ارائه شده پشتیبانی می شود. ( b/154302879 )
  • پسوندهای invoke() در ActivityResultLauncher به نفع صریح استفاده از launch() حذف شده است تا بهتر نشان دهد که این عملیات ناهمزمان هستند. پسوندهای Kotlin برای launch به androidx.activity.result برای ActivityResultLauncher<Void> و ActivityResultLauncher<Unit> اضافه شده است که به ترتیب ، نیاز به عبور در null یا Unit را حذف می کند ، به ترتیب ، این رفتار را از invoke() قبلی استناد می کند. ( AOSP/1304674 ، AOSP/1304675 )
  • روشهای IntentSenderRequest.Builder برای setFlagsMask() و setFlagsValues() در یک روش setFlags() واحد ترکیب شده است. ( AOSP/1302111 )

رفع اشکال

  • هنگام ثبت نام ActivityResultCallback با یک LifecycleOwner ، مسئله ای را برطرف کرد که در آن تماس تلفنی قبل از STARTED دولت ایجاد می شود. ( AOSP/1309744 )

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

  • ActivityResultRegistry اکنون کدهای درخواست را از 0xFFFF شروع می کند و نه در 0 ، از همپوشانی در هنگام استفاده از startActivityForResult() یا requestPermissions() در یک فعالیت جلوگیری می کند. ( AOSP/1302324 )

نسخه 1.2.0-alpha04

29 آوریل 2020

androidx.activity:activity:1.2.0-alpha04 و androidx.activity:activity-ktx:1.2.0-alpha04 منتشر می شود. نسخه 1.2.0-alpha04 حاوی این commit ها است.

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

  • یک قرارداد اضافه کرد که می تواند StartIntentSenderForresult را به API های ActivityResult فراخوانی کند. ( b/153007517 )

تغییرات API

  • روش prepareCall() به registerForActivityResult() تغییر نام داده شده است ، هم در مورد ComponentActivity در اینجا و هم در قطعه 1.3.0-alpha04 . ( AOSP/1278717 )
  • قراردادهای GetContents ، OpenDocuments و RequestPermissions به ترتیب به GetMultipleContents ، OpenMultipleDocuments و RequestMultiplePermissions تغییر نام داده اند. ( AOSP/1280161 )
  • ComponentActivity اکنون رابط ActivityResultRegisteryOwner را پیاده سازی می کند. ( AOSP/1290888 )
  • - API های startActivityForResult() / onActivityResult() و onRequestPermissionsResult() در ComponentActivity در آن کاهش یافته است. لطفاً از API های نتیجه فعالیت استفاده کنید. ( b/154751887 )

رفع اشکال

  • هنگام استفاده از قراردادهای GetMultipleContents و OpenMultipleDocuments و انتخاب یک مورد واحد ، اکنون به درستی به پاسخ به تماس شما بازگردانده شده است. ( b/152941153 )

نسخه 1.2.0-alpha03

1 آوریل 2020

androidx.activity:activity:1.2.0-alpha03 and androidx.activity:activity-ktx:1.2.0-alpha03 are released. نسخه 1.2.0-alpha03 حاوی این commit ها است.

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

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

نسخه 1.2.0-alpha02

18 مارس 2020

androidx.activity:activity:1.2.0-alpha02 and androidx.activity:activity-ktx:1.2.0-alpha02 are released. نسخه 1.2.0-alpha02 حاوی این commit ها است.

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

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

نسخه 1.2.0-alpha01

4 مارس 2020

androidx.activity:activity:1.2.0-alpha01 and androidx.activity:activity-ktx:1.2.0-alpha01 are released. نسخه 1.2.0-alpha01 حاوی این commit ها است.

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

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

تغییرات مهم از 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.

نسخه 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 .

نسخه 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 .

نسخه 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 .

نسخه 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.

نسخه 1.1.0-alpha03

5 سپتامبر 2019

androidx.activity:activity:1.1.0-alpha03 and androidx.activity:activity-ktx:1.1.0-alpha03 are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.

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

  • Activity now depends on Core 1.1.0 stable.

رفع اشکال

نسخه 1.1.0-alpha02

7 آگوست 2019

androidx.activity:activity:1.1.0-alpha02 and androidx.activity:activity-ktx:1.1.0-alpha02 are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.

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

  • SavedStateViewModelFactory is now the default factory used when using by viewModels() , the ViewModelProvider constructor, or ViewModelProviders.of() with a ComponentActivity ( b/135716331 )

نسخه 1.1.0-alpha01

2 جولای 2019

androidx.activity:activity:1.1.0-alpha01 and androidx.activity:activity-ktx:1.1.0-alpha01 are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.

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

  • activity now depends on 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 )

نسخه 1.0.0

نسخه 1.0.0

5 سپتامبر 2019

androidx.activity:activity:1.0.0 and androidx.activity:activity-ktx:1.0.0 are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.

Major Features of 1.0.0

  • ComponentActivity : ComponentActivity serves as the new base class 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.

نسخه 1.0.0-RC01

2 جولای 2019

androidx.activity:activity:1.0.0-rc01 and androidx.activity:activity-ktx:1.0.0-rc01 are released with no changes from 1.0.0-beta01 . تعهدات موجود در این نسخه را می توان در اینجا یافت.

نسخه 1.0.0-beta01

5 ژوئن 2019

androidx.activity::activity:1.0.0-beta01 and androidx.activity:activity-ktx:1.0.0-beta01 are released with no changes from 1.0.0-alpha08 . تعهدات موجود در این نسخه را می توان در اینجا یافت.

Version 1.0.0-alpha08

7 مه 2019

androidx.activity:activity:1.0.0-alpha08 and androidx.activity:activity-ktx:1.0.0-alpha08 are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.

API تغییر می کند

  • Breaking change: The previously deprecated addOnBackPressedCallback 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. تعهدات موجود در این نسخه را می توان در اینجا یافت.

API تغییر می کند

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

  • The methods for OnBackPressedCallback 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 )

نسخه 1.0.0-alpha06

3 آوریل 2019

androidx.activity:activity:1.0.0-alpha06 and androidx.activity:activity-ktx:1.0.0-alpha06 are released. تعهدات موجود در این نسخه را می توان در اینجا یافت.

API تغییر می کند

  • ComponentActivity now contain a second constructor that takes a @LayoutRes int , which replaces the previous behavior of annotating your AppCompatActivity class with @ContentView . This approach works in both app and library modules. ( b/128352521 )
  • The OnBackPressedCallback related APIs on ComponentActivity have been deprecated in favor of the 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 )

نسخه 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 )

نسخه 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 تغییر می کند

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

نسخه 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 ]

نسخه 1.0.0-alpha02

3 دسامبر 2018

API تغییر می کند

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

نسخه 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 تغییر می کند

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