Hilt

توسيع وظائف Dagger Hilt لتفعيل إضافة الاعتمادية لفئات معيّنة من مكتبات androidx

يسرد هذا الجدول جميع العناصر في مجموعة androidx.hilt.

العناصر الإصدار المستقر إصدار مرشح الإصدار التجريبي الإصدار الأولي
شائع 1.1.0 - - -
برنامج تجميع الصور الملتقَطة 1.1.0 - - -
مصقولة 1.1.0 - - -
التنقُّل باستخدام التصغير 1.1.0 - - -
إنشاء التنقل باستخدام hilt-navigation 1.1.0 - - -
جزء التنقل الرئيسي 1.1.0 - - -
تم إجراء آخر تعديل لهذه المكتبة في 1 تشرين الثاني (نوفمبر) 2023.

ملاحظات

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

إنشاء عدد جديد

راجع مستندات أداة تتبُّع المشاكل للحصول على مزيد من المعلومات.

الإصدار 1.1.0 من Hilt

الإصدار 1.1.0

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

تم إصدار "androidx.hilt:hilt-*:1.1.0". يحتوي الإصدار 1.1.0 على هذه الالتزامات.

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

  • إضافة دعم KSP إلى androidx.hilt.
  • قبول HasDefaultViewModelProviderFactory في hiltViewModel().
  • تستخدِم واجهة برمجة التطبيقات hiltViewModel() الآن مَعلمة رئيسية اختيارية.

الإصدار 1.1.0-rc01

18 تشرين الأول (أكتوبر) 2023

تم إصدار "androidx.hilt:hilt-*:1.1.0-rc01". يحتوي الإصدار 1.1.0-rc01 على هذه الالتزامات.

الإصدار 1.1.0-beta01

تم إصدار androidx.hilt:hilt-common:1.1.0-beta01 وandroidx.hilt:hilt-compiler:1.1.0-beta01 وandroidx.hilt:hilt-work:1.1.0-beta01 وandroidx.hilt:hilt-navigation:1.1.0-beta01 وandroidx.hilt:hilt-navigation-compose:1.1.0-beta01 وandroidx.hilt:hilt-navigation-fragment:1.1.0-beta01.

الإصدار 1.1.0-alpha01

9 آب (أغسطس) 2023

تم إصدار androidx.hilt:hilt-common:1.1.0-alpha01 وandroidx.hilt:hilt-compiler:1.1.0-alpha01 وandroidx.hilt:hilt-work:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.

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

  • إضافة دعم KSP إلى androidx.hilt. يُرجى ملاحظة أنّ هذا الهدف من أجل الاستعداد لدعم برنامج KSP في Hilt. ولاستخدام إصدار KSP من androidx.hilt، يجب إصدار دعم Hilt الرئيسي.

الإصدار 1.1.0 من Hilt- Navigation-Fragment

الإصدار 1.1.0-alpha02

19 نيسان (أبريل) 2023

تم إصدار "androidx.hilt:hilt-navigation-fragment:1.1.0-alpha02". يحتوي الإصدار 1.1.0-alpha02 على هذه الالتزامات.

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

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

  • تم إصلاح المشكلة المتمثلة في عدم إدخال hiltNavGraphViewModel() لـ SavedStateHandle. (3ef114، b/272099838)

الإصدار 1.1.0 من Hilt- Navigation

الإصدار 1.1.0-alpha02

19 نيسان (أبريل) 2023

تم إصدار "androidx.hilt:hilt-navigation:1.1.0-alpha02". يحتوي الإصدار 1.1.0-alpha02 على هذه الالتزامات.

الإصدار 1.1.0-alpha01

7 كانون الأول (ديسمبر) 2022

تم إصدار "androidx.hilt:hilt-navigation:1.1.0-alpha01". يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.

الإصدار 1.1.0 من Hilt- Navigation-Compose

الإصدار 1.1.0-alpha01

7 كانون الأول (ديسمبر) 2022

تم إصدار "androidx.hilt:hilt-navigation-compose:1.1.0-alpha01". يحتوي الإصدار 1.1.0-alpha01 على هذه الالتزامات.

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

  • تستخدِم واجهة برمجة التطبيقات hiltViewModel() الآن مَعلمة رئيسية اختيارية. ويتيح لك هذا الإجراء الحصول على نُسخ متعددة من النوع ViewModel نفسه باستخدام مفاتيح مختلفة. (I6ee47، b/245139957)

