Hilt

عملکرد Dagger Hilt را گسترش دهید تا تزریق وابستگی کلاس‌های خاصی از کتابخانه‌های androidx فعال شود.
جدیدترین به‌روزرسانی نسخه پایدار نامزد انتشار انتشار نسخه بتا نسخه آلفا
‫۱ ژوئیه ۲۰۲۶ ۱.۴.۰ - - -

بازخورد

بازخوردتان به بهبود Jetpack کمک می‌کند. اگر مشکل جدیدی پیدا کردید یا ایده‌ای برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل‌از ایجاد مشکل جدید، مشکلات موجود در این کتابخانه را بررسی کنید. با کلیک کردن روی دکمه ستاره می‌توانید رأی خود را به مشکل موجود اضافه کنید.

ایجاد مشکل جدید

برای اطلاعات بیشتر، مستندات Issue Tracker را ببینید.

Hilt-Common

نسخه ۱.۴

نسخه ۱.۴.۰

‫۱ ژوئیه ۲۰۲۶

‫androidx.hilt:hilt-*:1.4.0 منتشر شده است. نسخه ۱.۴.۰ حاوی این ارسال‌ها است.

Hilt نسخه ۱.۴

نسخه 1.4.0-rc01

‫۳ ژوئن ۲۰۲۶

‫androidx.hilt:hilt-*:1.4.0-rc01 منتشر شده است. نسخه 1.4.0-rc01 حاوی این ارسال‌ها است.

از نسخه 1.4.0-alpha01 تغییر قابل‌توجهی ایجاد نشده است.

نسخه 1.4.0-beta01

‫۲۲ آوریل ۲۰۲۶

‫androidx.hilt:hilt-*:1.4.0-beta01 منتشر شده است. نسخه 1.4.0-beta01 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • با برداشتن پارامتر ViewModelStoreOwner، rememberHiltViewModelFactoryAPI را ساده کنید. درصورت لزوم، از delegateFactory parameter برای ارائه منطق کارخانه سفارشی استفاده کنید. (I3611a)
  • ‫rememberHiltViewModelFactory() را معرفی کنید تا امکان ایجاد دستی ViewModels تزریق‌شده با Hilt فراهم شود. این امر به‌ویژه هنگام ارائه کارخانه پیش‌فرض به rememberViewModelStoreOwner API مفید است. (If7517)

رفع اشکال‌ها

  • Compose compileSdk به API 37 به‌روز شد. این یعنی هنگام استفاده از Compose، حداقل AGP نسخه ۹.۲.۰ لازم است. (Id45cd، b/413674743)

نسخه 1.4.0-alpha01

‫۲۵ مارس ۲۰۲۶

‫androidx.hilt:hilt-*:1.4.0-alpha01 منتشر شده است. نسخه 1.4.0-alpha01 حاوی این موارد ثبت است.

  • نسخه کتابخانه اکنون به نسخه KGP حداقل ۲.۲.۰ نیاز دارد (I39f21، b/477205839)

Hilt نسخه ۱.۳

نسخه ۱.۳.۰

‫۱۰ سپتامبر ۲۰۲۵

‫androidx.hilt:hilt-*:1.3.0 منتشر شده است. نسخه ۱.۳.۰ حاوی این ثبت‌ها است.

تغییرات مهم از نسخه ۱.۲.۰:

  • میاناهای برنامه‌سازی کاربردی hiltViewModel() برای Compose به آرتیفکت (androidx.hilt:hilt-lifecycle-viewmodel-compose) و بسته (androidx.hilt.lifecycle.viewmodel.compose) جدیدی منتقل شده‌اند تا بتوان بدون وابستگی گذرا به androidx.navigation از آن‌ها استفاده کرد.

نسخه 1.3.0-rc01

‫۲۷ اوت ۲۰۲۵

‫androidx.hilt:hilt-*:1.3.0-rc01 بدون تغییر قابل‌توجهی نسبت‌به نسخه 1.3.0-beta01 منتشر شده است. نسخه 1.3.0-rc01 حاوی این موارد ثبت است.

نسخه 1.3.0-beta01

‫۱۳ اوت ۲۰۲۵

‫androidx.hilt:hilt-*:1.3.0-beta01 منتشر شده است. نسخه 1.3.0-beta01 حاوی این موارد ثبت است.

نسخه 1.3.0-alpha02

‫۲ ژوئیه ۲۰۲۵

‫androidx.hilt:hilt-*:1.3.0-alpha02 منتشر شده است. نسخه 1.3.0-alpha02 حاوی این commitها است.

