Hilt

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

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

العناصر الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
hilt-common 1.2.0 1.3.0-rc01 - -
hilt-compiler 1.2.0 1.3.0-rc01 - -
hilt-work 1.2.0 1.3.0-rc01 - -
hilt-navigation 1.2.0 1.3.0-rc01 - -
hilt-navigation-compose 1.2.0 1.3.0-rc01 - -
hilt-navigation-fragment 1.2.0 1.3.0-rc01 - -
تم إجراء آخر تعديل على هذه المكتبة في: 27 أغسطس 2025

الملاحظات

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

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

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

الإصدار 1.3 من Hilt

الإصدار 1.3.0-rc01

‫27 أغسطس 2025

تم إصدار androidx.hilt:hilt-*:1.3.0-rc01 بدون أي تغييرات ملحوظة منذ الإصدار 1.3.0-beta01. يتضمّن الإصدار 1.3.0-rc01 هذه التعديلات.

الإصدار 1.3.0-beta01

‫13 أغسطس 2025

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

الإصدار 1.3.0-alpha02

‫2 يوليو 2025

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

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

  • تم نقل واجهات برمجة التطبيقات hiltViewModel() الخاصة بـ Compose إلى عنصر جديد (androidx.hilt:hilt-lifecycle-viewmodel-compose) وحزمة جديدة (androidx.hilt.lifecycle.viewmodel.compose) حتى يمكن استخدامها بدون الاعتماد بشكل غير مباشر على androidx.navigation. (Ifb222، b/328104152)

الإصدار 1.3.0-alpha01

‫7 مايو 2025

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

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

  • يعدّل المكتبة ومعالج التعليقات التوضيحية لاستهداف الإصدار 2.0 من Kotlin من أجل توفير الدعم لسلسلة أدوات 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 الرئيسية.

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

الإصدار 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 مزوَّد بتعليقات توضيحية من إدخال في سجلّ التصفّح الخلفي ضمن تطبيق 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 من Compose والإصدارات الأحدث.

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

الإصدار 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 و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 Navigation تقدّم الأداة 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)

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

  • تم إصلاح المشكلة التي كانت تتسبب في عدم اختيار وحدات AndroidX Hilt الإضافية بشكلٍ صحيح من خلال 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.