Hilt

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

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
hilt-common 1.2.0 - - 1.3.0-alpha01
hilt-compiler 1.2.0 - - 1.3.0-alpha01
hilt-work 1.2.0 - - 1.3.0-alpha01
hilt-navigation 1.2.0 - - 1.3.0-alpha01
hilt-navigation-compose 1.2.0 - - 1.3.0-alpha01
hilt-navigation-fragment 1.2.0 - - 1.3.0-alpha01
تاريخ آخر تعديل على هذه المكتبة: 7 أيار (مايو) 2025

الملاحظات

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

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

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

الإصدار 1.3 من Hilt

الإصدار 1.3.0-alpha01

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

تم إصدار androidx.hilt:hilt-*:1.3.0-alpha01. يتضمّن الإصدار 1.3.0-alpha01 عمليات الربط هذه.

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

  • تعديل المكتبة ومعالج التعليقات التوضيحية لاستهداف Kotlin 2.0 من أجل إتاحة استخدام سلسلة أدوات Kotlin الأحدث، بما في ذلك KSP2

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

الإصدار 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 واجهات برمجة تطبيقات تتيح للمستخدمين الحصول على @HiltViewModel ViewModel مشروح من إدخال في حزمة Navigation back stack ضمن تطبيق Compose باستخدام :navigation-compose.

تُرجع الدالة hiltViewModel() ViewModel حاليًا أو تنشئ 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)

توافق تطبيق Compose

  • لا يتوافق 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 واجهات برمجة تطبيقات تتيح للمستخدمين الحصول على @HiltViewModel ViewModel مشروح من إدخال في حزمة "التنقّل" للخلف ضمن تطبيق "إنشاء" باستخدام :navigation-compose. يمكن أن تأخذ الدالة hiltNavGraphViewModel() إما NavBackStackEntry أو سلسلة "مسار" يمكن استخدامها لتحديد نطاق ViewModel إما لإدخال الحزمة الخلفية الحالية أو لإدخال رئيسي في الحزمة. (Ia9234)

إصدار Hilt 1.1

الإصدار 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 وNavigation. للاطّلاع على قائمة بالميزات والأمثلة، راجِع مستندات الدمج.

الإصدار 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 الآن تعليقًا توضيحيًا للنوع وتتطلّب استخدام @AssistedInject في الدالة الإنشائية. (Ic2f15)
  • إيقاف @ViewModelInject توفّر الآن @HiltViewModel وظيفة مماثلة، وهي الآن جزء من واجهات برمجة التطبيقات الأساسية لنظام التشغيل Android من Hilt. (I36a41)

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

  • تم إصلاح مشكلة عدم رصد Hilt بشكل صحيح لمكوّنات إضافة AndroidX Hilt، ما يؤدي إلى عدم توفّر "العمال" للإنشاء. (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.