النشاط

تحديد الاعتماديات

لإضافة اعتمادية على Activity، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

dependencies {
    def activity_version = "1.11.0"

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

dependencies {
    val activity_version = "1.11.0"

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

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.12

الإصدار 1.12.0-beta01

‫22 أكتوبر 2025

تم إصدار androidx.activity:activity:1.12.0-beta01 وandroidx.activity:activity-compose:1.12.0-beta01 وandroidx.activity:activity-ktx:1.12.0-beta01. يتضمّن الإصدار 1.12.0-beta01 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• إطلاق واجهة برمجة التطبيقات التجريبية ActivityFlags لإدارة تغييرات سلوك وقت التشغيل وعمليات نقل البيانات يتيح الخيار الأول ترتيبًا ثابتًا لـ OnBackPressedCallback، ما يجعل التنقّل للخلف أكثر قابلية للتوقّع عند حدوث تغييرات في مراحل النشاط. يمكن للمطوّرين إيقاف هذه الميزة من خلال ضبط ActivityFlags.isOnBackPressedLifecycleOrderMaintained = false. (I06bdf وId08bb وI439aa وb/422730945 وb/450533622)

تحديث الاعتماديات

• تعديل تبعيات دورة الحياة إلى الإصدار 2.9.4 (Ic9fb2)

الإصدار 1.12.0-alpha09

‫24 سبتمبر 2025

تم إصدار androidx.activity:activity:1.12.0-alpha09 وandroidx.activity:activity-compose:1.12.0-alpha09 وandroidx.activity:activity-ktx:1.12.0-alpha09. يتضمّن الإصدار 1.12.0-alpha09 هذه التعديلات.

التغييرات في الاعتماديات

• يعتمد النشاط الآن على Navigation Event 1.0.0-alpha08.

الإصدار 1.12.0-alpha08

‫10 سبتمبر 2025

تم إصدار androidx.activity:activity:1.12.0-alpha08 وandroidx.activity:activity-compose:1.12.0-alpha08 وandroidx.activity:activity-ktx:1.12.0-alpha08. يتضمّن الإصدار 1.12.0-alpha08 هذه التعديلات.

تحديث الاعتماديات

• يعتمد النشاط الآن على Navigation Event 1.0.0-alpha08.

الإصدار 1.12.0-alpha07

‫27 أغسطس 2025

تم إصدار androidx.activity:activity:1.12.0-alpha07 وandroidx.activity:activity-compose:1.12.0-alpha07 وandroidx.activity:activity-ktx:1.12.0-alpha07. يتضمّن الإصدار 1.12.0-alpha07 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح مشكلة في EdgeToEdge على واجهة برمجة التطبيقات 35، حيث تسبّبت طرق العرض غير المرئية في إدراج قياسات غير متوقّعة. (If49ff)

تحديث الاعتماديات

• يعتمد النشاط الآن على حدث التنقّل 1.0.0-alpha07.

الإصدار 1.12.0-alpha06

‫13 أغسطس 2025

تم إصدار androidx.activity:activity:1.12.0-alpha06 وandroidx.activity:activity-compose:1.12.0-alpha06 وandroidx.activity:activity-ktx:1.12.0-alpha06. يتضمّن الإصدار 1.12.0-alpha06 هذه التعديلات.

تعديل MinSdk

• تم نقل القيمة التلقائية minSdk لـ AndroidX من الإصدار 21 من واجهة برمجة التطبيقات إلى الإصدار 23 (Ibdfca، b/380448311، b/435705964، b/435705223)

تعديلات على المستندات

• تم تعديل مستندات KDocs الخاصة بـ PredictiveBackHandler لتسليط الضوء على مشكلة معروفة في التوقيت، حيث قد تتم معالجة إيماءة في الإطار نفسه الذي تم فيه إيقافها. (I5be5c، b/431534103)
• تم تعديل مستندات KDoc الخاصة بالرمزين BackHandler وPredictiveBackHandler لتوضيح سلوك "الأولوية للأحدث" بالإضافة إلى اقتراح استخدام التركيب غير المشروط مع العلامة enabled. (I7ab94)

تحديث الاعتمادية

• يعتمد النشاط الآن على حدث التنقّل 1.0.0-alpha06.

الإصدار 1.12.0-alpha05

‫30 يوليو 2025

تم إصدار androidx.activity:activity:1.12.0-alpha05 وandroidx.activity:activity-compose:1.12.0-alpha05 وandroidx.activity:activity-ktx:1.12.0-alpha05. يتضمّن الإصدار 1.12.0-alpha05 هذه التعديلات.

تحديث الاعتماديات

• يعتمد النشاط الآن على حدث التنقّل 1.0.0-alpha05.

الإصدار 1.12.0-alpha04

‫2 يوليو 2022

تم إصدار androidx.activity:activity:1.12.0-alpha04 وandroidx.activity:activity-compose:1.12.0-alpha04 وandroidx.activity:activity-ktx:1.12.0-alpha04. يتضمّن الإصدار 1.12.0-alpha04 هذه التعديلات.

التغييرات في الاعتماديات

• يعتمد النشاط الآن على NavigationEvent Alpha04

الإصدار 1.12.0-alpha03

‫18 يونيو 2025

تم إصدار androidx.activity:activity:1.12.0-alpha03 وandroidx.activity:activity-compose:1.12.0-alpha03 وandroidx.activity:activity-ktx:1.12.0-alpha03. يتضمّن الإصدار 1.12.0-alpha03 هذه التعديلات.

إصلاح الأخطاء

• يتم الآن تهيئة كل من OnBackPressedDispatcher وNavigationEventDispatcher بشكل غير مباشر في ComponentActivity. (I710e6)

• تم إصلاح المشاكل في OnBackPressedDistpatcher التي كانت تؤدي إلى ما يلي:

  • سيتم إعلام آخر أداة إرسال تمّت إضافتها إلى OnBackPressedCallback بحالة التفعيل (b/418715930)
  • تزيل OnBackPressedDispatcher دالة رد الاتصال غير الصحيحة عند استخدام الدالة addCallback التي تتضمّن دورة حياة. (b/422714753)
  • لا يؤدي OnBackPressedDispatcher.remove() إلى إزالة جميع مثيلات OnBackPressedCallback مسجَّلة. (b/423024414)

الإصدار 1.12.0-alpha02

‫4 يونيو 2025

تم إصدار androidx.activity:activity:1.12.0-alpha02 وandroidx.activity:activity-compose:1.12.0-alpha02 وandroidx.activity:activity-ktx:1.12.0-alpha02. يتضمّن الإصدار 1.12.0-alpha02 هذه التعديلات.

إصلاح الأخطاء

• من NavigationEvent 1.0.0-alpha02: تم إصلاح ConcurrentModificationException كان من المحتمل أن يحدث عند استدعاء NavigationEventCallback.remove() بسبب تعديل القائمة الداخلية للعناصر القابلة للإغلاق في الوقت نفسه. (I63066)

الإصدار 1.12.0-alpha01

‫20 مايو 2025

تم إصدار androidx.activity:activity:1.12.0-alpha01 وandroidx.activity:activity-compose:1.12.0-alpha01 وandroidx.activity:activity-ktx:1.12.0-alpha01. يتضمّن الإصدار 1.12.0-alpha01 هذه التعديلات.

الميزات الجديدة

• تم دمج ComponentActivity وComponentDialog مع NavigationEvent 1.0.0-alpha01 من خلال واجهة برمجة التطبيقات NavigationEventDispatcherOwner. يمكنك الآن استرداد NavigationEventDispatcher من ComponentActivity من خلال الحقل navigationEventDispatcher. بما أنّه تمت إعادة كتابة OnBackPressedDispatcher فوق المكتبة الجديدة، من المفترض أن تستمر جميع الاستخدامات السابقة في العمل بشكل صحيح. يجب استخدام NavigationEventDispatcher وNavigationEventCallback من الآن فصاعدًا. (Ib8eed وI6cc44 وIb7724 وI9a0f7 وb/412597031 وb/415028038 وb/412596729 وb/412597140 وb/412596012)

الإصدار 1.11

الإصدار 1.11.0

‫10 سبتمبر 2025

تم إصدار androidx.activity:activity:1.11.0 وandroidx.activity:activity-compose:1.11.0 وandroidx.activity:activity-ktx:1.11.0. يتضمّن الإصدار 1.11.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.10.0:

• تمت إضافة واجهة برمجة التطبيقات MediaCapabilities إلى PickVisualMediaRequest للسماح للتطبيقات بتحديد إمكانات الوسائط، مثل أنواع HDR المتوافقة.
• يتم الآن تجميع النشاط باستخدام الإصدار 36 من واجهة برمجة التطبيقات.

الإصدار 1.11.0-rc01

‫23 أبريل 2025

تم إصدار androidx.activity:activity:1.11.0-rc01 وandroidx.activity:activity-compose:1.11.0-rc01 وandroidx.activity:activity-ktx:1.11.0-rc01. يتضمّن الإصدار 1.11.0-rc01 هذه التعديلات.

الإصدار 1.11.0-beta01

‫9 أبريل 2025

تم إصدار androidx.activity:activity:1.11.0-beta01 وandroidx.activity:activity-compose:1.11.0-beta01 وandroidx.activity:activity-ktx:1.11.0-beta01. يتضمّن الإصدار 1.11.0-beta01 هذه التعديلات.

الإصدار 1.11.0-alpha02

‫26 مارس 2025

تم إصدار androidx.activity:activity:1.11.0-alpha02 وandroidx.activity:activity-compose:1.11.0-alpha02 وandroidx.activity:activity-ktx:1.11.0-alpha02. يتضمّن الإصدار 1.11.0-alpha02 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تم دمج EDGE_NONE وframeTimeMillis الجديدَين من الإصدار التجريبي 03 من Android 16 في BackEventCompat الذي توفّره وظائف handleOnBackStarted وhandleOnBackProgressed في OnBackPressedCallback.

تحديثات الاعتماديات

• يتم الآن تجميع النشاط باستخدام الإصدار 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 هذه التعديلات.

الميزات الجديدة

• تمت إضافة واجهة برمجة التطبيقات MediaCapabilities إلى PickVisualMediaRequest للسماح للتطبيقات بتحديد إمكانات الوسائط، مثل أنواع HDR المتوافقة. (Ic3ee7)

الإصدار 1.10

الإصدار 1.10.1

‫26 فبراير 2025

تم إصدار androidx.activity:activity:1.10.1 وandroidx.activity:activity-compose:1.10.1 وandroidx.activity:activity-ktx:1.10.1. يتضمّن الإصدار 1.10.1 هذه التعديلات.

إصلاح الأخطاء

• يمكن الآن حلّ ViewTree OnBackPressedDispatcherOwners وFullyDrawnReporterOwners من خلال العناصر الرئيسية المنفصلة للواجهة، مثل ViewOverlay. لمزيد من المعلومات عن عناصر العرض المنفصلة الرئيسية، يُرجى الاطّلاع على ملاحظات الإصدار الأساسية أو المستندات في ViewTree.setViewTreeDisjointParent. (Ie7750)

الإصدار 1.10.0

‫15 يناير 2025

تم إصدار androidx.activity:activity:1.10.0 وandroidx.activity:activity-compose:1.10.0 وandroidx.activity:activity-ktx:1.10.0. يتضمّن الإصدار 1.10.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.9.0

• يتيح لك PhotoPicker الآن اختيار الصور بالترتيب واختيار علامة التبويب التي يجب أن تكون مرئية في البداية (إما الألبومات أو الصور).
• لم يعُد عقدا PickVisualMedia وPickMultipleVisualMedia Activity Result اللذان يؤديان إلى تشغيل "أداة اختيار الصور" يفوّضان المهام مباشرةً إلى "خدمات Google Play" في حال عدم توفّر "أداة اختيار الصور" في النظام، بل يستخدمان الإجراء ACTION_SYSTEM_FALLBACK_PICK_IMAGES العام والإضافات ذات الصلة لتوفير تجربة متسقة في "أداة اختيار الصور" لمصنّعي المعدات الأصلية وتطبيقات النظام كحلّ احتياطي.
• LocalActivity composition local جديد يوفّر Activity للنطاق الحالي، ما يغني المطوّرين عن الحصول على Activity من LocalContext.

الإصدار 1.10.0-rc01

‫11 ديسمبر 2024

تم إصدار androidx.activity:activity:1.10.0-rc01 وandroidx.activity:activity-compose:1.10.0-rc01 وandroidx.activity:activity-ktx:1.10.0-rc01. يتضمّن الإصدار 1.10.0-rc01 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح مشكلة كانت تؤدي إلى إيقاف معاودة الاتصال على الفور عند تغيير حالة التفعيل أثناء نشاط PredictiveBackHandler. سيكمل الآن عملية رد الاتصال الحالية بغض النظر عن تغييرات الحالة المفعّلة. (Ib8719)

الإصدار 1.10.0-beta01

‫13 نوفمبر 2024

تم إصدار androidx.activity:activity:1.10.0-beta01 وandroidx.activity:activity-compose:1.10.0-beta01 وandroidx.activity:activity-ktx:1.10.0-beta01 بدون أي تغييرات منذ آخر إصدار أولي. يتضمّن الإصدار 1.10.0-beta01 هذه التعديلات.

الإصدار 1.10.0-alpha03

‫30 أكتوبر 2024

تم إصدار androidx.activity:activity:1.10.0-alpha03 وandroidx.activity:activity-compose:1.10.0-alpha03 وandroidx.activity:activity-ktx:1.10.0-alpha03. يتضمّن الإصدار 1.10.0-alpha03 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تمت إضافة LocalActivity جديدة خاصة بالمكوّن المحلي توفّر Activity للنطاق الحالي، ما يغني المطوّرين عن الحصول على Activity من LocalContext. يتضمّن أيضًا قاعدة lint جديدة تتحقّق من الحالات التي يتم فيها تحويل 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 اللذان يؤديان إلى تشغيل "أداة اختيار الصور" يفوّضان المهام مباشرةً إلى "خدمات Google Play" في حال عدم توفّر "أداة اختيار الصور" في النظام، بل يستخدمان الإجراء ACTION_SYSTEM_FALLBACK_PICK_IMAGES العام والإضافات ذات الصلة لتوفير تجربة متسقة في "أداة اختيار الصور" لمصنّعي المعدات الأصلية وتطبيقات النظام كحلّ احتياطي. من المفترض ألا يؤثر ذلك في تجربة المستخدم على الأجهزة التي يتوفّر عليها إصدار حديث من "خدمات Google Play". (I3513d)

إصلاح الأخطاء

• تمت إزالة التحديد اليدوي لإمكانية الوصول إلى واجهات برمجة التطبيقات الجديدة في النظام الأساسي لأنّ ذلك يحدث تلقائيًا من خلال تصميم واجهة برمجة التطبيقات عند استخدام R8 مع الإصدار 7.3 أو إصدار أحدث من "مكوّن Android الإضافي في Gradle" (مثل الإصدار 3.3 من R8) وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "مكوّن Android الإضافي في Gradle" (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون AGP بالتحديث إلى الإصدار 8.1 أو إصدار أحدث من D8. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (I9496c، b/345472586)
• من النشاط 1.9.2: تم إصلاح مشكلة كانت تتسبّب في استمرار واجهة برمجة التطبيقات Activity Compose PredictiveBackHandler في التعامل مع إيماءة الرجوع في النظام على الإطار الذي تم إيقافه، ما قد يؤدي إلى تعامل المكتبات، مثل 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 هذه التعديلات.

إصلاح الأخطاء

• لن يتم تشغيل 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 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح مشكلة كانت تتسبب في استمرار واجهة برمجة التطبيقات Activity Compose PredictiveBackHandler في التعامل مع إيماءة الرجوع في النظام على الإطار الذي تم إيقافه، ما قد يؤدي إلى تعامل المكتبات، مثل 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 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح مشكلة في PredictiveBackHandler حيث يتعذّر تنفيذ onBackPressed من OnBackPressedDispatcher بعد تنفيذ الرجوع إلى الخلف في النظام. (I5f1f8)

الإصدار 1.9.0

‫17 أبريل 2024

تم إصدار androidx.activity:activity:1.9.0 وandroidx.activity:activity-compose:1.9.0 وandroidx.activity:activity-ktx:1.9.0. يتضمّن الإصدار 1.9.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.8.0

• تنفّذ السمة ComponentActivity الآن السمة OnUserLeaveHintProvider للسماح للمكوّنات بتلقّي عمليات ردّ لحدث onUserLeaveHint.
• تُصدر واجهات برمجة التطبيقات OnBackPressedCallback وBackHandler وPredictiveBackHandler الآن تحذيرًا عند استدعاء onBackPressedDispatcher.onBackPressed() أثناء تنفيذ إجراء الرجوع، لأنّ ذلك سيؤدي دائمًا إلى إيقاف الرسوم المتحركة لإيماءة "الرجوع التوقّعي". يمكنك الاطّلاع على دليل أفضل الممارسات لمزيد من التفاصيل.
• تمت إعادة كتابة بقية واجهات برمجة التطبيقات الخاصة بالنشاط في 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 هذه التعديلات.

تحديث الاعتمادية

• يعتمد النشاط الآن على 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 1.9.0-alpha02 بسبب استدعاء OnBackPressedDispatcher كجزء من إنشاء النشاط. (Ie75e3)

الإصدار 1.9.0-alpha03

‫7 فبراير 2024

تم إصدار androidx.activity:activity:1.9.0-alpha03 وandroidx.activity:activity-compose:1.9.0-alpha03 وandroidx.activity:activity-ktx:1.9.0-alpha03. يتضمّن الإصدار 1.9.0-alpha03 هذه التعديلات.

تحذير Lint

• تُصدر واجهات برمجة التطبيقات OnBackPressedCallback وBackHandler وPredictiveBackHandler الآن تحذيرًا عند استدعاء onBackPressedDispatcher.onBackPressed() أثناء تنفيذ إجراء الرجوع، لأنّ ذلك سيؤدي دائمًا إلى إيقاف الرسوم المتحركة لإيماءة "الرجوع التوقّعي". يمكنك الاطّلاع على دليل أفضل الممارسات لمزيد من التفاصيل. (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 هذه التعديلات.

Kotlin Conversions

• تمت إعادة كتابة ActivityResultRegistry بلغة Kotlin. يضمن ذلك أنّه سيتم تمرير إمكانية القيم الخالية للأنواع العامة في العقد الذي تم تمريره إلى register بشكل صحيح إلى ActivityResultLauncher التي تم إرجاعها إليك. (I121f0)
• تمت إعادة كتابة ActivityResult بلغة Kotlin. تم نقل إضافات Kotlin الخاصة بـ ActivityResult التي تتيح التقسيم إلى الحقلَين resultCode وdata من activity-ktx إلى activity. (I0565a)
• تم نقل إضافات Kotlin الخاصة بـ by viewModels() لكل من ComponentActivity وtrackPipAnimationHintView من activity-ktx إلى activity. أصبح عنصر activity-ktx فارغًا تمامًا الآن. (I0a444)

إصلاح الأخطاء

• ترسم واجهة برمجة التطبيقات enableEdgeToEdge الآن حول أيّ فتحات عرض. (a3644b، b/311173461)
• من النشاط 1.8.2: تم إصلاح البيانات الإضافية التي تم تمريرها إلى ACTION_SYSTEM_FALLBACK_PICK_IMAGES في "عقد نشاط أداة اختيار الصور" لتمريرها بشكل صحيح باستخدام المفتاح EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX، بدلاً من استخدام البيانات الإضافية مع المفتاح "com.google.android.gms.provider.extra.PICK_IMAGES_MAX". ننصح بشدة باستخدام كليهما إذا كنت من مصنّعي المعدات الأصلية الذين ينفّذون أداة احتياطية لاختيار الصور في النظام لضمان التوافق على نطاق واسع. (I96a00)

الإصدار 1.9.0-alpha01

‫29 نوفمبر 2023

تم إصدار androidx.activity:activity:1.9.0-alpha01 وandroidx.activity:activity-compose:1.9.0-alpha01 وandroidx.activity:activity-ktx:1.9.0-alpha01. يتضمّن الإصدار 1.9.0-alpha01 هذه التعديلات.

الميزات الجديدة

• تنفّذ السمة ComponentActivity الآن السمة OnUserLeaveHintProvider للسماح للمكوّنات بتلقّي عمليات ردّ لحدث onUserLeaveHint. (I54892)

تغييرات واجهة برمجة التطبيقات

• تمت إعادة كتابة ComponentActivity بلغة Kotlin. (I14f31)
• تمت إعادة كتابة ActivityResultCaller بلغة Kotlin. (Ib02e4)
• تمت إعادة كتابة ActivityResultLauncher بلغة Kotlin. في إطار عملية التحويل هذه، أصبح الإجراء getContract الآن سمة Kotlin مجرّدة. هذا تغيير متوافق مع النظام الثنائي، ولكنّه يؤدي إلى تعذُّر تجميع الرمز البرمجي إذا كان تنفيذ ActivityResultLauncher مكتوبًا بلغة Kotlin. (Id4615)
• يستهدف PickVisualMediaRequest الآن المستوى 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 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح البيانات الإضافية التي تم تمريرها إلى ACTION_SYSTEM_FALLBACK_PICK_IMAGES في "عقد نشاط أداة اختيار الصور" لتمرير المفتاح EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX إليها بشكل صحيح، بدلاً من استخدام البيانات الإضافية مع المفتاح "com.google.android.gms.provider.extra.PICK_IMAGES_MAX". ننصح بشدة باستخدام كليهما إذا كنت من مصنّعي المعدات الأصلية الذين ينفّذون أداة احتياطية لاختيار الصور في النظام لضمان التوافق على نطاق واسع. (I96a00)

الإصدار 1.8.1

‫15 تشرين الثاني (نوفمبر) 2023

تم إصدار androidx.activity:activity:1.8.1 وandroidx.activity:activity-compose:1.8.1 وandroidx.activity:activity-ktx:1.8.1. يتضمّن الإصدار 1.8.1 هذه التعديلات.

إصلاح الأخطاء

• تواصل OnBackPressedDispatcher الآن إرسال البيانات إلى OnBackPressedCallback الصحيح حتى بعد إضافة OnBackPressedCallback جديد أثناء معالجة الإيماءة السابقة. (Id0ff6)

الإصدار 1.8.0

‫4 أكتوبر 2023

تم إصدار androidx.activity:activity:1.8.0 وandroidx.activity:activity-compose:1.8.0 وandroidx.activity:activity-ktx:1.8.0. يتضمّن الإصدار 1.8.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.7.0

• إيماءة إظهار شاشة الرجوع: يوفّر OnBackPressedCallback الآن عمليات ردّ اتصال جديدة خاصة بميزة "إيماءة إظهار شاشة الرجوع" للتعامل مع بدء إيماءة الرجوع والتقدّم خلال الإيماءة وإلغاء إيماءة الرجوع، بالإضافة إلى عملية ردّ الاتصال السابقة handleOnBackPressed() التي يتم تنفيذها عند تأكيد إيماءة الرجوع. يتضمّن ذلك أيضًا PredictiveBackHandler Composable للتعامل مع أحداث إيماءة الرجوع التوقّعية في Activity Compose. يوفّر هذا الإجراء مجموعة من عناصر BackEventCompat التي يجب جمعها في دالة lambda المعلقة التي تقدّمها:

  PredictiveBackHandler { progress: Flow<BackEventCompat> ->
    // code for gesture back started
    try {
      progress.collect { backEvent ->
      // code for progress
    }
    // code for completion
    } catch (e: CancellationException) {
      // code for cancellation
    }
  }

تم الآن إيقاف ComponentActivity.onBackPressed() نهائيًا واستبداله بواجهات برمجة التطبيقات المخصّصة للتعامل مع الرجوع. على المطوّرين الآن استخدام OnBackPressedDispatcher بدلاً من إلغاء هذه الطريقة.

• EdgeToEdge: تمت إضافة ComponentActivity.enableEdgeToEdge() لتسهيل إعداد العرض من الحافة إلى الحافة بطريقة متوافقة مع الإصدارات القديمة.

الإصدار 1.8.0-rc01

‫20 سبتمبر 2023

تم إصدار androidx.activity:activity:1.8.0-rc01 وandroidx.activity:activity-compose:1.8.0-rc01 وandroidx.activity:activity-ktx:1.8.0-rc01. يتضمّن الإصدار 1.8.0-rc01 هذه التعديلات.

الإصدار 1.8.0-beta01

‫6 سبتمبر 2023

تم إصدار androidx.activity:activity:1.8.0-beta01 وandroidx.activity:activity-compose:1.8.0-beta01 وandroidx.activity:activity-ktx:1.8.0-beta01. يتضمّن الإصدار 1.8.0-beta01 هذه التعديلات.

تحسين المستندات

• تم تحسين مستندات BackEventCompat. (aosp/2722254)

الإصدار 1.8.0-alpha07

‫23 أغسطس 2023

تم إصدار androidx.activity:activity:1.8.0-alpha07 وandroidx.activity:activity-compose:1.8.0-alpha07 وandroidx.activity:activity-ktx:1.8.0-alpha07. يتضمّن الإصدار 1.8.0-alpha07 هذه التعديلات.

الميزات الجديدة

• أضافت Activity Compose PredictiveBackHandler قابلاً للإنشاء جديدًا للتعامل مع أحداث إيماءة الرجوع التوقّعية. توفّر هذه السمة Flow من عناصر BackEventCompat التي يجب جمعها في دالة lambda المعلقة التي تقدّمها:

  PredictiveBackHandler { progress: Flow<BackEventCompat> ->
    // code for gesture back started
    try {
      progress.collect { backEvent ->
      // code for progress
    }
    // code for completion
    } catch (e: CancellationException) {
      // code for cancellation
    }
  }
  

  ويأتي أيضًا مع تحذير في وقت الترجمة البرمجية من خلال قاعدة lint لضمان تنفيذ طلبات Flow collect(). (Id2773، b/294884345)

• تم الآن تهيئة onBackPressedDispatcher في ComponentActivity بشكل غير مباشر، وبالتالي لا يتم إنشاؤه إلا عند الحاجة. (I0bf8e)

إصلاح الأخطاء

• لن يعرض ComponentActivity خطأ NPE على نظام التشغيل Android 13 عندما يتلقّى ردّ اتصال onBackPressed() وتمّت DESTROYED "الحزمة" من قبل. (Idb055، b/291869278)
• تمت إزالة استخدامات واجهة برمجة التطبيقات التجريبية isAtLeastU() (Ie9117، b/289269026)

الإصدار 1.8.0-alpha06

‫21 حزيران (يونيو) 2023

تم إصدار androidx.activity:activity:1.8.0-alpha06 وandroidx.activity:activity-compose:1.8.0-alpha06 وandroidx.activity:activity-ktx:1.8.0-alpha06. يتضمّن الإصدار 1.8.0-alpha06 هذه التعديلات.

الميزات الجديدة

• يعمل OnBackPressedDispatcher الآن على إلغاء أي عمليات ردّ يتم إزالتها أثناء استخدام ميزة "الرجوع التوقعي" بشكل صحيح. (I3f90f)

تغييرات واجهة برمجة التطبيقات

• عند تمرير SystemBarStyle.auto إلى واجهة برمجة التطبيقات enableEdgeToEdge، يمكنك الآن تجاهل مَعلمة 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. تم تطوير هذا الإصدار في فرع داخلي.

تغييرات واجهة برمجة التطبيقات

• توفّر Activity الآن فئة BackEventCompat تعمل كإصدار متوافق مع الإصدارات القديمة من BackEvent، وهو إصدار منفصل عن فئة BackEvent في إطار العمل.
• تغيير غير متوافق: تتلقّى الطريقتان handleOnBackStarted وhandleOnBackProgressed في OnBackPressedCallback الآن مثيلاً من androidx.activity.BackEventCompat بدلاً من فئة android.window.BackEvent في إطار العمل. تم أيضًا تعديل واجهات برمجة التطبيقات المكافئة @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. تم إصدار هذا التحديث من فرع داخلي.

إصلاح الأخطاء

• من الإصدار 1.7.1 من Activity: - لم يعُد 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() لتسهيل إعداد العرض من الحافة إلى الحافة بطريقة متوافقة مع الإصدارات القديمة.

تغييرات واجهة برمجة التطبيقات

• تم الآن إيقاف ComponentActivity.onBackPressed() نهائيًا واستبداله بواجهات برمجة التطبيقات المخصّصة للتعامل مع الرجوع. على المطوّرين الآن استخدام OnBackPressedDispatcher بدلاً من إلغاء هذه الطريقة. (Ibce2f، b/271596918)
• يحتوي ComponentDialog وComponentActivity الآن على واجهة برمجة تطبيقات عامة initViewTreeOwners() يمكن استخدامها لتهيئة جميع مالكي شجرة العرض قبل ضبط عرض المحتوى. (Ibdce0، b/261314581)

إصلاح الأخطاء

• تم إصلاح مشكلة كانت تؤدي إلى إبطال صحة MenuHost بشكل غير صحيح وتتسبب في سلوك غير متوقّع للقوائم الأخرى في النشاط. (I9404e، b/244336571)

التغييرات الأخرى

• يستخدم ActivityResultRegister الآن Random من Kotlin بدلاً من Java. (I4d98f، b/272096025)

الإصدار 1.8.0-alpha02

‫8 مارس 2023

تم إصدار androidx.activity:activity:1.8.0-alpha02 وandroidx.activity:activity-compose:1.8.0-alpha02 وandroidx.activity:activity-ktx:1.8.0-alpha02. تم تطويره من فرع داخلي.

تحديث الاعتمادية

• من النشاط 1.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 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح الخطأ ReportDrawn الذي يحدث عند الانتقال من شاشة قبل استدعاء report. (Ic46f1، b/260506820)

الإصدار 1.7.1

‫19 أبريل 2023

تم إصدار androidx.activity:activity:1.7.1 وandroidx.activity:activity-compose:1.7.1 وandroidx.activity:activity-ktx:1.7.1. يتضمّن الإصدار 1.7.1 هذه التعديلات.

إصلاح الأخطاء

• لم يعُد ReportFullyDrawExecuter يتسرّب عند استخدام ComponentActivity مع ActivityScenario. (Id2ff2، b/277434271)

الإصدار 1.7.0

‫22 مارس 2023

تم إصدار androidx.activity:activity:1.7.0 وandroidx.activity:activity-compose:1.7.0 وandroidx.activity:activity-ktx:1.7.0. يتضمّن الإصدار 1.7.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.6.0

• تم تعديل عقود نشاط "أداة اختيار الصور" في الإصدارَين PickVisualMedia وPickMultipleVisualMedia لتتضمّن خيارًا احتياطيًا إضافيًا في حال عدم توفّر MediaStore.ACTION_PICK_IMAGES، ما يتيح لمصنّعي المعدات الأصلية وتطبيقات النظام، مثل "خدمات Google Play"، تقديم تجربة متسقة لاستخدام "أداة اختيار الصور" على مجموعة أكبر من أجهزة Android ومستويات واجهة برمجة التطبيقات من خلال تنفيذ الإجراء الاحتياطي. سيستخدم "أداة اختيار الصور" هذا الخيار الاحتياطي إذا كان متاحًا قبل الرجوع إلى استخدام Intent.ACTION_OPEN_DOCUMENT، الذي يظل متوافقًا مع جميع الأجهزة التي تعمل بالإصدار 19 من واجهة برمجة التطبيقات أو الإصدارات الأحدث.
• تنفّذ ComponentDialog الآن SavedStateRegistryOwner ويمكنها الوصول إلى SavedStateRegistry الخاص بها وتضبط SavedStateRegistryOwner على ViewTree. يمكن الآن استخدام Jetpack Compose ضِمن ComponentDialog لأنّه يستوفي كلاً من LifecycleOwner وSavedStateRegistryOwner المرفقَين بالنافذة من خلال متطلبات واجهات برمجة التطبيقات ViewTree.
• تتيح لك IntentSenderRequest.Builder.setFlags() الآن ضبط علامات متعدّدة من Intent، بدلاً من علامة واحدة فقط.

تحويل Kotlin

تم تحويل عدد من فئات النشاط إلى Kotlin. تحتفظ جميع الفئات المحوَّلة بتوافقها الثنائي مع الإصدارات السابقة. تتضمّن الفئات التالية تغييرات غير متوافقة مع المصدر للفئات المكتوبة بلغة Kotlin: ActivityResultRegistryOwner وOnBackPressedDispatcherOwner.

يقدّم الجدول أدناه الإحالات الناجحة المصدر للإصدار الجديد من "السجلّ":

تم أيضًا تحويل هذه الفئات إلى Kotlin، ولكنها تظل متوافقة مع المصدر: ContextAware وContextAwareHelper وOnContextAvailableListener وIntentSenderRequest وOnBackPressedDispatcher

واجهات برمجة التطبيقات FullyDrawnReporter

توفّر السمة ComponentActivity الآن مثيلاً من FullyDrawnReporter يسمح لمكوّنات متعدّدة بالإبلاغ عن جاهزيتها للتفاعل. ستنتظر الدالة ComponentActivity إلى أن تكتمل جميع المكوّنات قبل استدعاء الدالة reportFullyDrawn() نيابةً عنك. تتولّى واجهات برمجة التطبيقات هذه متطلبات التوقيت نيابةً عنك، ولا يلزم استدعاؤها كجزء من طلب onDraw.

ننصح بتفعيل واجهات برمجة التطبيقات التالية:

• إرسال إشارة إلى "وقت تشغيل Android" عند اكتمال عملية بدء التشغيل، وذلك لضمان تضمين جميع الرموز التي يتم تنفيذها أثناء تسلسل بدء التشغيل المتعدّد اللقطات وتحديد أولويتها في عملية التجميع في الخلفية
• إرسال إشارة إلى Macrobenchmark وPlay Vitals عند اعتبار تطبيقك مرسومًا بالكامل بالنسبة إلى مقاييس بدء التشغيل، ما يتيح لك تتبُّع الأداء

تمت إضافة ثلاث واجهات برمجة تطبيقات Activity Compose لتسهيل استخدام FullyDrawnReporter من عناصر فردية قابلة للإنشاء:

• يشير ReportDrawn إلى أنّ العنصر القابل للإنشاء جاهز للتفاعل على الفور.
• يأخذ 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 هذه التعديلات.

تحديث الاعتمادية

• يعتمد النشاط الآن على 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• إنّ الإجراء والبيانات الإضافية المستخدَمة في عقود PickVisualMedia وPickMultipleVisualMedia كحلّ احتياطي عندما لا يتوفّر MediaStore.ACTION_PICK_IMAGES هي الآن ثوابت عامة توفّر ثبات واجهة برمجة التطبيقات لمصنّعي المعدات الأصلية وتطبيقات النظام التي تريد توفير تجربة متّسقة في "أداة اختيار الصور". لا يزال استخدام هذا الخيار الاحتياطي مقتصرًا على تطبيقات النظام فقط. (Icd320)

الإصدار 1.7.0-beta01

‫8 شباط (فبراير) 2023

تم إصدار androidx.activity:activity:1.7.0-beta01 وandroidx.activity:activity-compose:1.7.0-beta01 وandroidx.activity:activity-ktx:1.7.0-beta01. يتضمّن الإصدار 1.7.0-beta01 هذه التعديلات.

الميزات الجديدة

• تتيح لك IntentSenderRequest.Builder.setFlags() الآن ضبط علامات متعدّدة من Intent، بدلاً من علامة واحدة فقط. (Iac04c)

إصلاح الأخطاء

• يقتصر الآن استخدام PickVisualMedia في حال عدم توفّر إطار عمل "أداة اختيار الصور" على التطبيقات المثبَّتة في صورة نظام الجهاز. (If8ae6)

Kotlin Conversions

• تمت إعادة كتابة ActivityResultRegistryOwner بلغة Kotlin. هذا تغيير غير متوافق مع المصدر للفئات المكتوبة بلغة Kotlin، ويجب الآن إلغاء الخاصية activityResultRegistry بدلاً من تنفيذ الدالة getActivityResultRegistry() السابقة. (I0b00e)
• تمت إعادة كتابة OnBackPressedDispatcherOwner بلغة Kotlin. هذا تغيير غير متوافق مع المصدر للفئات المكتوبة بلغة Kotlin، ويجب الآن إلغاء الخاصية onBackPressedDispatcher بدلاً من تنفيذ الدالة getOnBackPressedDispatcher السابقة. (Ia277d)
• تمت إعادة كتابة ContextAware وContextAwareHelper وOnContextAvailableListener وIntentSenderRequest وOnBackPressedDispatcher بلغة Kotlin. (I1a73e وIada92 وaosp/2410754 وI18ac7 وb/257291701)

الإصدار 1.7.0-alpha04

‫25 كانون الثاني (يناير) 2023

تم إصدار androidx.activity:activity:1.7.0-alpha04 وandroidx.activity:activity-compose:1.7.0-alpha04 وandroidx.activity:activity-ktx:1.7.0-alpha04. يتضمّن الإصدار 1.7.0-alpha04 هذه التعديلات.

الميزات الجديدة

• سيستخدم عقدا PickVisualMedia وPickMultipleVisualMedia لنتائج الأنشطة الآن أداة اختيار الصور التي توفّرها "خدمات Google Play" حيثما كان ذلك متاحًا في الحالات التي توفّر فيها أداة اختيار الصور في نظام التشغيل Android (مثل MediaStore.ACTION_PICK_IMAGES) غير متوفّرة. تم إيقاف واجهة برمجة التطبيقات isPhotoPickerAvailable() نهائيًا، وهي واجهة برمجة تطبيقات ترصد فقط أداة اختيار الصور التي يوفّرها نظام التشغيل Android. يُنصح باستخدام واجهة برمجة التطبيقات الجديدة 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 هذه التعديلات.

الميزات الجديدة

• تستخدم ComponentDialog الآن SavedStateRegistryOwner ويمكنها الوصول إلى SavedStateRegistry الخاص بها وتضبط SavedStateRegistryOwner لـ ViewTree. يمكن الآن استخدام Jetpack Compose ضِمن ComponentDialog لأنّه يستوفي متطلبات LifecycleOwner وSavedStateRegistryOwner المرفقة بالنافذة من خلال واجهات برمجة التطبيقات ViewTree. (Idca17، I73468 b/261162296)

تغييرات واجهة برمجة التطبيقات

• تمت إضافة ReportDrawn عنصر قابل للإنشاء يشير على الفور إلى أنّ النشاط جاهز لإجراء مكالمة reportFullyDrawn. (Ic5b14، b/259687964)

Kotlin Conversions

• تم تحويل الفئتين 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 هذه التعديلات.

إصلاح الأخطاء

• من النشاط 1.6.1: تم إصلاح مشكلة عدم إطلاق عقد PickMultipleVisualMedia Activity Result على أجهزة Android R عند استخدام القيمة التلقائية لـ maxItems. (Ie2776، b/249182130)

الإصدار 1.7.0-alpha01

‫5 أكتوبر 2022

تم إصدار androidx.activity:activity:1.7.0-alpha01 وandroidx.activity:activity-compose:1.7.0-alpha01 وandroidx.activity:activity-ktx:1.7.0-alpha01. يتضمّن الإصدار 1.7.0-alpha01 هذه التعديلات.

واجهات برمجة التطبيقات FullyDrawnReporter

توفّر السمة ComponentActivity الآن مثيلاً من FullyDrawnReporter يسمح لمكوّنات متعدّدة بالإبلاغ عن جاهزيتها للتفاعل. ستنتظر الدالة ComponentActivity إلى أن تكتمل جميع المكوّنات قبل استدعاء الدالة reportFullyDrawn() نيابةً عنك. تتولّى واجهات برمجة التطبيقات هذه متطلبات التوقيت نيابةً عنك، ولا يلزم استدعاؤها كجزء من طلب onDraw.

ننصح بتفعيل واجهات برمجة التطبيقات التالية:

• إرسال إشارة إلى "وقت تشغيل Android" عند اكتمال عملية بدء التشغيل، وذلك لضمان تضمين جميع الرموز التي يتم تنفيذها أثناء تسلسل بدء التشغيل المتعدّد اللقطات وتحديد أولويتها في عملية التجميع في الخلفية
• إرسال إشارة إلى Macrobenchmark وPlay Vitals عند اعتبار تطبيقك مرسومًا بالكامل بالنسبة إلى مقاييس بدء التشغيل، ما يتيح لك تتبُّع الأداء

تمت إضافة واجهتَي برمجة تطبيقات 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 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح مشكلة عدم إطلاق عقد PickMultipleVisualMedia Activity Result على أجهزة Android R عند استخدام القيمة التلقائية لـ maxItems. (Ie2776، b/249182130)

الإصدار 1.6.0

الإصدار 1.6.0

‫21 سبتمبر 2022

تم إصدار androidx.activity:activity:1.6.0 وandroidx.activity:activity-compose:1.6.0 وandroidx.activity:activity-ktx:1.6.0. يتضمّن الإصدار 1.6.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.5.0

• تمت إضافة ActivityResultContracts.PickVisualMedia وActivityResultContracts.PickMultipleVisualMedia لتوفير عقد متوافق مع الإصدارات القديمة يستخدم MediaStore.ACTION_PICK_IMAGES عندما تكون أداة اختيار الصور متاحة وIntent.ACTION_OPEN_DOCUMENT عندما لا تكون متاحة.
• تم دمج OnBackInvokedCallback في الإصدار 13 من نظام التشغيل Android مع OnBackPressedDispatchers المقدَّم من ComponentActivity وComponentDialog. يضمن ذلك عمل جميع واجهات برمجة التطبيقات المستندة إلىOnBackPressedDispatcher عند تفعيل إيماءة الرجوع التوقّعية.

الإصدار 1.6.0-rc02

‫7 أيلول (سبتمبر) 2022

تم إصدار androidx.activity:activity:1.6.0-rc02 وandroidx.activity:activity-compose:1.6.0-rc02 وandroidx.activity:activity-ktx:1.6.0-rc02. يتضمّن الإصدار 1.6.0-rc02 هذه التعديلات.

إصلاح الأخطاء

• يسجّل OnBackPressedDispatcher الآن OnBackInvokedCallback باستخدام PRIORITY_DEFAULT بدلاً من PRIORITY_OVERLAY. (I3901f)
• سيتم الآن دائمًا إرسال كلتا وظيفتَي رد الاتصال onMultiWindowModeChanged() في الصفوف التي تمتد إلى ComponentActivity. (Ic4d85)
• لن تعرض ActivityResultRegistry أي نتيجة لـ ActivityResultCallback عندما يعرض طلب launch أي Exception وتم تسجيل برنامج معالجة بدون LifecycleOwner. (Ia7ff7، b/238350794)
• سترسل ComponentActivity الآن طلبات القائمة بشكل صحيح بدون الحاجة إلى طلب الدالة الفائقة في نشاطك. (Ie33c5، b/238057118)

تحديث الاعتماديات

• تعتمد مكتبة Activity الآن على Lifecycle 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 إلى حدوث ClassVerificationError عند استخدام إصدارات حزمة SDK الأقدم من 33. (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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تم وضع علامة @NonNull على الطريقتَين المتوقّفتَين نهائيًا startActivityForResult وstartIntentSenderForResult في ComponentActivity لأنّ تمرير 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 في فرع خاص قبل الإصدار، ولا يتضمّن أي تعديلات علنية.

تغييرات واجهة برمجة التطبيقات

• أصبح minCompileSdk الآن 33 ليتوافق مع الإصدار التجريبي 3 من حزمة تطوير البرامج (SDK) لنظام التشغيل Tiramisu

إصلاح الأخطاء

• تم إصلاح عُطل على الأجهزة القديمة عند إجراء عملية التحقّق من إضافة حزمة SDK إلى PickVisualMedia ActivityResultContract، وبالتالي من المفترض أن تعمل الآن مع ACTION_OPEN_DOCUMENT على الأجهزة التي تعمل بالإصدار Android 10 والإصدارات الأقدم.

الإصدار 1.6.0-alpha04

‫18 مايو 2022

تم طرح androidx.activity:activity:1.6.0-alpha04 وandroidx.activity:activity-ktx:1.6.0-alpha04.

إصلاح الأخطاء

• تم إصلاح خطأ في PickVisualMediaRequest كان يؤدي إلى حدوث خطأ تجاوز سعة التخزين المؤقت عند محاولة إنشاء طلب، سواء من خلال "أداة الإنشاء" أو دالة Kotlin ذات المستوى الأعلى.
• تم دمج OnBackInvokedCallback في الإصدار التجريبي الثاني من Android 13 للمطوّرين ضمن OnBackPressedDispatcher الذي توفّره ComponentDialog. يضمن ذلك عمل جميع واجهات برمجة التطبيقات المستندة إلى 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.

• ملاحظة: لن يتم تجميع هذا الإصدار إلا باستخدام حزمة تطوير البرامج (SDK) للإصدار التجريبي الأول من Android 13.

الميزات الجديدة

• تمت إضافة ActivityResultContracts.PickVisualMedia وActivityResultContracts.PickMultipleVisualMedia لتوفير عقد متوافق مع الإصدارات القديمة يستخدم MediaStore.ACTION_PICK_IMAGES عندما تكون أداة اختيار الصور متاحة وIntent.ACTION_OPEN_DOCUMENT عندما لا تكون متاحة.
• تم دمج OnBackInvokedCallback في الإصدار التجريبي الأول من Android 13 للمطوّرين مع OnBackPressedDispatcher الذي توفّره ComponentActivity. يضمن ذلك عمل جميع واجهات برمجة التطبيقات المستندة إلى OnBackPressedDispatcher عند تفعيل إيماءة الرجوع التوقّعية.

الإصدار 1.6.0-alpha01

‫23 مارس 2022

تم إصدار androidx.activity:activity:1.6.0-alpha01 وandroidx.activity:activity-compose:1.6.0-alpha01 وandroidx.activity:activity-ktx:1.6.0-alpha01.

• ملاحظة: لن يتم تجميع هذا الإصدار إلا باستخدام حزمة تطوير البرامج (SDK) لإصدار "معاينة المطوّرين 2" من نظام التشغيل Android 13.

الميزات الجديدة

• تم دمج التغييرات في الإصدار التجريبي الثاني من نظام التشغيل Android 13 في ComponentActivity.

الإصدار 1.5.1

الإصدار 1.5.1

‫27 يوليو 2022

تم إصدار androidx.activity:activity:1.5.1 وandroidx.activity:activity-compose:1.5.1 وandroidx.activity:activity-ktx:1.5.1. يتضمّن الإصدار 1.5.1 هذه التعديلات.

إصلاح الأخطاء

• لن تعرض الدالة ActivityResultRegistry نتيجة للدالة ActivityResultCallback عندما تعرض المكالمة launch() أي Exception وتم تسجيل الدالة بدون LifecycleOwner. (Ia7ff7، b/238350794)

• سترسل ComponentActivity الآن طلبات القائمة بشكل صحيح إلى عمليات الإلغاء في onPrepareOptionMenu() وonCreateOptionsMenu() وonOptionsItemSelected() بدون الحاجة إلى استدعاء الدالة الرئيسية. (Ie33c5، b/238057118)

تحديث الاعتمادية

• تعتمد مكتبة Activity الآن على 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 و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 في Lifecycle 2.5.0.

التغييرات الأخرى

• تم إيقاف طريقة وضع التصميم التي لا تتضمّن مَعلمات في ActivityResultContracts.CreateDocument نهائيًا واستبدالها بطريقة وضع تصميم جديدة تتضمّن نوع MIME ملموسًا (مثل "image/png") كما هو مطلوب من خلال Intent.ACTION_CREATE_DOCUMENT.

الإصدار 1.5.0-rc01

‫11 مايو 2022

تم إصدار الإصدارات androidx.activity:activity:1.5.0-rc01 وandroidx.activity:activity-compose:1.5.0-rc01 وandroidx.activity:activity-ktx:1.5.0-rc01 بدون أي تغييرات عن الإصدار 1.5.0-beta01. يتضمّن الإصدار 1.5.0-rc01 هذه التعديلات.

الإصدار 1.5.0-beta01

‫20 أبريل 2022

تم إصدار androidx.activity:activity:1.5.0-beta01 وandroidx.activity:activity-compose:1.5.0-beta01 وandroidx.activity:activity-ktx:1.5.0-beta01. يتضمّن الإصدار 1.5.0-beta01 هذه التعديلات.

تحديثات الاعتماديات

• يعتمد النشاط الآن على Lifecycle 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() الفائق من خلال onPanelClosed() في ComponentActivity أيضًا، ما يؤدي إلى حلّ المشكلة التي كانت تتسبّب في عدم استدعاء الطريقة 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• يمكنك الآن تمرير CreationExtras إلى وظيفة النشاط by viewModels() (I6a3e6، b/217600303)

الإصدار 1.5.0-alpha02

‫9 فبراير 2022

تم إصدار androidx.activity:activity:1.5.0-alpha02 وandroidx.activity:activity-compose:1.5.0-alpha02 وandroidx.activity:activity-ktx:1.5.0-alpha02. يتضمّن الإصدار 1.5.0-alpha02 هذه التعديلات.

الميزات الجديدة

• تنفّذ ComponentActivity الآن واجهة OnPictureInPictureModeChangedProvider للسماح لأي مكون بتلقّي أحداث تغيير وضع "نافذة ضمن النافذة". (I9f567)
• تنفِّذ السمة ComponentActivity الآن الواجهة OnMultiWindowModeChangedProvider للسماح لأي مكوّن بتلقّي أحداث تغيير وضع النوافذ المتعدّدة. (I62d91)

الإصدار 1.5.0-alpha01

‫26 يناير 2022

تم إصدار androidx.activity:activity:1.5.0-alpha01 وandroidx.activity:activity-compose:1.5.0-alpha01 وandroidx.activity:activity-ktx:1.5.0-alpha01. يتضمّن الإصدار 1.5.0-alpha01 هذه التعديلات.

الميزات الجديدة

• يتكامل ComponentActivity الآن مع ViewModel CreationExtras، الذي تم تقديمه كجزء من Lifecycle 2.5.0-alpha01. (Ie7e00، b/207012584)
• تمت إضافة ComponentDialog، وهي فئة فرعية من Dialog تتضمّن OnBackPressedDispatcher سيتم استدعاؤها عند الضغط على زر الرجوع في النظام عندما يكون مربّع الحوار مرئيًا. من المهم أيضًا أنّ هذه الفئة الفرعية تضبط ViewTreeOnBackPressedDispatcherOwner، ما يتيح طرقًا عامة للعناصر المعروضة لاسترداد أداة الإرسال الصحيحة سواء كانت متوفّرة في ComponentActivity أو ComponentDialog. (I8a1bc)
• تستخدم السمة ComponentActivity الآن واجهة OnNewIntentProvider الجديدة للسماح لأي مكوّن بتلقّي هذه الأحداث. (If1f8b)
• تستخدم السمة ComponentActivity الآن واجهة OnConfigurationChangedProvider الجديدة للسماح لأي مكوّن بتلقّي هذه الأحداث. (If623b)
• تستخدم ComponentActivity الآن واجهة OnTrimMemoryProvider الجديدة للسماح لأي مكوّن بتلقّي هذه الأحداث. (Ia9295)

تغييرات واجهة برمجة التطبيقات

• تم إيقاف دالة إنشاء بدون مَعلمات الخاصة بالفئة ActivityResultContracts.CreateDocument نهائيًا واستبدالها بدالة إنشاء جديدة تقبل نوع MIME محددًا (مثل "image/png") على النحو المطلوب بموجب Intent.ACTION_CREATE_DOCUMENT. (I2bec6)
• يمكن الآن استرداد OnBackPressedDispatcherOwner المرتبط بواجهة عرض من خلال ViewTreeOnBackPressedDispatcherOwner بدلاً من الاعتماد على تحويل Context إلى نوع آخر. (I74685)

إصلاح الأخطاء

• تم إصلاح عُطل كان يحدث عند الوصول إلى ViewModel للمرة الأولى من خلال registerForActivityResult() ردّ الاتصال أو ردود الاتصال إلى LifecycleObserver التي تمت إضافتها كجزء من init في ComponentActivity. (Ife83f)

الإصدار 1.4.0

الإصدار 1.4.0

‫27 أكتوبر 2021

تم إصدار androidx.activity:activity:1.4.0 وandroidx.activity:activity-compose:1.4.0 وandroidx.activity:activity-ktx:1.4.0. يتضمّن الإصدار 1.4.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.3.0

• تنفّذ مكتبة AndroidX ComponentActivity الآن الواجهة MenuHost. يتيح ذلك لأي مكوّن إضافة عناصر قائمة إلى ActionBar من خلال إضافة مثيل MenuProvider إلى النشاط. يمكن إضافة كل MenuProvider بشكل اختياري مع Lifecycle يتحكّم تلقائيًا في مستوى ظهور عناصر القائمة هذه استنادًا إلى حالة Lifecycle ويتعامل مع إزالة MenuProvider عند إيقاف Lifecycle.
• تمت إعادة كتابة فئة ActivityResultContract بلغة Kotlin لضمان إمكانية المطوّرين الذين يكتبون عقودًا مخصّصة بلغة Kotlin تحديد إمكانية القيم الخالية الصحيحة لفئات الإدخال والإخراج.
• تمت إعادة كتابة الفئة ActivityResultContracts وعقودها بلغة Kotlin لضمان إمكانية القيم الخالية بشكل صحيح.

الإصدار 1.4.0-rc01

‫13 أكتوبر 2021

تم إصدار androidx.activity:activity:1.4.0-rc01 وandroidx.activity:activity-compose:1.4.0-rc01 وandroidx.activity:activity-ktx:1.4.0-rc01. يتضمّن الإصدار 1.4.0-rc01 هذه التعديلات.

إصلاح الأخطاء

• لن يعرض ActivityResultRegistry نتيجة للاستدعاء ActivityResultCallback عندما يعرض الاستدعاء launch أي Exception. (If4f91، b/200845664)

الإصدار 1.4.0-beta01

‫29 سبتمبر 2021

تم إصدار androidx.activity:activity:1.4.0-beta01 وandroidx.activity:activity-compose:1.4.0-beta01 وandroidx.activity:activity-ktx:1.4.0-beta01. يتضمّن الإصدار 1.4.0-beta01 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تم إصلاح النوع الخاص بـ ActivityResultContracts.OpenMultipleDocuments و ActivityResultContracts.GetMultipleContents الذي تسبّب في استخدام نوع إخراج List<? extends Uri> عند استخدام الرمز من لغة البرمجة Java. (If71de)
• يمكن الآن الوصول إلى الثوابت العامة ضمن الفئات ActivityResultContracts.StartActivityForResult وActivityResultContracts.StartIntentSenderForResult وActivityResultContracts.RequestMultiplePermissions عند استخدام Kotlin من خلال الكائنات Companion العامة. (aosp/1832555)

تعديلات على المستندات

• تم توسيع رسالة الإيقاف النهائي لواجهات برمجة التطبيقات التي تتعامل معها الآن واجهات برمجة التطبيقات لنتائج الأنشطة، أي startActivityForResult وstartIntentSenderForResult وonActivityResult وrequestPermissions وonRequestPermissionsResult، لتشمل المزيد من التفاصيل. (cce80f)

الإصدار 1.4.0-alpha02

‫15 سبتمبر 2021

تم إصدار androidx.activity:activity:1.4.0-alpha02 وandroidx.activity:activity-compose:1.4.0-alpha02 وandroidx.activity:activity-ktx:1.4.0-alpha02. يتضمّن الإصدار 1.4.0-alpha02 هذه التعديلات.

الميزات الجديدة

• يحتوي العنصر activity-compose الآن على خطأ LaunchDuringComposition في أداة Lint يمنعك من استدعاء الطريقة launch من ActivityResultLauncher كجزء من التركيب، لأنّ التركيب يجب أن يكون خاليًا من الآثار الجانبية. استخدِم واجهات برمجة التطبيقات لمعالجة الآثار الجانبية. (7c2bbe، b/191347220)

تغييرات واجهة برمجة التطبيقات

• تمت إعادة كتابة الفئة ActivityResultContract بلغة Kotlin لضمان أن يتمكّن المطوّرون الذين يكتبون عقودًا مخصّصة بلغة Kotlin من تحديد إمكانية القيم الفارغة الصحيحة لفئات الإدخال والإخراج. (I8a8f5)
• تمت إعادة كتابة فئة ActivityResultContracts وعقودها بلغة Kotlin لضمان إمكانية قبول القيم الفارغة بشكل سليم. (I69802)

الإصدار 1.4.0-alpha01

‫1 سبتمبر 2021

تم إصدار androidx.activity:activity:1.4.0-alpha01 وandroidx.activity:activity-compose:1.4.0-alpha01 وandroidx.activity:activity-ktx:1.4.0-alpha01. يتضمّن الإصدار 1.4.0-alpha01 هذه التعديلات.

الميزات الجديدة

• تنفِّذ حزمة AndroidX ComponentActivity الآن واجهة MenuHost. يتيح ذلك لأي مكوّن إضافة عناصر قائمة إلى ActionBar من خلال إضافة مثيل MenuProvider إلى النشاط. يمكن إضافة كل MenuProvider بشكل اختياري مع Lifecycle يتحكّم تلقائيًا في مستوى ظهور عناصر القائمة هذه استنادًا إلى حالة Lifecycle ويتعامل مع إزالة MenuProvider عند إيقاف Lifecycle. (I3b608):

/**
  * Using the addMenuProvider() API directly in your Activity
  **/
class ExampleActivity : ComponentActivity(R.layout.activity_example) {

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Add menu items without overriding methods in the Activity
   addMenuProvider(object : MenuProvider {
      override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
        // Add menu items here
        menuInflater.inflate(R.menu.example_menu, menu)
      }

      override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
        // Handle the menu selection
        return true
      }
    })
  }
}

/**
  * Using the addMenuProvider() API in a Fragment
  **/
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 الآن إلى عرض IllegalStateException عند محاولة استدعاء launch() على ActivityResultLauncher لم يتم تسجيله أو تم إلغاء تسجيله. (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 هذه التعديلات.

تحديثات الاعتماديات

• يعتمد النشاط الآن على 1.5.21 في Kotlin.
• تعتمد ميزة "إنشاء النشاط" الآن على Compose 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

• عنصر Activity Compose: يوفّر العنصر activity-compose طريقة الإضافة setContent لاستضافة واجهة مستخدم Jetpack Compose في نشاط، بالإضافة إلى برامج تضمين خاصة بـ Compose للتفاعل مع واجهات برمجة التطبيقات ComponentActivity من أجل التعامل مع زر الرجوع في النظام وواجهات برمجة التطبيقات الخاصة بنتائج الأنشطة. يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.
• عقد CaptureVideo: يحلّ 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 ليعتمد على 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تمت إزالة الطريقة @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 لتعديل تلميح مستطيل المصدر الخاص بـ PipParams كلما تحرّكت طريقة العرض. (I9063d)

تغييرات واجهة برمجة التطبيقات

• تعرض الدالة rememberLauncherForActivityResult الآن مشغّلاً يوقف الدالة unregister() نهائيًا، إذ تتولّى الدالة rememberLauncherForActivityResult تلقائيًا عملية تسجيل المشغّل وإلغاء تسجيله. (I2443e)

توافق ميزة "الكتابة الذكية"

• لا يتوافق androidx.activity:activity-compose:1.3.0-alpha08 إلا مع الإصدار 1.0.0-beta07 من Compose والإصدارات الأحدث.

الإصدار 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)
• لن يؤدي استخدام إصدارات غير ثابتة من Fragments أعلى من 1.3.0 إلى ظهور خطأ lint إيجابي خاطئ يطلب منك استخدام 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تمت إعادة تسمية واجهة برمجة التطبيقات registerForActivityResult() إلى rememberLauncherForActivityResult() لتوضيح أنّ ActivityResultLauncher الذي يتم عرضه هو عنصر مُدار يتم تذكّره نيابةً عنك. ستؤدي محاولة استدعاء unregister التي تم عرض ActivityResultLauncher لها الآن إلى حدوث خطأ. (I2bb6d)
• تعرض الدالتان LocalOnBackPressedDispatcherOwner.current وLocalActivityResultRegistryOwner.current الآن قيمة تقبل القيم الفارغة لتحديد ما إذا كانت السمة متاحة في التركيب الحالي. ستعرض الآن واجهات برمجة التطبيقات التي تتطلّب هذه الواجهات، مثل BackHandler وrememberLauncherForActivityResult()، خطأ أكثر وصفًا في حال عدم العثور على المالك الأساسي. تعمل ميزة NavHost الآن حتى في حال عدم العثور على OnBackPressedDispatcherOwner، كما يحدث عند معاينة NavHost. (I7d8b4)

إصلاح الأخطاء

• سيعترض BackHandler الآن بشكل صحيح على عمليات الضغط على زر الرجوع في حال كان النشاط STOPPED، ثم STARTED مرة أخرى، وتمت إضافة عمليات رد اتصال أخرى باستخدام LifecycleOwner. (I71de6، b/182284739)
• لن يؤدي استخدام إضافة طريقة launch() مع ActivityResultContract مخصّص يتضمّن إدخال Unit إلى حدوث NullPointerException (I76282، b/183837954)

الإصدار 1.3.0-alpha05

‫24 مارس 2021

تم إصدار androidx.activity:activity:1.3.0-alpha05 وandroidx.activity:activity-compose:1.3.0-alpha05 وandroidx.activity:activity-ktx:1.3.0-alpha05. يتضمّن الإصدار 1.3.0-alpha05 هذه التعديلات.

إصلاح الأخطاء

• من الإصدار 1.2.2 من "النشاط": تم إصلاح مشكلة في عملية فحص InvalidFragmentVersionForActivityResult lint التي أدّت إلى نتيجة إيجابية خاطئة عند استخدام الإصدار 1.3.1 أو الإصدارات الأحدث من Fragment. (I54da1، b/182388985)
• من Activity 1.2.2: تتجنّب السمة ComponentActivity الآن حدوث ClassNotFoundException عند تشغيل Intent من ActivityResultContract تم الاحتفاظ به سابقًا كبيانات إضافية في Intent آخر. (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)
• لم يعُد Activity Compose يضيف تبعيات الاختبار إلى مسار فئة وقت التشغيل. (Ifd8b3)
• تم إصلاح مشكلة في BackHandler حيث كان يتم استخدام دالة onBack lambda التي تم ضبطها سابقًا بعد إعادة التركيب. (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)

تغييرات واجهة برمجة التطبيقات

• تتضمّن LocalOnBackPressedDispatcherOwner الآن وظائف provides يمكن استخدامها مع CompositionLocalProvider، ما يحلّ محل واجهة برمجة التطبيقات 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)

تغييرات واجهة برمجة التطبيقات

• يمكن استخدام واجهة برمجة التطبيقات 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 هذه التعديلات.

الميزات الجديدة

• يوفّر العنصر الجديد activity-compose أدوات مساعدة خاصة بـ Jetpack Compose لواجهات برمجة التطبيقات الخاصة بـ androidx.activity.
  • تم نقل ComponentActivity.setContent من androidx.compose.ui.platform.setContent إلى androidx.activity.compose.setContent. (Icf416)

المشاكل المعروفة

• سيؤدي استخدام Activity Compose 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: يتم الآن حفظ عمليات معاودة الاتصال في ActivityResultRegistry واستعادتها بشكل صحيح، وبالتالي لن يتم تكرار عمليات معاودة الاتصال في savedState. (I97816، b/191893160)

الإصدار 1.2.3

الإصدار 1.2.3

‫5 أيار (مايو) 2021

تم طرح androidx.activity:activity:1.2.3 وandroidx.activity:activity-ktx:1.2.3. يتضمّن الإصدار 1.2.3 هذه التعديلات.

إصلاح الأخطاء

• لن يؤدي استخدام إضافة طريقة launch() مع ActivityResultContract مخصّص يتضمّن إدخال Unit إلى حدوث NullPointerException (I76282، b/183837954)
• تم إصلاح خطأ lint إيجابي خاطئ يطلب منك استخدام Fragment 1.3.0 عند استخدام إصدار تجريبي أو أولي أو إصدار ألفا أو إصدار مرشّح للإصدار من إصدار أحدث من Fragments. (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 lint أدت إلى ظهور نتيجة إيجابية خاطئة عند استخدام الإصدار 1.3.1 أو إصدار أحدث من Fragment. (I54da1، b/182388985)
• يتجنّب ComponentActivity الآن ClassNotFoundException عند تشغيل Intent من ActivityResultContract تمّت إضافته سابقًا كإعلان إضافي في Intent آخر. (Ieff05، b/182906230)

تحديثات الاعتماديات

• يعتمد النشاط الآن على Lifecycle 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

• واجهات برمجة تطبيقات نتائج الأنشطة: يوفّر الإصدار ComponentActivity الآن ActivityResultRegistry يتيح لك التعامل مع عمليات startActivityForResult()+onActivityResult() بالإضافة إلى عمليات requestPermissions()+onRequestPermissionsResult() بدون إلغاء الطرق في "نشاط" أو "جزء"، كما يوفّر أمانًا محسّنًا للأنواع من خلال ActivityResultContract، ويوفر نقاط ربط لاختبار هذه العمليات. اطّلِع على الحصول على نتيجة من نشاط المعدَّل.

• ContextAware: تنفّذ ComponentActivity الآن ContextAware، ما يتيح لك إضافة مثيل واحد أو أكثر من OnContextAvailableListener سيتلقّى ردّ اتصال قبل Activity.onCreate() الأساسي.

  • يتيح لك امتداد Kotlin المعلق withContextAvailable() تشغيل رمز غير معلّق عندما يصبح السياق متاحًا وعرض نتيجة.
  • تستخدم FragmentActivity هذه الواجهة في Fragment 1.3.0 لاستعادة حالة FragmentManager. سيتم تنفيذ أي أدوات معالجة إضافية تمت إضافتها إلى الفئات الفرعية من FragmentActivity بعد أداة المعالجة هذه.
  • تستخدم AppCompatActivity واجهة برمجة التطبيقات هذه في AppCompat 1.3.0-alpha02 أو الإصدارات الأحدث. سيتم تنفيذ أي أدوات معالجة إضافية تمت إضافتها إلى الفئات الفرعية من AppCompatActivity بعد أداة المعالجة هذه.

• ViewTree Support: تتوافق المكتبة ComponentActivity الآن مع واجهات برمجة التطبيقات ViewTreeLifecycleOwner.get(View) وViewTreeViewModelStoreOwner.get(View) وViewTreeSavedStateRegistryOwner التي تمت إضافتها في Lifecycle 2.3.0 وSavedState 1.1.0، ما يتيح عرض النشاط كـ LifecycleOwner وViewModelStoreOwner وSavedStateRegistryOwner لأي طرق عرض تمت إضافتها مباشرةً إلى ComponentActivity.

• إصدار قديم من reportFullyDrawn(): تم نقل طريقة Activity من reportFullyDrawn() إلى إصدار قديم في ComponentActivity لتعمل على جميع مستويات واجهة برمجة التطبيقات، ما يؤدي إلى إصلاح عُطل في المستوى 19 من واجهة برمجة التطبيقات وإضافة تتبُّع لهذه الطريقة على جميع مستويات واجهة برمجة التطبيقات.

الإصدار 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()، ما يسمح باستدعائها على جميع مستويات واجهة برمجة التطبيقات وإصلاح عُطل عند استدعاء هذه الطريقة بدون إذن النظام المناسب على الأجهزة التي تعمل بالإصدار 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 هذه التعديلات.

إصلاح الأخطاء

• تم إصلاح مشكلة كانت تتسبّب في عدم انتظار واجهة برمجة التطبيقات Activity Result API حتى تصبح حالة Lifecycle STARTED قبل عرض النتائج عند التسجيل باستخدام Lifecycle. (I109ea)

المساهمة الخارجية

• عدّلنا مستندات launch() لتوضيح أنّه يمكن أن يعرض الخطأ ActivityNotFoundException. شكرًا "ميخاو زيليينسكي". (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 الآن IllegalStateException عند محاولة استدعاء register() باستخدام LifecycleOwner الذي سبق أن وصل Lifecycle الخاص به إلى STARTED. (b/165435866)

تعديل المستندات

• تربط مستندات ContextAware بـ LifecycleOwner لتسليط الضوء على عمليات معاودة الاتصال Lifecycle باعتبارها المكان المناسب لأحداث الإنشاء والإتلاف. (aosp/1414152)

الإصدار 1.2.0-alpha08

19 آب (أغسطس) 2020

تم طرح androidx.activity:activity:1.2.0-alpha08 وandroidx.activity:activity-ktx:1.2.0-alpha08. يتضمّن الإصدار 1.2.0-alpha08 هذه التعديلات.

الميزات الجديدة

• تنفّذ ComponentActivity الآن ContextAware، ما يتيح لك إضافة مثيل واحد أو أكثر من OnContextAvailableListener سيتلقّى ردّ اتصال قبل Activity.onCreate() الأساسي. (b/161390636)
  • يتيح لك امتداد Kotlin المعلق withContextAvailable() تشغيل رمز غير معلّق عندما يصبح السياق متاحًا وعرض نتيجة. (I8290c)
  • تستخدم FragmentActivity هذه الواجهة في Fragment 1.3.0-alpha08 لاستعادة حالة FragmentManager. سيتم تنفيذ أي أدوات معالجة إضافية تمت إضافتها إلى الفئات الفرعية من FragmentActivity بعد أداة المعالجة هذه. (I513da)
  • تستخدم AppCompatActivity واجهة برمجة التطبيقات هذه في AppCompat 1.3.0-alpha02. سيتم تنفيذ أي أدوات معالجة إضافية تمت إضافتها إلى الفئات الفرعية من AppCompatActivity بعد أداة المعالجة هذه. (I513da)

إصلاح الأخطاء

• تم إصلاح مشكلة في ActivityResultFragmentVersionDetector عملية فحص Lint كانت تؤدي إلى تعطُّلها عند استخدام الإصدار 27.1.0 أو إصدار أحدث من Lint. (b/162155191)

الإصدار 1.2.0-alpha07

‫22 تموز (يوليو) 2020

تم طرح androidx.activity:activity:1.2.0-alpha07 وandroidx.activity:activity-ktx:1.2.0-alpha07. يتضمّن الإصدار 1.2.0-alpha07 هذه التعديلات.

الميزات الجديدة

• تمت إضافة InvalidFragmentVersionForActivityResult فحص lint جديد يتحقّق من أنّك تستخدم Fragment 1.3.0-alpha07 عند استخدام Activity Result API، ما يمنع حدوث أعطال في وقت التشغيل بسبب مشاكل "رمز الطلب غير صالح" وطلبات الأذونات التي لا تعمل بسبب استخدام إصدارات قديمة من Fragment. (b/152554847)

المساهمة الخارجية

• تم إصلاح ArrayIndexOutOfBoundsException عند تحليل النتائج الخاصة بعقد RequestPermission Activity Result. (I8f9e3، b/161057605)

الإصدار 1.2.0-alpha06

‫10 يونيو 2020

تم طرح androidx.activity:activity:1.2.0-alpha06 وandroidx.activity:activity-ktx:1.2.0-alpha06. يتضمّن الإصدار 1.2.0-alpha06 هذه التعديلات.

الميزات الجديدة

• يمكنك الآن تفكيك فئة ActivityResult في Kotlin للوصول مباشرةً إلى requestCode وintent. (b/157212935)
• يتيح لك تطبيق "ActivityResultLauncher" الآن الحصول على ActivityResultContract الذي تم استخدامه لتسجيل مشغّل التطبيقات. (b/156875743)

تغييرات واجهة برمجة التطبيقات

• تغيير غير متوافق: تمت إعادة تسمية الطريقة invoke() في ActivityResultRegistry إلى onLaunch(). (b/157496491)
• تعرض الآن الدالة OpenMultipleDocuments عقدًا بقائمة فارغة بدلاً من null إلى دالة معاودة الاتصال المسجّلة في حال عدم عرض أي نتيجة. (b/157348014)

الإصدار 1.2.0-alpha05

20 أيار (مايو) 2020

تم طرح androidx.activity:activity:1.2.0-alpha05 وandroidx.activity:activity-ktx:1.2.0-alpha05. يتضمّن الإصدار 1.2.0-alpha05 هذه التعديلات.

الميزات الجديدة

• تمت إضافة دعم لـ ViewTreeViewModelStoreOwner من دورة الحياة 2.3.0-alpha03، وViewTreeSavedStateRegistryOwner من SavedState 1.1.0-alpha01 عند استخدام View ضِمن ComponentActivity. (aosp/1297993 وaosp/1300264)

تغييرات واجهة برمجة التطبيقات

• تعرض الآن السمة TakePicture العقد boolean الذي يشير إلى النجاح بدلاً من الصورة المصغّرة Bitmap، لأنّ تطبيقات الكاميرا نادرًا ما كانت تتوافق مع هذه السمة عند كتابة الصورة في Uri المقدَّم. (b/154302879)
• تمت إزالة الإضافات invoke() في ActivityResultLauncher لصالح استخدام launch() بشكلٍ صريح للإشارة بشكلٍ أفضل إلى أنّ هذه العمليات غير متزامنة. تمت إضافة إضافات Kotlin إلى launch في الحزمة androidx.activity.result لكل من ActivityResultLauncher<Void> وActivityResultLauncher<Unit>، ما يغني عن الحاجة إلى تمرير null أو Unit على التوالي، مع عكس هذا السلوك من الإضافات invoke() السابقة. (aosp/1304674 وaosp/1304675)
• تم دمج طريقتَي IntentSenderRequest.Builder لكل من setFlagsMask() وsetFlagsValues() في طريقة setFlags() واحدة. (aosp/1302111)

إصلاح الأخطاء

• عند تسجيل ActivityResultCallback باستخدام LifecycleOwner، تم إصلاح مشكلة كانت تؤدي إلى تشغيل دالة الرجوع قبل أن تصل الحالة إلى STARTED. (aosp/1309744)

التغييرات في السلوك

• تنشئ السمة ActivityResultRegistry الآن رموز طلب تبدأ من 0xFFFF بدلاً من 0، ما يمنع التداخل عند استخدام startActivityForResult() أو requestPermissions() في أحد الأنشطة. (aosp/1302324)

الإصدار 1.2.0-alpha04

‫29 نيسان (أبريل) 2020

تم طرح androidx.activity:activity:1.2.0-alpha04 وandroidx.activity:activity-ktx:1.2.0-alpha04. يتضمّن الإصدار 1.2.0-alpha04 هذه التعديلات.

الميزات الجديدة

• تمت إضافة عقد يمكنه استدعاء startIntentSenderForResult إلى واجهات برمجة التطبيقات ActivityResult. (b/153007517)

تغييرات واجهة برمجة التطبيقات

• تمت إعادة تسمية الطريقة prepareCall() لتصبح registerForActivityResult()، وذلك على ComponentActivity هنا وفي Fragment 1.3.0-alpha04. (aosp/1278717)
• تمت إعادة تسمية العقود GetContents وOpenDocuments وRequestPermissions لتصبح GetMultipleContents وOpenMultipleDocuments وRequestMultiplePermissions على التوالي. (aosp/1280161)
• تتضمّن ComponentActivity الآن واجهة ActivityResultRegisteryOwner. (aosp/1290888)
• - تم إيقاف واجهتَي برمجة التطبيقات startActivityForResult()/onActivityResult() وonRequestPermissionsResult() على ComponentActivity. يُرجى استخدام واجهات برمجة التطبيقات لنتائج الأنشطة. (b/154751887)

إصلاح الأخطاء

• عند استخدام عقود GetMultipleContents وOpenMultipleDocuments واختيار عنصر واحد، يتم الآن إرجاعه بشكل صحيح إلى دالة معاودة الاتصال. (b/152941153)

الإصدار 1.2.0-alpha03

1 نيسان (أبريل) 2020

تم طرح androidx.activity:activity:1.2.0-alpha03 وandroidx.activity:activity-ktx:1.2.0-alpha03. يتضمّن الإصدار 1.2.0-alpha03 هذه التعديلات.

الميزات الجديدة

• تمت إضافة العقود TakeVideo وPickContact وGetContent وGetContents وOpenDocument وOpenDocuments وOpenDocumentTree وCreateDocument إلى مجموعة العقود المُنشأة مسبقًا التي توفّرها ActivityResultContracts. (aosp/1262482 وaosp/1266916 وaosp/1268960)
• تتيح واجهات برمجة التطبيقات Activity Result الآن بدء نشاط للحصول على نتيجة باستخدام ActivityOptionsCompat اختياري. (b/151860054)

تغييرات واجهة برمجة التطبيقات

• يتلقّى العقد TakePicture الآن إدخالاً Uri لتحديد مكان تخزين الصورة. تمت إعادة تسمية العقد السابق الذي لا يتطلّب أي إدخال إلى TakePicturePreview. (aosp/1262482)
• تمت إعادة تسمية طريقة registerActivityResultCallback() في ActivityResultRegistry إلى register(). (aosp/1267621)
• تمت إعادة تسمية الطريقة dispose() في ActivityResultLauncher لتصبح unregister()، كما تمت إزالة unregisterResultCallback() في ActivityResultRegistry. (aosp/1267621)
• تتلقّى الطريقة createIntent() في ActivityResultContact الآن Context بالإضافة إلى الإدخال لإتاحة إنشاء أغراض ضمنية. (aosp/1238800)
• يمكن الآن ActivityResultContract أن يتجاهل getSynchronousResult() لتقديم نتيجة بدون استدعاء startActivityForResult. يتم استخدام هذا الحقل في العقدَين RequestPermission وRequestPermissions لعرض الحالة "ممنوحة" بشكل صحيح إذا كانت الأذونات المطلوبة ممنوحة مسبقًا. (b/151110799)
• تمت إزالة العقد Dial الذي كان متاحًا سابقًا لأنّ Intent ليس مخصّصًا للاستخدام مع startActivityForResult(). (aosp/1266916)
• أصبحت العديد من واجهات برمجة التطبيقات الخاصة بنتائج النشاط التي لم يكن من المفترض توسيعها final. ويشمل ذلك getActivityResultRegistry() وطُرق prepareCall() وجميع طُرق ActivityResultRegistry باستثناء invoke() وعددًا من العقود التلقائية التي لا تتيح إضافات اختيارية. (b/152439361)

إصلاح الأخطاء

• تم إصلاح NullPointerException في ActivityResultRegistry عند محاولة عرض النتائج في دالة رد الاتصال التي لم تتم إعادة تسجيلها بعد تغيير الإعدادات. يحتفظ ActivityResultRegistry الآن بهذه النتائج المعلّقة ويعرضها عند إعادة تسجيل دالة رد الاتصال. (b/152137004)

الإصدار 1.2.0-alpha02

‫18 مارس 2020

تم طرح androidx.activity:activity:1.2.0-alpha02 وandroidx.activity:activity-ktx:1.2.0-alpha02. يتضمّن الإصدار 1.2.0-alpha02 هذه التعديلات.

الميزات الجديدة

• ‫ActivityResultRegistry: يوفّر ComponentActivity الآن ActivityResultRegistry يتيح لك التعامل مع startActivityForResult()+onActivityResult() بالإضافة إلى مسارات requestPermissions()+onRequestPermissionsResult() بدون إلغاء الطرق في النشاط أو الجزء، كما يوفّر أمانًا محسّنًا للأنواع من خلال ActivityResultContract، ويوفر خطافات لاختبار هذه المسارات. اطّلِع على الحصول على نتيجة من نشاط المعدَّل. (b/125158199)

الإصدار 1.2.0-alpha01

‫4 مارس 2020

تم طرح androidx.activity:activity:1.2.0-alpha01 وandroidx.activity:activity-ktx:1.2.0-alpha01. يتضمّن الإصدار 1.2.0-alpha01 هذه التعديلات.

الميزات الجديدة

• تمت إضافة دعم لواجهة برمجة التطبيقات ViewTreeLifecycleOwner.get(View) التي تمت إضافتها في دورة الحياة 2.3.0-alpha01، وذلك لكي تعرض النشاط على أنّه LifecycleOwner لأي طرق عرض تمت إضافتها مباشرةً إلى النشاط. (aosp/1182955)

إصلاح الأخطاء

• تم إصلاح مشكلة تراجع تم رصدها في النشاط 1.1.0 عند التشغيل على إصدارات قديمة من النظام الأساسي حيث كان onBackPressed() يتسبب في حدوث IllegalStateException بسبب خطأ في android.app.FragmentManager. (b/146290338)

الإصدار 1.1.0

الإصدار 1.1.0

‫22 يناير 2020

تم طرح androidx.activity:activity:1.1.0. يتضمّن الإصدار 1.1.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.0.0

• عملية دمج Lifecycle ViewModel SavedState: أصبح SavedStateViewModelFactory هو المصنع التلقائي المستخدَم عند استخدام by viewModels() أو الدالة الإنشائية ViewModelProvider أو ViewModelProviders.of() مع ComponentActivity أو فئاته الفرعية.

الإصدار 1.1.0-rc03

4 كانون الأول (ديسمبر) 2019

تم طرح androidx.activity:activity:1.1.0-rc03 وandroidx.activity:activity-ktx:1.1.0-rc03. يتضمّن الإصدار 1.1.0-rc03 هذه التعديلات.

التغييرات في التبعيات

• يعتمد النشاط الآن على Lifecycle 2.2.0-rc03 وLifecycle ViewModel SavedState 1.0.0-rc03.

الإصدار 1.1.0-rc02

‫7 نوفمبر 2019

تم طرح androidx.activity:activity:1.1.0-rc02 وandroidx.activity:activity-ktx:1.1.0-rc02. يتضمّن الإصدار 1.1.0-rc02 هذه التعديلات.

التغييرات في التبعيات

• يعتمد النشاط الآن على دورة الحياة 2.2.0-rc02.

الإصدار 1.1.0-rc01

‫23 تشرين الأول (أكتوبر) 2019

تم إصدار androidx.activity:activity:1.1.0-rc01 وandroidx.activity:activity-ktx:1.1.0-rc01 بدون أي تغييرات منذ 1.1.0-beta01. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

الإصدار 1.1.0-beta01

‫9 أكتوبر 2019

تم طرح androidx.activity:activity:1.1.0-beta01 وandroidx.activity:activity-ktx:1.1.0-beta01. يتضمّن الإصدار 1.1.0-beta01 هذه التعديلات.

التغييرات في التبعيات

• يعتمد النشاط الآن على الإصدار الثابت 1.0.0 من SavedState.

الإصدار 1.1.0-alpha03

‫5 أيلول (سبتمبر) 2019

تم طرح androidx.activity:activity:1.1.0-alpha03 وandroidx.activity:activity-ktx:1.1.0-alpha03. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

الميزات الجديدة

• يعتمد النشاط الآن على الإصدار الثابت 1.1.0 من Core.

إصلاح الأخطاء

• يعتمد النشاط الآن على Lifecycle 2.2.0-alpha04.

الإصدار 1.1.0-alpha02

‫7 آب (أغسطس) 2019

تم طرح androidx.activity:activity:1.1.0-alpha02 وandroidx.activity:activity-ktx:1.1.0-alpha02. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

الميزات الجديدة

• أصبحت SavedStateViewModelFactory هي المصنع التلقائي المستخدَم عند استخدام by viewModels() أو أداة إنشاء ViewModelProvider أو ViewModelProviders.of() مع ComponentActivity (b/135716331)

الإصدار 1.1.0-alpha01

2 تموز (يوليو) 2019

تم طرح androidx.activity:activity:1.1.0-alpha01 وandroidx.activity:activity-ktx:1.1.0-alpha01. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

الميزات الجديدة

• يعتمد activity الآن على Lifecycle 2.2.0-alpha02. (aosp/1007817)
• أضافت activity-ktx عنصرًا تابعًا لـ lifecycle-runtime-ktx، ولم يعُد عليك إضافته بشكل صريح إلى العناصر التابعة عند استخدام activity-ktx أو المكتبات التي تعتمد على activity-ktx (مثل fragment-ktx). (aosp/987162)

الإصدار 1.0.0

الإصدار 1.0.0

‫5 أيلول (سبتمبر) 2019

تم طرح androidx.activity:activity:1.0.0 وandroidx.activity:activity-ktx:1.0.0. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

الميزات الرئيسية في الإصدار 1.0.0

• ComponentActivity: تعمل ComponentActivity كفئة أساسية جديدة لـ FragmentActivity في Fragment 1.1.0، وبالتالي AppCompatActivity في AppCompat 1.1.0.
• activity-ktx: يتضمّن الوحدة activity-ktx إضافة لخاصية Kotlin by viewModels تتيح الوصول إلى ViewModels. يتم تضمين هذه الوحدة تلقائيًا عند تضمين fragment-ktx من Fragment 1.1.0.
• OnBackPressedDispatcher: كبديل قابل للإنشاء لتجاوز onBackPressed()، يمكنك الآن تسجيل OnBackPressedCallback من أي LifecycleOwner (مثل جزء) لاعتراض أحداث زر الرجوع في النظام. تمت إضافة دالة lambda مع إصدار المستقبِل addCallback إلى activity-ktx. لمزيد من التفاصيل، راجِع مستندات توفير التنقّل المخصّص للخلف.
• إيقاف onRetainCustomNonConfigurationInstance نهائيًا: تم إيقاف واجهة برمجة التطبيقات onRetainCustomNonConfigurationInstance() وواجهة برمجة التطبيقات getLastCustomNonConfigurationInstance() ذات الصلة نهائيًا. ننصح بشدة باستخدام ViewModels لتخزين الحالة غير المتعلّقة بالإعدادات، لأنّها تقدّم حلاً قابلاً للإنشاء ومناسبًا لأي ViewModelStoreOwner يوضّح ملكية العناصر المحتفظ بها ويوفّر معاودة الاتصال onCleared() لتنظيف الموارد عند إيقاف النشاط نهائيًا.

الإصدار 1.0.0-rc01

2 تموز (يوليو) 2019

تم إصدار androidx.activity:activity:1.0.0-rc01 وandroidx.activity:activity-ktx:1.0.0-rc01 بدون أي تغييرات منذ 1.0.0-beta01. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

الإصدار 1.0.0-beta01

‫5 يونيو 2019

تم إصدار androidx.activity::activity:1.0.0-beta01 وandroidx.activity:activity-ktx:1.0.0-beta01 بدون أي تغييرات منذ 1.0.0-alpha08. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

الإصدار 1.0.0-alpha08

7 أيار (مايو) 2019

تم طرح androidx.activity:activity:1.0.0-alpha08 وandroidx.activity:activity-ktx:1.0.0-alpha08. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

تغييرات واجهة برمجة التطبيقات

• تغيير غير متوافق مع الإصدارات القديمة: تمت إزالة الطريقتَين addOnBackPressedCallback وremoveOnBackPressedCallback اللتَين تم إيقافهما نهائيًا سابقًا في ComponentActivity. aosp/953857
• أصبحت طريقتَا setEnabled() وisEnabled() في OnBackPressedCallback نهائيتَين الآن. b/131416833
• أصبحت طريقة remove() في OnBackPressedCallback نهائية الآن. aosp/952720
• يتضمّن OnBackPressedDispatcher الآن أدوات إنشاء عامة، ما يتيح لك إنشاء مثيلات خاصة بك للاختبار وغير ذلك. aosp/953431
• تم الآن تصنيف onBackPressed() على أنّه @MainThread aosp/952721ComponentActivity

إصلاح الأخطاء

• تم إصلاح ConcurrentModificationException عند استدعاء remove() من داخل طريقة handleOnBackPressed() لعنصر OnBackPressedCalback تمت إضافته باستخدام LifecycleOwner. b/131765095

الإصدار 1.0.0-alpha07

‫25 أبريل 2019

تم طرح androidx.activity:activity:1.0.0-alpha07 وandroidx.activity:activity-ktx:1.0.0-alpha07. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

تغييرات واجهة برمجة التطبيقات

يُجري هذا الإصدار تغييرات كبيرة على طريقة التعامل مع onBackPressed(). لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات زر الرجوع المخصّص المعدَّلة.

• تم وضع علامة @MainThread على طريقتَي OnBackPressedCallback وOnBackPressedDispatcher. (aosp/943813)
• لم يعُد الإجراء handleOnBackPressed() يعرض boolean. بدلاً من ذلك، أصبحت OnBackPressedCallback الآن فئة مجرّدة يمكن تفعيلها أو إيقافها. ولن يتم استدعاء handleOnBackPressed() إلا عندما تعرض الطريقة الجديدة isEnabled() القيمة "صحيح"، وفي هذه الحالة يجب معالجة زر الرجوع. (aosp/944518)
• لم تعُد طرق addCallback في OnBackPressedDispatcher تعرض مثيلاً من Cancellable. تحتوي OnBackPressedCallback الآن على طريقة remove() تؤدي هذه الوظيفة، ما يتيح لك استدعاء remove() أثناء handleOnBackPressed(). (aosp/944519) (aosp/946316)
• يحتوي activity-ktx الآن على دالة ردّ اتصال محدودة النطاق للمستلِم خاصة بـ addCallback تقبل تعبير lambda ينفّذ handleOnBackPressed() ويمكنه الوصول إلى isEnabled وremove() (aosp/944520)

الإصدار 1.0.0-alpha06

‫3 أبريل 2019

تم طرح androidx.activity:activity:1.0.0-alpha06 وandroidx.activity:activity-ktx:1.0.0-alpha06. يمكنك الاطّلاع على التعديلات في هذا الإصدار هنا.

تغييرات واجهة برمجة التطبيقات

• يحتوي ComponentActivity الآن على دالة إنشاء ثانية تأخذ @LayoutRes int، ما يحلّ محل السلوك السابق المتمثل في إضافة التعليقات التوضيحية إلى فئة AppCompatActivity باستخدام @ContentView. يعمل هذا الأسلوب في كلّ من وحدات التطبيق والمكتبة. (b/128352521)
• تم إيقاف واجهات برمجة التطبيقات ذات الصلة بـ OnBackPressedCallback في ComponentActivity نهائيًا لصالح OnBackPressedDispatcher الجديد، ويمكن استرداده من خلال getOnBackPressedDispatcher(). (aosp/922523)
• إنّ طرق إضافة OnBackPressedCallback جديدة إلى OnBackPressedDispatcher تعرض الآن عنصر Cancellable، ما يتيح إزالة معاودة الاتصال بدون الحاجة إلى مرجع صريح إلى OnBackPressedDispatcher. (aosp/922523)
• تؤدي إضافة OnBackPressedCallback مع LifecycleOwner مرتبطة بها الآن إلى إضافة OnBackPressedCallback وإزالتها عند بدء Lifecycle وإيقافه، على التوالي. (aosp/922523)

الإصدار 1.0.0-alpha05

‫13 مارس 2019

تم طرح androidx.activity:activity:1.0.0-alpha05 وandroidx.activity:activity-ktx:1.0.0-alpha05. يمكنك الاطّلاع على القائمة الكاملة للتعديلات في هذا الإصدار هنا.

الميزات الجديدة

• تم الآن تخزين عمليات البحث عن التعليقات التوضيحية في @ContentView مؤقتًا (b/123709449)

الإصدار 1.0.0-alpha04

‫30 يناير 2019

تم طرح androidx.activity:activity 1.0.0-alpha04 وandroidx.activity:activity-ktx 1.0.0-alpha04.

الميزات الجديدة

• تمت إضافة إمكانية استخدام التعليق التوضيحي للفئة @ContentView الذي يتيح لك تحديد ملف XML للتصميم الذي يجب تضخيمه كبديل لاستخدام setContentView(). (aosp/837619)

تغييرات واجهة برمجة التطبيقات

• تمت إضافة ملاحظة تفيد بأنّه يجب عدم إلغاء getViewModelStore() وسيتم إتاحته نهائيًا في إصدار مستقبلي. يُرجى إرسال طلب ميزة إذا كنت تتجاهل هذه الطريقة حاليًا. (aosp/837619)

إصلاح الأخطاء

• تعتمد الوحدة activity الآن على الإصدار 2.1.0-alpha02 من ViewModel لتتطابق مع تبعية الوحدة activity-ktx.

الإصدار 1.0.0-alpha03

‫17 كانون الأول (ديسمبر) 2018

تم طرح androidx.activity 1.0.0-alpha03.

الميزات الجديدة

• تنفِّذ فئة ComponentActivity الآن BundleSavedStateRegistryOwner وتعتمد على مكتبة SavedState التي تم إصدارها حديثًا [aosp/815133].
• تعمل فئة ComponentActivity الآن على حلّ خطأ في إطار عمل Android كان يتسبّب في تسرُّب آخر عرض تم التركيز عليه في InputMethodManager [b/37122102].

الإصدار 1.0.0-alpha02

‫3 كانون الأول (ديسمبر) 2018

تغييرات واجهة برمجة التطبيقات

• تمت إضافة ملاحظة تفيد بأنّه يجب عدم إلغاء getLifecycle() وسيتم إتاحة final في إصدار مستقبلي. يُرجى إرسال طلب ميزة إذا كنت تتجاوز هذه الطريقة حاليًا. (aosp/815834)

الإصدار 1.0.0-alpha01

‫5 نوفمبر 2018

تقدّم androidx.activity 1.0.0-alpha01 ComponentActivity، وهي فئة أساسية جديدة للفئتين FragmentActivity وAppCompatActivity الحالية.

الميزات الجديدة

• يمكنك الآن تسجيل OnBackPressedCallback من خلال addOnBackPressedCallback لتلقّي عمليات رد الاتصال onBackPressed() بدون الحاجة إلى إلغاء الإجراء في نشاطك.
• تمت إضافة تفويض جديد لسمة by viewModels() Kotlin من أجل استرداد ViewModel من ComponentActivity.
• تم الآن إلغاء أحداث الإدخال المعلّقة (مثل النقرات) في onStop().

تغييرات واجهة برمجة التطبيقات

• تم نقل عملية تنفيذ LifecycleOwner وViewModelStoreOwner من FragmentActivity إلى ComponentActivity.
• تم إيقاف onRetainCustomNonConfigurationInstance نهائيًا. استخدِم ViewModel لتخزين العناصر التي يجب أن تظل متاحة عند إجراء تغييرات في الإعدادات.