تغییرات میانای برنامه‌سازی کاربردی

  • میاناهای برنامه‌سازی کاربردی hiltViewModel() برای Compose به آرتیفکت (androidx.hilt:hilt-lifecycle-viewmodel-compose) و بسته (androidx.hilt.lifecycle.viewmodel.compose) جدیدی منتقل شده‌اند تا بتوان بدون وابستگی گذرا به androidx.navigation از آن‌ها استفاده کرد. (Ifb222، b/328104152)

نسخه 1.3.0-alpha01

۷ مه ۲۰۲۵

‫androidx.hilt:hilt-*:1.3.0-alpha01 منتشر شده است. نسخه 1.3.0-alpha01 حاوی این ارسال‌ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • پردازشگر گزارمان و کتابخانه را برای هدف قرار دادن Kotlin 2.0 به‌روز می‌کند تا از زنجیره ابزار Kotlin جدیدتر ازجمله KSP2 پشتیبانی کند.

Hilt نسخه ۱.۲

نسخه ۱.۲.۰

‫۲۱ فوریه ۲۰۲۴

‫androidx.hilt:hilt-*:1.2.0 منتشر شده است. نسخه ۱.۲.۰ حاوی این ارسال‌ها است.

تغییرات مهم از نسخه ۱.۱.۰

  • پشتیبانی از تزریق کمکی را به hiltViewModel() و hiltNavGraphViewModels() اضافه کنید. اکنون این توابع یک فراخوانی برگشتی اضافی می‌گیرند که در آن می‌توانید از کارخانه کمکی ارسال‌شده برای ایجاد ViewModel تزریق‌شده کمکی استفاده کنید.

نسخه 1.2.0-rc01

۷ فوریه ۲۰۲۴

‫androidx.hilt:hilt-*:1.2.0-rc01 منتشر شده است. نسخه 1.2.0-rc01 حاوی این commit-ها است.

نسخه 1.2.0-beta01

‫۲۴ ژانویه ۲۰۲۴

‫androidx.hilt:hilt-*:1.2.0-beta01 منتشر شده است. نسخه 1.2.0-beta01 شامل این ارسال‌ها است.

نسخه 1.2.0-alpha01

‫۱۳ دسامبر ۲۰۲۳

‫androidx.hilt:hilt-*:1.2.0-alpha01 منتشر شده است. نسخه 1.2.0-alpha01 حاوی این commit-ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • افزودن توابع hiltViewModel() و hiltNavGraphViewModels() سربارگذاری‌شده برای پشتیبانی از تزریق کمکی. (Ieb98d)

Hilt نسخه ۱.۱.۰

نسخه ۱.۱.۰

۱ نوامبر ۲۰۲۳

‫androidx.hilt:hilt-*:1.1.0 منتشر شده است. نسخه ۱.۱.۰ حاوی این ثبت‌ها است.

تغییرات عمده از نسخه ۱.۰.۰

  • افزودن پشتیبانی KSP به androidx.hilt.
  • HasDefaultViewModelProviderFactory را در hiltViewModel() بپذیرید.
  • اکنون hiltViewModel() API یک پارامتر کلید اختیاری می‌گیرد.

نسخه 1.1.0-rc01

‫۱۸ اکتبر ۲۰۲۳

‫androidx.hilt:hilt-*:1.1.0-rc01 منتشر شده است. نسخه 1.1.0-rc01 شامل این commit-ها است.

نسخه 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

۹ اوت ۲۰۲۳

‫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 حاوی این commitها است.

ویژگی‌های جدید

  • افزودن پشتیبانی KSP به androidx.hilt. توجه داشته باشید که این کار برای آماده شدن برای پشتیبانی KSP از Hilt است. برای استفاده از نسخه KSP از androidx.hilt، پشتیبانی اصلی Hilt باید منتشر شود.

Hilt-Navigation-Fragment نسخه ۱.۱.۰

نسخه 1.1.0-alpha02

‫۱۹ آوریل ۲۰۲۳

‫androidx.hilt:hilt-navigation-fragment:1.1.0-alpha02 منتشر شده است. نسخه 1.1.0-alpha02 حاوی این commit-ها است.

تغییرات میانای برنامه‌سازی کاربردی

رفع اشکال‌ها

  • مشکلی که باعث می‌شد hiltNavGraphViewModel() SavedStateHandle را تزریق نکند برطرف شد. (3ef114، b/272099838)

Hilt-Navigation نسخه ۱.۱.۰

نسخه 1.1.0-alpha02

‫۱۹ آوریل ۲۰۲۳

‫androidx.hilt:hilt-navigation:1.1.0-alpha02 منتشر شده است. نسخه 1.1.0-alpha02 حاوی این commit-ها است.

نسخه 1.1.0-alpha01

