Hilt

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

الملاحظات

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

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

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

Hilt-Common

الإصدار 1.4

الإصدار 1.4.0

‫01 يوليو 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 من واجهة برمجة التطبيقات. وهذا يعني أنّه يجب توفُّر الإصدار 9.2.0 أو إصدار أحدث من "مكوّن Android الإضافي" عند استخدام 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 هذه التعديلات.

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

  • يتم تعديل المكتبة ومعالج التعليقات التوضيحية لاستهداف الإصدار 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 البرمجية واجهات برمجة تطبيقات تتيح للمستخدمين الحصول على @HiltViewModel ViewModel مزوّد بتعليقات توضيحية من إدخال في سجلّ التصفّح الخلفي ضمن تطبيق 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 إلا مع الإصدار 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.hiltartifacts إضافات لدمج 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 الآن وظائف مكافئة، وهي أصبحت جزءًا من واجهات برمجة التطبيقات الأساسية في Hilt Android. (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 غير مُدرَج في 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.