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 را ارائه می دهد:

این کلاس‌ها نیز به 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 )

/**
  * 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)
  }