‫۷ دسامبر ۲۰۲۲

‫androidx.hilt:hilt-navigation:1.1.0-alpha01 منتشر شده است. نسخه 1.1.0-alpha01 حاوی این commitها است.

Hilt-Navigation-Compose نسخه ۱.۱.۰

نسخه 1.1.0-alpha01

‫۷ دسامبر ۲۰۲۲

‫androidx.hilt:hilt-navigation-compose:1.1.0-alpha01 منتشر شده است. نسخه 1.1.0-alpha01 حاوی این commitها است.

تغییرات میانای برنامه‌سازی کاربردی

  • اکنون hiltViewModel() API یک پارامتر کلید اختیاری می‌گیرد. این کار به شما امکان می‌دهد بااستفاده از کلیدهای مختلف، چندین نمونه از یک نوع ViewModel را دریافت کنید. (I6ee47، b/245139957)

Hilt-Navigation-Compose نسخه ۱.۰.۰

نسخه ۱.۰.۰

‫۲۶ ژانویه ۲۰۲۲

‫androidx.hilt:hilt-navigation-compose:1.0.0 منتشر شده است. نسخه ۱.۰.۰ حاوی این ارسال‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

ساخته androidx.hilt:hilt-navigation-compose میاناهای برنامه‌سازی کاربردی‌ای ارائه می‌دهد که به کاربران اجازه می‌دهد ViewModel حاشیه‌نویسی‌شده با @HiltViewModel را از ورودی پشته قبلی‌ها در «پیمایش» در برنامه Compose بااستفاده از :navigation-compose دریافت کنند.

تابع hiltViewModel() یک ViewModel موجود را برمی‌گرداند یا یک تابع جدید با محدوده نمودار پیمایش فعلی موجود در پشته قبلی‌ها NavController ایجاد می‌کند. تابع می‌تواند به‌طور اختیاری یک NavBackStackEntry بگیرد تا ViewModel را به یک ورودی پشته قبلی‌ها والد محدود کند.

نسخه 1.0.0-rc01

‫۱۵ دسامبر ۲۰۲۱

androidx.hilt:hilt-navigation-compose:1.0.0-rc01 بدون هیچ تغییری از 1.0.0-beta01 منتشر شده است. نسخه 1.0.0-rc01 شامل این commit-ها است.

نسخه 1.0.0-beta01

‫۱۷ نوامبر ۲۰۲۱

‫androidx.hilt:hilt-navigation-compose:1.0.0-beta01 منتشر شده است. نسخه 1.0.0-beta01 شامل این commit-ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • تابع hiltNavGraphViewModel() منسوخ‌شده و سربارهای آن را بردارید. همه این‌ها با hiltViewModel() جایگزین شدند. (Iaf7d7)

نسخه 1.0.0-alpha03

‫۱۶ ژوئن ۲۰۲۱

‫androidx.hilt:hilt-navigation-compose:1.0.0-alpha03 منتشر شده است. نسخه 1.0.0-alpha03 حاوی این commit-ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • روش hiltViewModel() اکنون با تغییرات میانای برنامه‌سازی کاربردی viewModel() در Lifecycle-ViewModel-Compose 1.0.0-alpha07 همسو شده است و اکنون پارامتر اختیاری ViewModelStoreOwner را می‌گیرد، به‌جای اینکه نسخه‌ای بدون شناسه و نسخه‌ای داشته باشد که فقط NavBackStackEntry را می‌گیرد. این به شما امکان می‌دهد همچنان از hiltViewModel() برای دسترسی به مالک پیش‌فرض ارائه‌شده توسط LocalViewModelStoreOwner استفاده کنید یا از hiltViewModel(navBackStackEntry) یا ViewModelStoreOwner دیگری برای مشخص کردن مالک خاصی استفاده کنید. (I2628d)

نسخه 1.0.0-alpha02

‫۱۸ مه ۲۰۲۱

‫androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 منتشر شده است. نسخه 1.0.0-alpha02 حاوی این commit-ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • نام hiltNavGraphViewModel() به hiltViewModel() تغییر کرد و افزونه NavController برداشته شد زیرا کاربر می‌تواند مستقیماً از میانای برنامه‌سازی کاربردی navigation-compose برای دریافت NavBackStackEntry از مسیر استفاده کند. (I6ef57)

سازگاری Compose

  • androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 فقط با Compose نسخه 1.0.0-beta07 و بالاتر سازگار است.

به‌روزرسانی‌های وابستگی

نسخه 1.0.0-alpha01

‫۱۰ مارس ۲۰۲۱

‫androidx.hilt:hilt-navigation-compose:1.0.0-alpha01 منتشر شده است. نسخه 1.0.0-alpha01 حاوی این commit-ها است.