الإصدار 1.0.0 من Hilt- Navigation-Compose

الإصدار 1.0.0

26 يناير 2022

تم إصدار "androidx.hilt:hilt-navigation-compose:1.0.0". يحتوي الإصدار 1.0.0 على هذه الالتزامات.

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

يوفّر عنصر androidx.hilt:hilt-navigation-compose واجهات برمجة تطبيقات تسمح للمستخدمين بالحصول على ViewModel (@HiltViewModel) الذي يتضمن تعليقات توضيحية من إدخال تكديس "الانتقال للخلف" داخل تطبيق Compose باستخدام :navigation-compose.

تعرض الدالة hiltViewModel() القيمة ViewModel الحالية أو تنشئ قيمة جديدة على مستوى الرسم البياني للتنقّل الحالي المتوفّر في الحزمة الخلفية من NavController. يمكن أن تستخدم الدالة NavBackStackEntry بشكل اختياري لنطاق ViewModel على إدخال تسلسل استدعاء الدوال البرمجية الرئيسية.

الإصدار 1.0.0-rc01

15 كانون الأول (ديسمبر) 2021

تم إصدار androidx.hilt:hilt-navigation-compose:1.0.0-rc01 بدون أي تغييرات منذ 1.0.0-beta01. يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.

الإصدار 1.0.0-beta01

17 تشرين الثاني (نوفمبر) 2021

تم إصدار "androidx.hilt:hilt-navigation-compose:1.0.0-beta01". يتضمّن الإصدار 1.0.0-beta01 هذه الالتزامات.

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

  • أزِل دالة hiltNavGraphViewModel() المتوقّفة وأحمالها الزائدة. تم استبدال جميع هذه العناصر بـ hiltViewModel(). (Iaf7d7)

الإصدار 1.0.0-alpha03

16 حزيران (يونيو) 2021

تم إصدار "androidx.hilt:hilt-navigation-compose:1.0.0-alpha03". يحتوي الإصدار 1.0.0-alpha03 على هذه الالتزامات.

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

  • تتوافق الطريقة hiltViewModel() الآن مع التغييرات في واجهة برمجة التطبيقات viewModel() في Lifecycle-ViewModel-Compose 1.0.0-alpha07 وتأخذ الآن معلَمة ViewModelStoreOwner اختيارية، بدلاً من استخدام إصدار بدون وسيطة وآخر لا يتطلب سوى NavBackStackEntry. يتيح لك هذا الإجراء مواصلة استخدام hiltViewModel() للوصول إلى المالك التلقائي الذي توفِّره LocalViewModelStoreOwner أو استخدام hiltViewModel(navBackStackEntry) أو ViewModelStoreOwner آخر لتحديد أي مالك محدّد. (I2628d)

الإصدار 1.0.0-alpha02

18 أيار (مايو) 2021

تم إصدار "androidx.hilt:hilt-navigation-compose:1.0.0-alpha02". يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.

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

  • تمت إعادة تسمية hiltNavGraphViewModel() إلى hiltViewModel() وإزالة الإضافة في NavController، وذلك لأنّه يمكن للمستخدم استخدام واجهة برمجة تطبيقات navigation-compose مباشرةً للحصول على NavBackStackEntry من أحد المسارات. (I6ef57)

إنشاء بيانات توافق

  • لا يتوافق الإصدار androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 إلا مع إصدار الإنشاء 1.0.0-beta07 والإصدارات الأحدث.

التعديلات المتعلقة بالتبعية

الإصدار 1.0.0-alpha01

10 آذار (مارس) 2021

تم إصدار "androidx.hilt:hilt-navigation-compose:1.0.0-alpha01". يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.

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

  • يوفّر عنصر :hilt-navigation-compose واجهات برمجة تطبيقات تسمح للمستخدمين بالحصول على ViewModel @HiltViewModel الذي يتضمن تعليقات توضيحية من إدخال تكديس "الانتقال للخلف" داخل تطبيق Compose باستخدام :navigation-compose. يمكن للدالة hiltNavGraphViewModel() استخدام سلسلة NavBackStackEntry أو "route" التي يمكن استخدامها لتحديد نطاق ViewModel إلى إدخال المكدس الخلفي الحالي أو إدخال رئيسي في المكدس. (Ia9234)

الإصدار 1.1 من Hilt

الإصدار 1.1.0-beta01

4 تشرين الأول (أكتوبر) 2023

