هیلت

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

بازخورد

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

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۴

نسخه ۱.۴.۰-آلفا۰۱

۲۵ مارس ۲۰۲۶

androidx.hilt:hilt-*:1.4.0-alpha01 منتشر شد. نسخه 1.4.0-alpha01 شامل این کامیت‌ها است.

  • نسخه کتابخانه اکنون مستلزم آن است که نسخه KGP حداقل 2.2.0 باشد ( I39f21 ، b/477205839 )

نسخه ۱.۳ هیلت

نسخه ۱.۳.۰

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

androidx.hilt:hilt-*:1.3.0 منتشر شد. نسخه ۱.۳.۰ شامل این کامیت‌ها است.

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

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

نسخه ۱.۳.۰-rc01

۲۷ آگوست ۲۰۲۵

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

نسخه ۱.۳.۰-بتا۰۱

۱۳ آگوست ۲۰۲۵

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

نسخه ۱.۳.۰-آلفا۰۲

۲ ژوئیه ۲۰۲۵

androidx.hilt:hilt-*:1.3.0-alpha02 منتشر شد. نسخه 1.3.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

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

نسخه ۱.۳.۰-آلفا۰۱

۷ مه ۲۰۲۵

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

تغییرات API

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

نسخه ۱.۲ هیلت

نسخه ۱.۲.۰

۲۱ فوریه ۲۰۲۴

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

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

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

نسخه ۱.۲.۰-rc01

۷ فوریه ۲۰۲۴

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

نسخه ۱.۲.۰-بتا۰۱

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

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

نسخه ۱.۲.۰-آلفا۰۱

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

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

تغییرات API

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

نسخه ۱.۱.۰ هیلت

نسخه ۱.۱.۰

۱ نوامبر ۲۰۲۳

androidx.hilt:hilt-*:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

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

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

نسخه ۱.۱.۰-rc01

۱۸ اکتبر ۲۰۲۳

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

نسخه ۱.۱.۰-بتا۰۱

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 منتشر شدند.

نسخه ۱.۱.۰-آلفا۰۱

۹ آگوست ۲۰۲۳

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

نسخه ۱.۱.۰-آلفا۰۲

۱۹ آوریل ۲۰۲۳

androidx.hilt:hilt-navigation-fragment:1.1.0-alpha02 منتشر شد. نسخه 1.1.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

رفع اشکالات

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

نسخه ۱.۱.۰ ناوبری با دستگیره

نسخه ۱.۱.۰-آلفا۰۲

۱۹ آوریل ۲۰۲۳

androidx.hilt:hilt-navigation:1.1.0-alpha02 منتشر شد. نسخه 1.1.0-alpha02 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-آلفا۰۱

۷ دسامبر ۲۰۲۲

androidx.hilt:hilt-navigation:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

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

نسخه ۱.۱.۰-آلفا۰۱

۷ دسامبر ۲۰۲۲

androidx.hilt:hilt-navigation-compose:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

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

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

نسخه ۱.۰.۰

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

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

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

آرتیفکت androidx.hilt:hilt-navigation-compose رابط‌های برنامه‌نویسی کاربردی (API) ارائه می‌دهد که به کاربران اجازه می‌دهد با استفاده از :navigation-compose یک ViewModel حاشیه‌نویسی‌شده با @HiltViewModel را از یک ورودی پشته ناوبری در یک برنامه Compose دریافت کنند.

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

نسخه ۱.۰.۰-rc01

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

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

نسخه ۱.۰.۰-بتا۰۱

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

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

تغییرات API

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

نسخه ۱.۰.۰-آلفا۰۳

۱۶ ژوئن ۲۰۲۱

androidx.hilt:hilt-navigation-compose:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

تغییرات API

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

نسخه ۱.۰.۰-آلفا۰۲

۱۸ مه ۲۰۲۱

androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

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

سازگاری با آهنگسازی

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

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

نسخه ۱.۰.۰-آلفا۰۱

۱۰ مارس ۲۰۲۱

androidx.hilt:hilt-navigation-compose:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

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

  • آرتیفکت :hilt-navigation-compose رابط‌های برنامه‌نویسی کاربردی (API) ارائه می‌دهد که به کاربران اجازه می‌دهد با استفاده از :navigation-compose ، یک ViewModel حاشیه‌نویسی‌شده با @HiltViewModel را از یک ورودی پشته ناوبری در یک برنامه Compose دریافت کنند. تابع hiltNavGraphViewModel() می‌تواند یک NavBackStackEntry یا یک رشته 'route' را دریافت کند که می‌تواند برای محدود کردن ViewModel به ورودی پشته فعلی یا به یک ورودی والد در پشته استفاده شود. ( Ia9234 )

نسخه ۱.۱ هیلت

نسخه ۱.۱.۰-بتا۰۱

۴ اکتبر ۲۰۲۳

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

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

نسخه ۱.۰.۰ هیلت

نسخه ۱.۰.۰

۵ مه ۲۰۲۱

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

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

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

نسخه ۱.۰.۰-بتا۰۱

۱۰ مارس ۲۰۲۱

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

تغییرات API

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

نسخه ۱.۰.۰-آلفا۰۳

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

androidx.hilt:hilt-*:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

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

  • APIهایی برای بازیابی ViewModel حاشیه‌نویسی‌شده با @HiltViewModel از یک Navigation NavBackStackEntry ارائه می‌دهد. قطعه کد hilt-navigation-fragment یک افزونه کاتلین hiltNavGraphViewModels ارائه می‌دهد در حالی که hilt-navigation یک متد کارخانه‌ای HiltViewModelFactory را در معرض نمایش قرار می‌دهد که NavBackStackEntry را به عنوان آرگومان دریافت می‌کند و یک ViewModelProvider.Facctory برمی‌گرداند که می‌تواند با ViewModelProvider یا سایر APIهای بازیابی View Model، مانند تابع viewModel() در Compose، استفاده شود: viewModel(HiltViewModelFactory(AmbientContext.current, backStackEntry)) . ( I00e67 )

تغییرات API

  • @WorkerInject با @HiltWorker جایگزین کنید. @HiltWorker اکنون یک نوع حاشیه‌نویسی است و نیاز به استفاده از @AssistedInject در سازنده دارد. ( Ic2f15 )
  • @ViewModelInject منسوخ شود. اکنون عملکرد معادل آن توسط @HiltViewModel ارائه می‌شود که اکنون بخشی از APIهای اصلی اندروید Hilt است. ( I36a41 )

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۲

۲۲ ژوئیه ۲۰۲۰

androidx.hilt:hilt-*:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

رفع اشکالات

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

نسخه ۱.۰.۰-آلفا۰۱

۱۰ ژوئن ۲۰۲۰

androidx.hilt:hilt-*:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

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