Hilt
| آخر تحديث | الإصدار المستقر | إصدار محتمل | الإصدار التجريبي | الإصدار الأولي |
|---|---|---|---|---|
| 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 هذه التعديلات.
التغييرات في واجهة برمجة التطبيقات
- قبول
HasDefaultViewModelProviderFactoryفيhiltViewModel()(I10ab6، b/249548618، b/195190169)
إصلاح الأخطاء
- تم إصلاح مشكلة عدم إدخال
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-Compose1.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 والإصدارات الأحدث.
تحديثات الاعتماديات
- يعتمد
hilt-navigation-composeالآن على Navigation2.4.0-alpha01.
الإصدار 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.