Hilt

يمكنك توسيع وظائف Dagger Hilt لتفعيل حقن التبعية لفئات معيّنة من مكتبات androidx.
آخر تحديث الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫1 يوليو 2026 1.4.0 - - -

الملاحظات

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

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

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

Hilt-Common

الإصدار 1.4

الإصدار 1.4.0

‫1 يوليو 2026

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

الإصدار 1.4 من Hilt

الإصدار 1.4.0-rc01

‫3 يونيو 2026

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

لم يتم إجراء أي تغييرات مهمة منذ الإصدار 1.4.0-alpha01.

الإصدار ‎1.4.0-beta01

‫22 أبريل 2026

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

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

  • تبسيط واجهة برمجة التطبيقات rememberHiltViewModelFactory من خلال إزالة المَعلمة ViewModelStoreOwner استخدِم delegateFactory parameter لتوفير منطق مخصّص للمصنع عند الضرورة. (I3611a)
  • يمكنك تقديم rememberHiltViewModelFactory() للسماح بإنشاء ViewModels يدويًا باستخدام Hilt. ويكون ذلك مفيدًا بشكل خاص عند توفير مصنع تلقائي لواجهة برمجة التطبيقات rememberViewModelStoreOwner. (If7517)

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

  • تم تحديث Compose compileSdk إلى واجهة برمجة التطبيقات 37. يعني ذلك أنّ الحد الأدنى المطلوب لإصدار AGP هو 9.2.0 عند استخدام Compose. (Id45cd، b/413674743)

الإصدار 1.4.0-alpha01

‫25 مارس 2026

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

  • يتطلّب إصدار المكتبة الآن أن يكون إصدار KGP‏ 2.2.0 على الأقل (I39f21، b/477205839)

الإصدار 1.3 من Hilt

الإصدار 1.3.0

‫10 سبتمبر 2025

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

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

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

الإصدار 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.

الإصدار 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 هذه التعديلات.

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

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

  • تم إصلاح مشكلة عدم إدخال SavedStateHandle في hiltNavGraphViewModel(). (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)

توافق 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 واجهات برمجة تطبيقات تتيح للمستخدمين الحصول على ViewModel يتضمّن تعليقات توضيحية من @HiltViewModel من إدخال الأنشطة السابقة في ميزة "التنقّل" ضمن تطبيق 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 هذه التعديلات.

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

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

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

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