ویژگی‌های جدید

  • مصنوع :hilt-navigation-compose میاناهای برنامه‌سازی کاربردی‌ای ارائه می‌دهد که به کاربران اجازه می‌دهد بااستفاده از :navigation-compose، ViewModel حاشیه‌نویسی‌شده @HiltViewModel را از ورودی پشته قبلی‌ها در «پیمایش» در برنامه Compose دریافت کنند. تابع hiltNavGraphViewModel() می‌تواند یک NavBackStackEntry یا یک رشته «مسیر» را بگیرد که می‌تواند برای محدود کردن ViewModel به ورودی پشته قبلی‌ها فعلی یا به ورودی والد در پشته استفاده شود. (Ia9234)

Hilt نسخه ۱.۱

نسخه 1.1.0-beta01

‫۴ اکتبر ۲۰۲۳

‫androidx.hilt:hilt-*:1.1.0-beta01 منتشر شده است. نسخه 1.1.0-beta01 حاوی این commit-ها است.

androidx.hilt:hilt-*:1.1.0-beta01 بدون هیچ تغییری از 1.1.0-alpha* منتشر شده است.

Hilt نسخه ۱.۰.۰

نسخه ۱.۰.۰

‫۵ مه ۲۰۲۱

‫androidx.hilt:hilt-*:1.0.0 منتشر شده است. نسخه ۱.۰.۰ حاوی این ارسال‌ها است.

ویژگی‌های اصلی نسخه ۱.۰.۰

androidx.hiltمصنوعات افزونه‌هایی را برای ادغام Hilt با کتابخانه‌های مختلف دیگر AndroidX، مانند WorkManager و Navigation، ارائه می‌دهد. برای دیدن فهرست ویژگی‌ها و نمونه‌ها، اسناد ادغام را بررسی کنید.

نسخه 1.0.0-beta01

‫۱۰ مارس ۲۰۲۱

‫androidx.hilt:hilt-*:1.0.0-beta01 منتشر شده است. نسخه 1.0.0-beta01 شامل این commit-ها است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫@Deprecated نوع را از مصنوعات AndroidX Hilt، به‌ویژه @androidx.hilt.ViewModelInject و @androidx.hilt.Assisted، بردارید. توجه داشته باشید که @ViewModelInject با @HiltViewModel جایگزین شده است. (I626fe)

نسخه 1.0.0-alpha03

‫۲۷ ژانویه ۲۰۲۱

‫androidx.hilt:hilt-*:1.0.0-alpha03 منتشر شده است. نسخه 1.0.0-alpha03 حاوی این commit-ها است.

ویژگی‌های جدید

  • میاناهای برنامه‌سازی کاربردی برای بازیابی @HiltViewModel ViewModel حاشیه‌نویسی‌شده از 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)

رفع اشکال‌ها

  • رفع مشکلی که باعث می‌شد «ماژول‌های» افزونه AndroidX Hilt به‌درستی توسط Hilt انتخاب نشوند و درنتیجه «کارگران» برای ایجاد دردسترس نباشند. (I3181c، b/159540434)
  • انتقال دادن افزونه‌های AndroidX Hilt به SingletonComponent، برداشتن هشدار منسوخ‌شده استفاده از ApplicationCompoonent. (I9c916، b/175849092)

نسخه 1.0.0-alpha02

‫۲۲ ژوئیه ۲۰۲۰

‫androidx.hilt:hilt-*:1.0.0-alpha02 منتشر شده است. نسخه 1.0.0-alpha02 حاوی این commit-ها است.

رفع اشکال‌ها

  • مشکل کلیدهای وضعیت ذخیره‌شده تکراری وقتی که ViewModel تزریق‌شده غیرHilt از کلاس حاشیه‌نویسی‌شده @AndroidEntryPoint درخواست می‌شد برطرف شد. (b/158737069)
  • مشکلی در HiltWorkerFactory برطرف شد که باعث می‌شد کلاس‌های Worker تودرتو که با @WorkerInject حاشیه‌نویسی شده‌اند به‌درستی مقداردهی اولیه نشوند. (b/160524718)

نسخه 1.0.0-alpha01

‫۱۰ ژوئن ۲۰۲۰ (۲۱ خرداد ۱۳۹۹)

‫androidx.hilt:hilt-*:1.0.0-alpha01 منتشر شده است. نسخه 1.0.0-alpha01 حاوی این commit-ها است.

بسته و کتابخانه‌های androidx.hilt عملکرد Dagger Hilt را گسترش می‌دهند تا تزریق وابستگی کلاس‌های خاصی از کتابخانه‌های androidx را فعال کنند.