Hilt

ขยายฟังก์ชันการทำงานของ Dagger Hilt เพื่อเปิดใช้การแทรกทรัพยากร Dependency ของคลาสบางคลาสจากไลบรารี androidx
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
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 มีคอมมิตเหล่านี้

Hilt เวอร์ชัน 1.4

เวอร์ชัน 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 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ลดความซับซ้อนของ rememberHiltViewModelFactoryAPI โดยนำพารามิเตอร์ ViewModelStoreOwner ออก ใช้ delegateFactory parameter เพื่อระบุตรรกะโรงงานที่กำหนดเองเมื่อจำเป็น (I3611a)
  • เปิดตัว rememberHiltViewModelFactory() เพื่ออนุญาตให้สร้าง ViewModel ที่แทรก Hilt ด้วยตนเอง ซึ่งจะเป็นประโยชน์อย่างยิ่งเมื่อระบุโรงงานเริ่มต้นให้กับ rememberViewModelStoreOwner API (If7517)

แก้ไขข้อบกพร่อง

  • อัปเดต Compose compileSdk เป็น API 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)

Hilt เวอร์ชัน 1.3

เวอร์ชัน 1.3.0

10 กันยายน 2025

androidx.hilt:hilt-*:1.3.0 เผยแพร่แล้ว เวอร์ชัน 1.3.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.2.0

  • API 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 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • API 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 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • อัปเดตไลบรารีและโปรเซสเซอร์สำหรับคำอธิบายประกอบเพื่อกำหนดเป้าหมาย Kotlin 2.0 เพื่อรองรับ Toolchain ของ Kotlin ที่ใหม่กว่า รวมถึง KSP2

Hilt เวอร์ชัน 1.2

เวอร์ชัน 1.2.0

21 กุมภาพันธ์ 2024

androidx.hilt:hilt-*:1.2.0 เผยแพร่แล้ว เวอร์ชัน 1.2.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.1.0

  • เพิ่มการรองรับการแทรกที่ได้รับความช่วยเหลือไปยัง hiltViewModel() และ hiltNavGraphViewModels() ตอนนี้ฟังก์ชันเหล่านี้จะใช้ Callback เพิ่มเติมซึ่งคุณสามารถใช้ Assisted Factory ที่ส่งเข้ามาเพื่อสร้าง 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 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มฟังก์ชัน hiltViewModel() และ hiltNavGraphViewModels() ที่โอเวอร์โหลดเพื่อรองรับการแทรกที่ได้รับความช่วยเหลือ (Ieb98d)

Hilt เวอร์ชัน 1.1.0

เวอร์ชัน 1.1.0

1 พฤศจิกายน 2023

androidx.hilt:hilt-*:1.1.0 เผยแพร่แล้ว เวอร์ชัน 1.1.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.0.0

  • เพิ่มการรองรับ KSP ไปยัง androidx.hilt
  • ยอมรับ HasDefaultViewModelProviderFactory ใน hiltViewModel()
  • ตอนนี้ hiltViewModel() API จะใช้พารามิเตอร์คีย์ที่ไม่บังคับ

เวอร์ชัน 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 หากต้องการใช้ androidx.hilt เวอร์ชัน KSP คุณต้องเผยแพร่การรองรับ 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 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่ hiltNavGraphViewModel() ไม่แทรก SavedStateHandle (3ef114, b/272099838)

Hilt-Navigation เวอร์ชัน 1.1.0

เวอร์ชัน 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 มีคอมมิตเหล่านี้

Hilt-Navigation-Compose เวอร์ชัน 1.1.0

เวอร์ชัน 1.1.0-alpha01

7 ธันวาคม 2022

androidx.hilt:hilt-navigation-compose:1.1.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha01 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • ตอนนี้ hiltViewModel() API จะใช้พารามิเตอร์คีย์ที่ไม่บังคับ ซึ่งจะช่วยให้คุณได้รับ ViewModel ประเภทเดียวกันหลายอินสแตนซ์โดยใช้คีย์ที่แตกต่างกัน (I6ee47, b/245139957)

Hilt-Navigation-Compose เวอร์ชัน 1.0.0

เวอร์ชัน 1.0.0

26 มกราคม 2022

androidx.hilt:hilt-navigation-compose:1.0.0 เผยแพร่แล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้

ฟีเจอร์หลักของ 1.0.0

