تلميح

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

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

العناصر الإصدار المستقر إصدار مرشح الإصدار التجريبي إصدار ألفا
الأكثر رواجًا 1.2.0 - - -
أداة إنشاء المحتوى فقط 1.2.0 - - -
العمل الشاق 1.2.0 - - -
التنقّل باستخدام لوح تحديد 1.2.0 - - -
إنشاء التنقّل باستخدام أدوات التنقّل 1.2.0 - - -
جزء التنقل التنقلي 1.2.0 - - -
تم إجراء آخر تعديل لهذه المكتبة في 21 شباط (فبراير) 2024.

ملاحظات

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

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

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

الإصدار 1.2 من Hilt

الإصدار 1.2.0

21 شباط (فبراير) 2024

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

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

  • إضافة دعم الحقن المساعِد إلى hiltViewModel() وhiltNavGraphViewModels() تحتاج هذه الدوال الآن إلى استدعاء إضافي يمكنك من خلاله استخدام المصنع المدعوم لإنشاء ViewModel مضخَّم مساعد.

الإصدار 1.2.0-rc01

7 شباط (فبراير) 2024

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

الإصدار 1.2.0-beta01

24 كانون الثاني (يناير) 2024

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

الإصدار 1.2.0-alpha01

13 كانون الأول (ديسمبر) 2023

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

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

  • إضافة دالتي hiltViewModel() وhiltNavGraphViewModels() تحميل زائدة لتوفير دعم الحقن المدعوم. (Ieb98d)

الإصدار 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() API الآن مَعلمة مفتاح اختيارية.

الإصدار 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. يُرجى العلم أنّ هذا الهدف مخصّص للاستعداد لدعم Hilt في KSP. لاستخدام إصدار 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() API الآن مَعلمة مفتاح اختيارية. يتيح لك ذلك الحصول على نُسخ متعددة من النوع 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 إلا مع إصدار Compose 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 واجهات برمجة تطبيقات تسمح للمستخدمين بالحصول على @HiltViewModel التي تم التعليق عليها ViewModel من إدخال حزمة الرجوع إلى الوراء داخل تطبيق Compose باستخدام :navigation-compose. يمكن أن تأخذ الدالة hiltNavGraphViewModel() إما سلسلة NavBackStackEntry أو سلسلة "مسار" يمكن استخدامها لتحديد نطاق 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 إضافة hiltNavGraphViewModels Kotlin، بينما يعرض hilt-navigation طريقة الإعدادات الأصلية HiltViewModelFactory التي تستخدم NavBackStackEntry كوسيطة وتعرض ViewModelProvider.Facctory التي يمكن استخدامها مع ViewModelProvider أو نموذج عرض آخر لاسترداد واجهات برمجة التطبيقات، مثل دالة viewModel() في Compose: viewModel(HiltViewModelFactory(AmbientContext.current, backStackEntry)). (I00e67)

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

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

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

  • حلّ مشكلة تعذُّر اختيار وحدات إضافة AndroidX Hilt بشكل صحيح من خلال 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 التي تم إدخالها بدون إدخال من فئة "@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.