Hilt

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

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

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

الملاحظات

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

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

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

الإصدار 1.3 من Hilt

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

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

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

  • تم إصلاح المشكلة المتمثّلة في عدم إدخال 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 حاليًا أو تنشئ 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، ما يؤدي إلى عدم إتاحة إنشاء 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.