อาร์ติแฟกต์ androidx.hilt:hilt-navigation-compose มี API ที่ช่วยให้ผู้ใช้ได้รับ ViewModel ที่มีคำอธิบายประกอบ @HiltViewModel จากรายการ Back Stack ของการนำทางภายในแอปพลิเคชัน Compose โดยใช้ :navigation-compose

ฟังก์ชัน hiltViewModel() จะแสดงผล ViewModel ที่มีอยู่หรือสร้างขึ้นใหม่ซึ่งกำหนดขอบเขตไว้ในกราฟการนำทางปัจจุบันที่แสดงใน Back Stack ของ NavController ฟังก์ชันนี้สามารถเลือกใช้ NavBackStackEntry เพื่อกำหนดขอบเขต ViewModel ให้กับรายการ Back Stack ระดับบนได้

เวอร์ชัน 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 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • นำฟังก์ชัน hiltNavGraphViewModel() ที่เลิกใช้งานแล้วและโอเวอร์โหลดออก ซึ่งทั้งหมดนี้ถูกแทนที่ด้วย hiltViewModel() (Iaf7d7)

เวอร์ชัน 1.0.0-alpha03

16 มิถุนายน 2021

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)

เวอร์ชัน 1.0.0-alpha02

18 พฤษภาคม 2021

androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เปลี่ยนชื่อ hiltNavGraphViewModel() เป็น hiltViewModel() และนำส่วนขยายใน NavController ออกแล้ว เนื่องจากผู้ใช้สามารถใช้ navigation-compose API เพื่อรับ NavBackStackEntry จากเส้นทางได้โดยตรง (I6ef57)

ความเข้ากันได้ของ Compose

  • androidx.hilt:hilt-navigation-compose:1.0.0-alpha02 ใช้ได้กับ Compose เวอร์ชัน 1.0.0-beta07 ขึ้นไปเท่านั้น

การอัปเดตทรัพยากร Dependency

เวอร์ชัน 1.0.0-alpha01

10 มีนาคม 2021

androidx.hilt:hilt-navigation-compose:1.0.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • อาร์ติแฟกต์ :hilt-navigation-compose มี API ที่ช่วยให้ผู้ใช้ได้รับ ViewModel ที่มีคำอธิบายประกอบ @HiltViewModel จากรายการ Back Stack ของการนำทางภายในแอปพลิเคชัน Compose โดยใช้ :navigation-compose ฟังก์ชัน hiltNavGraphViewModel() สามารถรับ NavBackStackEntry หรือสตริง "route" ที่ใช้กำหนดขอบเขต ViewModel ให้เป็นรายการ Back Stack ปัจจุบันหรือรายการหลักในสแต็กได้ (Ia9234)

Hilt เวอร์ชัน 1.1

เวอร์ชัน 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*

Hilt เวอร์ชัน 1.0.0

เวอร์ชัน 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 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • นำประเภท @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 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • จัดเตรียม API สำหรับดึงข้อมูล ViewModel ที่มีคำอธิบายประกอบ @HiltViewModel จาก NavBackStackEntry ของการนำทาง อาร์ติแฟกต์ hilt-navigation-fragment มีส่วนขยาย Kotlin hiltNavGraphViewModels ส่วน hilt-navigation แสดงเมธอดแฟกทอรี HiltViewModelFactory ที่รับ NavBackStackEntry เป็นอาร์กิวเมนต์และแสดงผล ViewModelProvider.Facctory ที่ใช้กับ ViewModelProvider หรือ API การดึงข้อมูลโมเดลมุมมองอื่นๆ ได้ เช่น ฟังก์ชัน viewModel() ของ Compose: viewModel(HiltViewModelFactory(AmbientContext.current, backStackEntry)) (I00e67)

การเปลี่ยนแปลง API

  • แทนที่ @WorkerInject ด้วย @HiltWorker ตอนนี้ @HiltWorker เป็นคำอธิบายประกอบประเภทหนึ่งและต้องใช้ @AssistedInject ในเครื่องมือสร้าง (Ic2f15)
  • เลิกใช้งาน @ViewModelInject ตอนนี้ @HiltViewModel มีฟังก์ชันการทำงานที่เทียบเท่ากัน ซึ่งเป็นส่วนหนึ่งของ API หลักของ Hilt Android แล้ว (I36a41)

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาที่โมดูลส่วนขยาย AndroidX Hilt ไม่ได้รับการเลือกอย่างถูกต้องโดย Hilt ซึ่งทำให้ไม่สามารถสร้าง Worker ได้ (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 เพื่อเปิดใช้การแทรกทรัพยากร Dependency ของคลาสบางคลาสจากไลบรารี androidx