تم إصدار "androidx.hilt:hilt-*:1.1.0-beta01". يتضمّن الإصدار 1.1.0-beta01 هذه الالتزامات.

تم إصدار androidx.hilt:hilt-*:1.1.0-beta01 بدون أي تغييرات منذ 1.1.0-alpha*.

الإصدار 1.0.0 من Hilt

الإصدار 1.0.0

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

تم إصدار "androidx.hilt:hilt-*:1.0.0". يحتوي الإصدار 1.0.0 على هذه الالتزامات.

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

توفّر androidx.hiltالأدوات إضافات لدمج تطبيق Hilt مع مكتبات AndroidX الأخرى المختلفة، مثل WorkManager والتنقل. للحصول على قائمة بالميزات والأمثلة، يمكنك مراجعة مستندات الدمج.

الإصدار 1.0.0-beta01

10 آذار (مارس) 2021

تم إصدار "androidx.hilt:hilt-*:1.0.0-beta01". يتضمّن الإصدار 1.0.0-beta01 هذه الالتزامات.

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

  • أزِل أنواع @Deprecated من عناصر AndroidX Hilt، وتحديدًا @androidx.hilt.ViewModelInject و@androidx.hilt.Assisted. تجدر الإشارة إلى أنّه تم استبدال السمة @ViewModelInject بـ @HiltViewModel. (I626fe)

الإصدار 1.0.0-alpha03

27 كانون الثاني (يناير) 2021

تم إصدار "androidx.hilt:hilt-*:1.0.0-alpha03". يحتوي الإصدار 1.0.0-alpha03 على هذه الالتزامات.

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

  • توفير واجهات برمجة التطبيقات لاسترداد @HiltViewModel ViewModel الذي يتضمن تعليقات توضيحية من التنقل NavBackStackEntry. يقدّم العنصر hilt-navigation-fragment إضافة Kotlin hiltNavGraphViewModels، بينما يعرض hilt-navigation طريقة المصنع HiltViewModelFactory التي تستخدم NavBackStackEntry كوسيطة وتعرض ViewModelProvider.Facctory التي يمكن استخدامها مع ViewModelProvider أو نموذج عرض آخر لاسترداد واجهات برمجة التطبيقات، مثل دالة viewModel() في Compose: viewModel(HiltViewModelFactory(AmbientContext.current, backStackEntry)). (I00e67)

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

  • استبدِل @WorkerInject بـ @HiltWorker. أصبحت @HiltWorker الآن تعليقًا توضيحيًا من النوع وتتطلب استخدام @edInject في الدالة الإنشائية. (Ic2f15)
  • إيقاف @ViewModelInject يتم الآن تقديم وظائف مكافئة من خلال @HiltViewModel، والتي أصبحت الآن جزءًا من واجهات برمجة تطبيقات Hilt الأساسية لنظام التشغيل Android. (I36a41)

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

  • يُرجى حل مشكلة عدم استلام Hilt وحدات الإضافات الخاصة بنظام AndroidX Hilt بشكل صحيح، ما يؤدي إلى عدم إتاحة إمكانية الإنشاء لدى Workers. (I3181c، b/159540434)
  • يمكنك نقل إضافات AndroidX Hilt إلى SingletonComponent، مع إزالة التحذير المتوقّف نهائيًا لاستخدام ApplicationCompoonent. (I9c916، b/175849092)

الإصدار 1.0.0-alpha02

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

تم إصدار "androidx.hilt:hilt-*:1.0.0-alpha02". يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.

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

  • تم إصلاح مشكلة تكرار مفاتيح الحالة المحفوظة عند طلب ViewModel لم يتم إدخاله من خلال Hilt من فئة تتضمن تعليقات توضيحية تستخدم السمة @AndroidEntryPoint. (b/158737069)
  • تم إصلاح مشكلة في HiltWorkerFactory كانت تتعلَّق بعدم إعداد صفوف Worker المُدمجة التي تم تضمين تعليقات توضيحية لها باستخدام @WorkerInject بشكل صحيح. (b/160524718)

الإصدار 1.0.0-alpha01

10 حزيران (يونيو) 2020

تم إصدار "androidx.hilt:hilt-*:1.0.0-alpha01". يحتوي الإصدار 1.0.0-alpha01 على هذه الالتزامات.

تعمل حزمة ومكتبات androidx.hilt على توسيع وظائف Dagger Hilt لتفعيل إضافة الاعتماد لفئات معيّنة من مكتبات androidx.