Hilt

يمكنك توسيع نطاق وظائف Dagger Hilt لتفعيل ميزة إدخال التبعيات لبعض الفئات من مكتبات AndroidX.
آخر خبر الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫22 أبريل 2026 1.3.0 - ‎1.4.0-beta01 -

الملاحظات

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

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

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

الإصدار 1.4 من Hilt

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

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

  • تم تعديل compileSdk في Compose إلى واجهة برمجة التطبيقات 37. ويعني هذا أنّه يجب توفُّر إصدار 9.2.0 من "مكوّن Android Gradle" (AGP) على الأقل عند استخدام 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 يوليو 2022

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

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

  • تم تعديل المكتبة ومعالج التعليقات التوضيحية لاستهداف 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 واجهات برمجة تطبيقات تسمح للمستخدمين بالحصول على `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 واجهات برمجة تطبيقات تسمح للمستخدمين بالحصول على @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 هذه التعديلات.

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

  • تم توفير واجهات برمجة تطبيقات لاسترداد `ViewModel` تم وضع علامة @HiltViewModel عليه من NavBackStackEntry في Navigation. يوفّر العنصر hilt-navigation-fragment إضافة Kotlin hiltNavGraphViewModels، بينما يعرض 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 الإضافية، ما يؤدي إلى عدم توفُّر أدوات Worker للإنشاء. (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.