หมายเหตุ
ตารางนี้แสดงอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.annotation
| อาร์ติแฟกต์ | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | รุ่นอัลฟ่า |
|---|---|---|---|---|
| หมายเหตุ | 1.9.1 | - | - | - |
| annotation-experimental | 1.5.1 | - | - | 1.6.0-alpha01 |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มการอ้างอิงใน Annotation คุณต้องเพิ่มที่เก็บ Google Maven ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google
เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับ
แอปหรือโมดูล
Groovy
dependencies { implementation "androidx.annotation:annotation:1.9.1" // To use the Java-compatible @androidx.annotation.OptIn API annotation implementation "androidx.annotation:annotation-experimental:1.5.1" }
Kotlin
dependencies { implementation("androidx.annotation:annotation:1.9.1") // To use the Java-compatible @androidx.annotation.OptIn API annotation implementation("androidx.annotation:annotation-experimental:1.5.1") }
ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพาบิลด์
ความคิดเห็น
ความคิดเห็นของคุณช่วยเราปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมี ไอเดียในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ ในไลบรารีนี้ก่อนสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดย คลิกปุ่มดาว
ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของเครื่องมือติดตามปัญหา
เวอร์ชัน 1.9
เวอร์ชัน 1.9.1
30 ตุลาคม 2024
androidx.annotation:annotation-*:1.9.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.9.1 มีการเปลี่ยนแปลงเหล่านี้
การแก้ไขข้อบกพร่อง
เวอร์ชัน 1.9.0
16 ตุลาคม 2024
androidx.annotation:annotation-*:1.9.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.9.0 มีการเปลี่ยนแปลงเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.8.0
- เพิ่มการรองรับเป้าหมาย Kotlin Multiplatform ต่อไปนี้
watchosDeviceArm64,mingwX64,linuxArm64
เวอร์ชัน 1.9.0-rc01
2 ตุลาคม 2024
androidx.annotation:annotation-*:1.9.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.9.0-rc01 ไม่มีการเปลี่ยนแปลงจากเบต้าก่อนหน้า
เวอร์ชัน 1.9.0-beta01
18 กันยายน 2024
androidx.annotation:annotation-*:1.9.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.9.0-beta01 มีการเปลี่ยนแปลงเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มการรองรับเป้าหมายแพลตฟอร์ม
watchosDeviceArm64(I1cc04, b/364652024)
เวอร์ชัน 1.9.0-alpha03
4 กันยายน 2024
androidx.annotation:annotation-*:1.9.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.9.0-alpha03 ไม่มีการเปลี่ยนแปลงจากเวอร์ชันอัลฟ่าก่อนหน้า
เวอร์ชัน 1.9.0-alpha02
21 สิงหาคม 2024
androidx.annotation:annotation-*:1.9.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.9.0-alpha02 มีการเปลี่ยนแปลงเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มการรองรับแพลตฟอร์ม
mingwX64(I461ca, b/349894318) - เพิ่มการรองรับ
linuxArm64เป้าหมายหลายแพลตฟอร์มของ Kotlin (I139d3, b/338268719)
เวอร์ชัน 1.9.0-alpha01
26 มิถุนายน 2024
androidx.annotation:annotation-*:1.9.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.9.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้
การมีส่วนร่วมภายนอก
- เพิ่มการรองรับ
linuxArm64เป้าหมายหลายแพลตฟอร์ม (ขอขอบคุณ Jake Wharton!)
เวอร์ชัน 1.8
เวอร์ชัน 1.8.2
7 สิงหาคม 2024
androidx.annotation:annotation-*:1.8.2 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.8.2 มีการเปลี่ยนแปลงเหล่านี้
การแก้ไขข้อบกพร่อง
- เพิ่มการรองรับแพลตฟอร์ม
mingwX64(I461ca, b/349894318)
เวอร์ชัน 1.8.1
24 กรกฎาคม 2024
androidx.annotation:annotation-*:1.8.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.8.1 มีการเปลี่ยนแปลงเหล่านี้
การแก้ไขข้อบกพร่อง
- รวมเป้าหมาย Kotlin Multiplatform เพิ่มเติม:
watchos,tvos
เวอร์ชัน 1.8.0
14 พฤษภาคม 2024
androidx.annotation:annotation-*:1.8.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.8.0 มีการเปลี่ยนแปลงเหล่านี้
การเปลี่ยนแปลงสำคัญตั้งแต่เวอร์ชัน 1.7.0
- เพิ่มคำอธิบายประกอบ
@ReplaceWithเพื่อแสดงการแทนที่ API ที่เลิกใช้งานแล้ว - ระบบได้ย้ายข้อมูลเสริม
@MainThreadไปยังชุดแหล่งข้อมูลทั่วไปแล้ว
เวอร์ชัน 1.8.0-rc01
1 พฤษภาคม 2024
androidx.annotation:annotation-*:1.8.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.8.0-rc01 ไม่มีการเปลี่ยนแปลงนับตั้งแต่รุ่นเบต้าก่อนหน้า
เวอร์ชัน 1.8.0-beta02
17 เมษายน 2024
androidx.annotation:annotation-*:1.8.0-beta02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.8.0-beta02 ไม่มีการเปลี่ยนแปลงใดๆ จากรุ่นก่อนหน้า
เวอร์ชัน 1.8.0-beta01
3 เมษายน 2024
androidx.annotation:annotation-*:1.8.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.8.0-beta01 มีการเปลี่ยนแปลงเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้คำอธิบายประกอบ
ReplaceWithมีความเสถียรของ API แล้ว แต่การตรวจสอบ Lint ที่เชื่อมโยงกับการแก้ไขอัตโนมัติยังไม่ได้เผยแพร่
เวอร์ชัน 1.8.0-alpha02
20 มีนาคม 2024
androidx.annotation:annotation-*:1.8.0-alpha02 เปิดตัวโดยไม่มีการเปลี่ยนแปลงที่สำคัญ เวอร์ชัน 1.8.0-alpha02 มีการเปลี่ยนแปลงเหล่านี้
เวอร์ชัน 1.8.0-alpha01
21 กุมภาพันธ์ 2024
androidx.annotation:annotation-*:1.8.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.8.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม
@ReplaceWithคำอธิบายประกอบเพื่อแสดงการแทนที่ API ที่เลิกใช้งานแล้ว (I38db3, b/322373864)
การมีส่วนร่วมภายนอก
- ขอขอบคุณ Ivan Matkov ที่ย้ายคำอธิบายประกอบ
@MainThreadไปยังชุดแหล่งข้อมูลทั่วไป (6f228c)
เวอร์ชัน 1.7
เวอร์ชัน 1.7.1
13 ธันวาคม 2023
androidx.annotation:annotation-*:1.7.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.7.1 มีคอมมิตเหล่านี้
การแก้ไขข้อบกพร่อง
- ใช้
compilescope เมื่อแทรกการขึ้นต่อกันของแพลตฟอร์มเริ่มต้น (I4958f)
เวอร์ชัน 1.7.0
6 กันยายน 2023
androidx.annotation:annotation-*:1.7.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.7.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.6.0
- รวมถึงอาร์ติแฟกต์ Kotlin Multiplatform ที่กำหนดเป้าหมายไปยังแพลตฟอร์ม iOS, Linux และ MacOS
- ตอนนี้คุณใช้คำอธิบายประกอบในโปรเจ็กต์ KMM ได้แล้ว โปรดทราบว่าเป้าหมายที่ไม่ใช่ Android ของคำอธิบายประกอบยังคงเป็นเวอร์ชันทดลอง แต่เราตัดสินใจที่จะผสานเวอร์ชันต่างๆ เพื่อให้นักพัฒนาแอปทดลองใช้ได้ง่ายขึ้น กล่าวคือ คำอธิบายประกอบบางรายการอาจย้ายไปมาระหว่างโค้ดทั่วไปและโค้ดเฉพาะแพลตฟอร์มในระหว่างการพัฒนาเวอร์ชันอัลฟ่าขณะที่เรากำหนดขอบเขต
เวอร์ชัน 1.7.0-rc01
23 สิงหาคม 2023
androidx.annotation:annotation-*:1.7.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.7.0-rc01 มีคอมมิตเหล่านี้
รุ่นนี้ไม่มีการเปลี่ยนแปลงจากรุ่นเบต้าก่อนหน้า
เวอร์ชัน 1.7.0-beta01
9 สิงหาคม 2023
androidx.annotation:annotation-*:1.7.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.7.0-beta01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- API ที่เสถียรสำหรับการเปิดตัว
เวอร์ชัน 1.7.0-alpha03
26 กรกฎาคม 2023
androidx.annotation:annotation-*:1.7.0-alpha03 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.7.0-alpha03 มีคอมมิตต่อไปนี้
การแก้ไขข้อบกพร่อง
- การเผยแพร่ POM ของ Maven ตอนนี้รวมอาร์ติแฟกต์แบบหลายแพลตฟอร์มที่กำหนดเป้าหมายเป็น JVM เริ่มต้นเป็นทรัพยากร Dependency แล้ว
เวอร์ชัน 1.7.0-alpha02
24 มีนาคม 2023
androidx.annotation:annotation-*:1.7.0-alpha02 ได้รับการเผยแพร่แล้ว
การแก้ไขข้อบกพร่อง
- นำข้อจำกัดของ Dependency ออกจากอาร์ติแฟกต์ Maven เพื่อแก้ปัญหาการบิลด์ในเป้าหมาย Kotlin Native (b/274786186, KT-57531)
เวอร์ชัน 1.7.0-alpha01
22 มีนาคม 2023
androidx.annotation:annotation-*:1.7.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.7.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- รวมถึงอาร์ติแฟกต์ Kotlin Multiplatform ที่กำหนดเป้าหมายไปยังแพลตฟอร์ม iOS, Linux และ MacOS
- ตอนนี้คุณใช้คำอธิบายประกอบในโปรเจ็กต์ KMM ได้แล้ว โปรดทราบว่าเป้าหมายที่ไม่ใช่ Android ของคำอธิบายประกอบยังคงเป็นเวอร์ชันทดลอง แต่เราตัดสินใจที่จะผสานเวอร์ชันต่างๆ เพื่อให้นักพัฒนาแอปทดลองใช้ได้ง่ายขึ้น กล่าวคือ คำอธิบายประกอบบางรายการอาจย้ายไปมาระหว่างโค้ดทั่วไปและโค้ดเฉพาะแพลตฟอร์มในระหว่างการพัฒนาเวอร์ชันอัลฟ่าขณะที่เรากำหนดขอบเขต
เวอร์ชัน 1.6
เวอร์ชัน 1.6.0
22 กุมภาพันธ์ 2023
androidx.annotation:annotation:1.6.0 และ androidx.annotation:annotation-jvm:1.6.0 เปิดตัวแล้ว เวอร์ชัน 1.6.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงสำคัญตั้งแต่เวอร์ชัน 1.5.0
- เพิ่มคำอธิบายประกอบ
@RequiresExtensionเพื่อระบุว่า API ต้องใช้ SDK ของส่วนขยายเวอร์ชันใดเวอร์ชันหนึ่ง (I5e4fe) - แปลงไลบรารีคำอธิบายประกอบเพื่อสร้างโดยใช้เครื่องมือ Kotlin Multiplatform (I3be8d)
เวอร์ชัน 1.6.0-rc01
8 กุมภาพันธ์ 2023
androidx.annotation:annotation:1.6.0-rc01 และ androidx.annotation:annotation-jvm:1.6.0-rc01 เปิดตัวแล้ว เวอร์ชัน 1.6.0-rc01 มีคอมมิตต่อไปนี้
- เราได้ปรับปรุงคำอธิบายประกอบให้เสถียรสำหรับรุ่นที่อาจได้รับการเผยแพร่ 1.6.0-rc01 แล้ว
เวอร์ชัน 1.6.0-beta01
25 มกราคม 2023
androidx.annotation:annotation:1.6.0-beta01 และ androidx.annotation:annotation-jvm:1.6.0-beta01 จะเปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 1.6.0-alpha01
เวอร์ชัน 1.6.0-alpha01
11 มกราคม 2023
androidx.annotation:annotation-*:1.6.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.6.0-alpha01 มีคอมมิตเหล่านี้
เวอร์ชัน 1.6.0-dev01
8 กุมภาพันธ์ 2023
androidx.annotation:annotation-*:1.6.0-dev01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.6.0-dev01 มีคอมมิตเหล่านี้
- Annotation ได้เปิดใช้ Kotlin Multiplatform สำหรับ Developer Preview 1.6.0-dev01 แล้ว
ฟีเจอร์ใหม่
- เพิ่มคำอธิบายประกอบ
@RequiresExtensionเพื่อระบุว่า API ต้องใช้ SDK ส่วนขยายเวอร์ชันใดเวอร์ชันหนึ่ง (I5e4fe) - แปลงไลบรารีคำอธิบายประกอบเพื่อสร้างโดยใช้เครื่องมือ Kotlin Multiplatform (I3be8d)
เวอร์ชัน 1.5.0
เวอร์ชัน 1.5.0
21 กันยายน 2022
androidx.annotation:annotation:1.5.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.4.0
- เราได้ย้ายข้อมูลไลบรารีคำอธิบายประกอบไปยังแหล่งที่มาของ Kotlin อย่างเต็มรูปแบบแล้ว ซึ่งส่งผลให้รองรับเว็บไซต์ที่ใช้เป้าหมายเฉพาะของ Kotlin และฟีเจอร์คำอธิบายประกอบอื่นๆ ที่เข้ากันได้กับ Kotlin
เวอร์ชัน 1.5.0-rc01
7 กันยายน 2022
androidx.annotation:annotation:1.5.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-rc01 มีคอมมิตเหล่านี้
- ไม่มีการเปลี่ยนแปลงจากรุ่นเบต้า 1.5.0 ก่อนหน้า
เวอร์ชัน 1.5.0-beta01
24 สิงหาคม 2022
androidx.annotation:annotation:1.5.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-beta01 มีคอมมิตเหล่านี้
- ไม่มีการเปลี่ยนแปลงจากรุ่นก่อนหน้า เราได้หยุดการเปลี่ยนแปลง API สำหรับเวอร์ชันเบต้าแล้ว
เวอร์ชัน 1.5.0-alpha02
10 สิงหาคม 2022
androidx.annotation:annotation:1.5.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha02 มีคอมมิตต่อไปนี้
- ไม่มีการเปลี่ยนแปลงจากรุ่นอัลฟ่าก่อนหน้า
เวอร์ชัน 1.5.0-alpha01
27 กรกฎาคม 2022
androidx.annotation:annotation:1.5.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้ย้ายข้อมูลไลบรารีคำอธิบายประกอบไปยังแหล่งที่มาของ Kotlin อย่างเต็มรูปแบบแล้ว ซึ่งส่งผลให้รองรับเว็บไซต์ที่ใช้เป้าหมายเฉพาะของ Kotlin และฟีเจอร์คำอธิบายประกอบอื่นๆ ที่เข้ากันได้กับ Kotlin
เวอร์ชัน 1.4.0
เวอร์ชัน 1.4.0
15 มิถุนายน 2022
androidx.annotation:annotation:1.4.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงสำคัญตั้งแต่เวอร์ชัน 1.3.0
@RestrictToได้รับการย้ายข้อมูลไปยังแหล่งที่มาของ Kotlin แล้ว และตอนนี้รองรับเว็บไซต์ที่ใช้@fileด้วยเหตุนี้ ไลบรารีคำอธิบายประกอบจึงขึ้นอยู่กับไลบรารีมาตรฐานของ Kotlin@ReturnThis(b/140249763): ตรวจสอบว่าเมธอดการลบล้างของเมธอดนี้ต้องแสดงผลอินสแตนซ์เดียวกัน (มีไว้สำหรับผู้สร้าง เป็นต้น)@OpenForTesting(b/141539024): คลาสและเมธอด Kotlin ที่ทำเครื่องหมายเป็น "open" สามารถใส่คำอธิบายประกอบด้วยคำอธิบายประกอบนี้ได้ และ Lint จะตรวจสอบว่าคลาสนี้เป็นเพียงคลาสย่อย (และเมธอดที่เขียนทับเท่านั้น) จากการทดสอบหน่วย@DeprecatedSinceApi(b/37116481): ระบุว่าเมธอด (หรือคลาสหรือฟิลด์) ที่มีคำอธิบายประกอบเป็นส่วนหนึ่งของไลบรารี Backport สำหรับ API ของแพลตฟอร์ม ซึ่งไม่จำเป็นอีกต่อไปใน API ระดับที่ระบุ@EmptySuper: ระบุว่ามีการกำหนดให้เมธอดนี้ว่างเปล่า ดังนั้นเมื่อแทนที่ คุณจึงไม่จำเป็นต้องเรียกใช้ (และไม่ควรเรียกใช้ด้วยซ้ำ เช่น อาจมีการตรวจสอบความเข้ากันได้แบบย้อนหลัง)
เวอร์ชัน 1.4.0-rc01
1 มิถุนายน 2022
androidx.annotation:annotation:1.4.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-rc01 มีคอมมิตต่อไปนี้
- เราได้สรุป API Surface และฟังก์ชันการทำงานสำหรับการเปิดตัวแล้ว
เวอร์ชัน 1.4.0-beta01
18 พฤษภาคม 2022
androidx.annotation:annotation:1.4.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-beta01 มีคอมมิตเหล่านี้
- ไม่มีการเปลี่ยนแปลงนับตั้งแต่เวอร์ชันอัลฟ่าล่าสุด เราได้ล็อกพื้นผิว API สำหรับการเปิดตัวเวอร์ชันเบต้าแล้ว
เวอร์ชัน 1.4.0-alpha02
9 กุมภาพันธ์ 2022
androidx.annotation:annotation:1.4.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
เพิ่มคำอธิบายประกอบ
@ReturnThis,@OpenForTesting,@EmptySuperและ@DeprecatedSinceApi(21946a2)@ReturnThis(b/140249763): ตรวจสอบว่าวิธีการลบล้างของวิธีการนี้ต้องแสดงผลอินสแตนซ์เดียวกัน (มีไว้สำหรับผู้สร้าง ฯลฯ)@OpenForTesting(b/141539024): คลาสและเมธอด Kotlin ที่ทำเครื่องหมายเป็น "open" สามารถใส่คำอธิบายประกอบด้วยคำอธิบายประกอบนี้ได้ และ Lint จะตรวจสอบว่าคลาสนี้เป็นเพียงคลาสย่อย (และเมธอดเป็นเพียงเมธอดที่เขียนทับ) จากการทดสอบหน่วยเท่านั้น@DeprecatedSinceApi(b/37116481): ระบุว่าเมธอด (หรือคลาสหรือฟิลด์) ที่มีคำอธิบายประกอบเป็นส่วนหนึ่งของไลบรารี Backport สำหรับ API ของแพลตฟอร์ม ซึ่งไม่จำเป็นอีกต่อไปใน API ระดับที่ระบุ@EmptySuper: ระบุว่าวิธีการนี้กำหนดให้ว่างเปล่า ดังนั้นเมื่อลบล้าง คุณจึงไม่จำเป็นต้องเรียกใช้ (และในความเป็นจริงไม่ควรเรียกใช้ เช่น อาจมีการตรวจสอบความเข้ากันได้แบบย้อนหลัง)
เวอร์ชัน 1.4.0-alpha01
15 ธันวาคม 2021
androidx.annotation:annotation:1.4.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ย้ายข้อมูลคำอธิบายประกอบ
RestrictToไปยังแหล่งที่มาของ Kotlin (Ia6336)
เวอร์ชัน 1.3.0
เวอร์ชัน 1.3.0
3 พฤศจิกายน 2021
androidx.annotation:annotation:1.3.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.2.0
@Discouragedคำอธิบายประกอบสำหรับการทำเครื่องหมาย API ที่ไม่สามารถเลิกใช้งานได้อย่างสมเหตุสมผล แต่มีผลกระทบด้านลบต่อประสิทธิภาพอย่างมาก และไม่ควรเรียกใช้ในโค้ดเวอร์ชันที่ใช้งานจริงตามปกติ@Contextเพื่อทำเครื่องหมายบริบททั่วไปเพื่อให้นักพัฒนาแอปย้ายข้อมูลไปยัง API ใหม่ได้ง่ายขึ้น@GravityIntคำอธิบายประกอบสำหรับการทำเครื่องหมายองค์ประกอบที่มีค่าแรงโน้มถ่วงที่บรรจุลงในจำนวนเต็ม- เลิกใช้งาน
@InspectablePropertyแล้วหันมาใช้@Attributeแทนสำหรับandroidx.resourceinspection
เวอร์ชัน 1.3.0-rc01
27 ตุลาคม 2021
androidx.annotation:annotation:1.3.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-rc01 มีคอมมิตต่อไปนี้
เวอร์ชัน 1.3.0-beta01
29 กันยายน 2021
androidx.annotation:annotation:1.3.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ต้องระบุคำอธิบายใน "ข้อความ" สำหรับ @Discouraged (I3390f)
- เพิ่มคำอธิบายประกอบ @Discouraged สำหรับการทำเครื่องหมายองค์ประกอบที่ไม่แนะนำ (Ib2549)
- ทำให้คำอธิบายประกอบ RestrictTo ปรากฏในป๊อปอัปเอกสาร Studio (Ie8e1a, b/183134648)
การแก้ไขข้อบกพร่อง
- เพิ่มคำอธิบายประกอบบริบทเพื่อทำเครื่องหมายบริบททั่วไป เพื่อให้นักพัฒนาแอป ย้ายข้อมูลไปยัง API ใหม่ได้ง่ายขึ้น (Ie581a)
เวอร์ชัน 1.3.0-alpha01
24 มีนาคม 2021
androidx.annotation:annotation:1.3.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เลิกใช้งาน
@InspectablePropertyเพื่อใช้@Attributeแทนในandroidx.resourceinspection(Ic0eff) - เพิ่มคำอธิบายประกอบ
@GravityIntสำหรับการทำเครื่องหมายองค์ประกอบที่มีค่าแรงโน้มถ่วงที่บรรจุลงในจำนวนเต็ม (Ifcaa4, b/180620048)
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.6
เวอร์ชัน 1.6.0-alpha01
22 ตุลาคม 2025
androidx.annotation:annotation-experimental:1.6.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.6.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้คำอธิบายประกอบ
OptInรองรับElementType.PARAMETERเป้าหมายแล้ว
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.5
รุ่น 1.5.1
16 กรกฎาคม 2025
androidx.annotation:annotation-experimental:1.5.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.1 มีการเปลี่ยนแปลงเหล่านี้
เวอร์ชัน 1.5.0
7 พฤษภาคม 2025
androidx.annotation:annotation-experimental:1.5.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0 มีการเปลี่ยนแปลงเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.4.0
- เพิ่ม
messageในRequiresOptInเพื่อให้ตรงกับคำอธิบายประกอบ Kotlin stdlib ที่มีค่าสตริงว่างเริ่มต้น (I1f50e) - ตอนนี้ไลบรารีนี้กำหนดเป้าหมายเป็นระดับภาษา Kotlin 2.0 และต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
เวอร์ชัน 1.5.0-rc01
23 เมษายน 2025
androidx.annotation:annotation-experimental:1.5.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-rc01 ไม่มีการเปลี่ยนแปลงใดๆ นับตั้งแต่รุ่นเบต้าก่อนหน้า โปรดดูการคอมมิต
เวอร์ชัน 1.5.0-beta01
9 เมษายน 2025
androidx.annotation:annotation-experimental:1.5.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-beta01 มีการเปลี่ยนแปลงเหล่านี้
การเปลี่ยนแปลงที่สำคัญ
- ตอนนี้ไลบรารีนี้กำหนดเป้าหมายเป็นระดับภาษา Kotlin 2.0 และต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
เวอร์ชัน 1.5.0-alpha01
21 สิงหาคม 2024
androidx.annotation:annotation-experimental:1.5.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.5.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม
messageลงในRequiresOptInเพื่อให้ตรงกับคำอธิบายประกอบ Kotlin stdlib ที่มีค่าสตริงว่างเริ่มต้น (I1f50e)
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.4
เวอร์ชัน 1.4.1
3 เมษายน 2024
androidx.annotation:annotation-experimental:1.4.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.1 มีการคอมมิตเหล่านี้
การแก้ไขข้อบกพร่อง
- แก้ไขการใช้งาน
isKotlinเพื่อหลีกเลี่ยงการเรียกใช้การตรวจสอบRequiresOptInในไฟล์ Kotlin โดยไม่ตั้งใจ (I2d8c1f)
เวอร์ชัน 1.4.0
24 มกราคม 2024
androidx.annotation:annotation-experimental:1.4.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงสำคัญตั้งแต่เวอร์ชัน 1.3.0
- เพิ่มการรองรับ Kotlin หลายแพลตฟอร์ม
- แก้ไขความเข้ากันได้กับ Kotlin 2.0
- แสดงคำเตือนสำหรับการใช้งานพร็อพเพอร์ตี้ Kotlin ที่มีคำอธิบายประกอบแบบทดลองใน Java (I8bd43)
- แก้ไขตำแหน่งของคำอธิบายประกอบการแก้ไขอัตโนมัติในเมธอด Kotlin (Id7a41)
เวอร์ชัน 1.4.0-rc01
10 มกราคม 2024
androidx.annotation:annotation-experimental:1.4.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-rc01 ไม่มีการเปลี่ยนแปลงจากรุ่นก่อนหน้า
เวอร์ชัน 1.4.0-beta01
13 ธันวาคม 2023
androidx.annotation:annotation-experimental:1.4.0-beta01 ได้รับการเผยแพร่แล้ว ไม่มีการเปลี่ยนแปลงใดๆ ตั้งแต่รุ่นก่อนหน้า
เวอร์ชัน 1.4.0-alpha01
29 พฤศจิกายน 2023
androidx.annotation:annotation-experimental:1.4.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-alpha01 มีคอมมิตเหล่านี้
การแก้ไขข้อบกพร่อง
- นำคำแนะนำการแก้ไขอัตโนมัติระดับชั้นเรียนออกชั่วคราวเพื่อหลีกเลี่ยงปัญหา b/301598518 (Id98b2)
- แสดงคำเตือนสำหรับการใช้งานพร็อพเพอร์ตี้ Kotlin ที่มีคำอธิบายประกอบแบบทดลองใน Java (I8bd43)
- แก้ไขตำแหน่งของคำอธิบายประกอบการแก้ไขอัตโนมัติในเมธอด Kotlin (Id7a41)
เวอร์ชัน 1.4.0-dev01
8 กุมภาพันธ์ 2023
androidx.annotation:annotation-experimental:1.4.0-dev01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.4.0-dev01 มีคอมมิตเหล่านี้
- Annotation-experimental ได้เปิดใช้ Kotlin Multiplatform สำหรับ Developer Preview 1.4.0-dev01 แล้ว
Annotation-Experimental เวอร์ชัน 1.3.1
เวอร์ชัน 1.3.1
21 มิถุนายน 2023
androidx.annotation:annotation-experimental:1.3.1 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.1 มีคอมมิตเหล่านี้
การแก้ไขข้อบกพร่อง
- วางคำอธิบายประกอบไว้ที่จุดเริ่มต้นของรายการตัวแก้ไขเมื่อใช้การแก้ไขอัตโนมัติของ Lint (b/251172715)
- ใช้การตรวจสอบ Lint เพื่อไม่ให้ใช้
androidx.annotation.RequiresOptInในแหล่งที่มาของ Kotlin (b/241097743)
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.3.0
เวอร์ชัน 1.3.0
7 กันยายน 2022
androidx.annotation:annotation-experimental:1.3.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.2.0
- เพิ่มการรองรับการใช้
@androidx.annotation.OptInระดับแพ็กเกจ (I24d58) - ย้ายการอ้างอิง stdlib ของ Kotlin ไปยังประเภท API แทนที่จะเป็นเฉพาะการคอมไพล์ ซึ่งหมายความว่าไคลเอ็นต์ทั้งหมดของไลบรารี Annotation-Experimental จะรวมไลบรารีมาตรฐาน Kotlin ไว้ในการอ้างอิงแบบทรานซิทีฟ
เวอร์ชัน 1.3.0-rc01
24 สิงหาคม 2022
androidx.annotation:annotation-experimental:1.3.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-rc01 มีคอมมิตต่อไปนี้
- ไม่มีการเปลี่ยนแปลงจากรุ่นก่อนหน้า เราได้หยุดการใช้งานสำหรับ RC แล้ว
เวอร์ชัน 1.3.0-beta01
10 สิงหาคม 2022
androidx.annotation:annotation-experimental:1.3.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-beta01 มีคอมมิตเหล่านี้
- ไม่มีการเปลี่ยนแปลงจากเวอร์ชันอัลฟ่า ไลบรารีนี้ได้รับการปรับให้เสถียรแล้วสำหรับการเปิดตัวเวอร์ชันเบต้า
เวอร์ชัน 1.3.0-alpha01
27 กรกฎาคม 2022
androidx.annotation:annotation-experimental:1.3.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.3.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มการรองรับการใช้
@androidx.annotation.OptInระดับแพ็กเกจ (I24d58)
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.2.0
เวอร์ชัน 1.2.0
15 ธันวาคม 2021
androidx.annotation:annotation-experimental:1.2.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.1.0
ตอนนี้ไลบรารีนี้กำหนดเป้าหมายเป็นระดับภาษา Java 8
เวอร์ชัน 1.2.0-rc01
1 ธันวาคม 2021
androidx.annotation:annotation-experimental:1.2.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-rc01 มีคอมมิตเหล่านี้
ไม่มีการเปลี่ยนแปลงจากเวอร์ชันเบต้า
เวอร์ชัน 1.2.0-beta01
17 พฤศจิกายน 2021
androidx.annotation:annotation-experimental:1.2.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
เราได้สรุป API สำหรับเวอร์ชันเบต้าแล้ว
Annotation-Experimental เวอร์ชัน 1.2.0-alpha01
30 มิถุนายน 2021
androidx.annotation:annotation-experimental:1.2.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-alpha01 มีคอมมิตต่อไปนี้
ฟีเจอร์ใหม่
- ตอนนี้ไลบรารีกำหนดเป้าหมายระดับภาษา Java 8 แล้ว
เวอร์ชัน 1.2.0
เวอร์ชัน 1.2.0
24 มีนาคม 2021
androidx.annotation:annotation:1.2.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.1.0
- เพิ่ม
@ChecksSdkIntAtLeastคำอธิบายประกอบ ซึ่งใช้เพื่อระบุเมธอดหรือฟิลด์ที่ใช้ในการควบคุมการเข้าถึงในระดับ SDK และเป็นไปตามการตรวจสอบNewApiLint - เพิ่ม
@DoNotInlineคำอธิบายประกอบซึ่งจับคู่กับกฎ Proguard เพื่อป้องกันไม่ให้มีการแทรกสมาชิกในระหว่างการเพิ่มประสิทธิภาพ - ตอนนี้คำอธิบายประกอบต่างๆ จะมีคำอธิบายประกอบด้วย
@Documentedเพื่อให้มั่นใจว่าคำอธิบายประกอบจะปรากฏในเอกสารประกอบสำหรับสมาชิกที่มีคำอธิบายประกอบ
เวอร์ชัน 1.2.0-rc01
24 กุมภาพันธ์ 2021
androidx.annotation:annotation:1.2.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-rc01 มีคอมมิตเหล่านี้
เวอร์ชัน 1.2.0-beta01
13 มกราคม 2021
androidx.annotation:annotation:1.2.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
@DoNotInlineคำอธิบายประกอบใหม่ซึ่งสั่งให้เครื่องมือเพิ่มประสิทธิภาพโค้ด (เช่น Proguard, R8) ไม่แทรกเมธอดที่มีคำอธิบายประกอบ (I3dfe8, b/141326133)
เวอร์ชัน 1.2.0-alpha01
14 พฤษภาคม 2020
androidx.annotation:annotation:1.2.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.2.0-alpha01 มีคอมมิตต่อไปนี้
ฟีเจอร์ใหม่
- เพิ่มคำอธิบายประกอบ
@ChecksSdkIntAtLeastแล้ว ซึ่งจะช่วยให้ androidx และผู้ใช้สามารถใส่คำอธิบายประกอบในเมธอดและฟิลด์ที่แสดงถึงการตรวจสอบSDK_INTได้ (I89a54, b/120255046)
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.1.0
เวอร์ชัน 1.1.0
7 เมษายน 2021
androidx.annotation:annotation-experimental:1.1.0 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.1.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.0.0
- เราได้เขียนคำอธิบายประกอบทดลองของ Jetpack ใหม่ใน Kotlin เพื่อรองรับคลาสเครื่องหมายหลายรายการและปรับปรุงการจัดการการเลิกใช้งาน
- เพิ่มคำอธิบายประกอบ
RequiresOptInและOptInเพื่อให้สอดคล้องกับ Kotlin และเลิกใช้งานคำอธิบายประกอบExperimentalและUsesExperimentalแล้ว
เวอร์ชัน 1.1.0-rc02
24 มีนาคม 2021
androidx.annotation:annotation-experimental:1.1.0-rc02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.1.0-rc02 มีคอมมิตเหล่านี้
การแก้ไขข้อบกพร่อง
- เพิ่มกฎ Proguard เพื่อให้แน่ใจว่าการเพิ่มประสิทธิภาพโค้ดจะไม่เตือนเกี่ยวกับ Meta-Annotation ของ Kotlin ที่ขาดหายไป
เวอร์ชัน 1.1.0-rc01
10 มีนาคม 2021
androidx.annotation:annotation-experimental:1.1.0-rc01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.1.0-rc01 มีคอมมิตเหล่านี้
ไม่มีการเปลี่ยนแปลงตั้งแต่รุ่นเบต้าก่อนหน้า
เวอร์ชัน 1.1.0-beta01
27 มกราคม 2021
androidx.annotation:annotation-experimental:1.1.0-beta01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.1.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราเลิกใช้งานแอนนอเทชัน Experimental ในรูปแบบ androidx แล้ว เพื่อให้สอดคล้องกับ Kotlin โดยเราได้แทนที่ด้วยตัวแปร androidx ของ คำอธิบายประกอบ RequiresOptIn และได้อัปเดต Linter ที่หันหน้าไปทาง Java เพื่อ รองรับทั้งคำอธิบายประกอบ Kotlin ใหม่และตัวแปร androidx ใหม่ (I52495, b/151331381)
เวอร์ชัน 1.1.0-alpha01
22 กรกฎาคม 2020
androidx.annotation:annotation-experimental:1.1.0-alpha01 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ไลบรารีคำอธิบายประกอบเวอร์ชันทดลองเขียนด้วย Kotlin แต่ไม่จำเป็นต้องรวมไลบรารีมาตรฐานของ Kotlin เป็นการขึ้นต่อกัน ซึ่งมีไฟล์ Proguard ที่อนุญาตให้ลบข้อมูลเมตา Kotlin ที่ไม่จำเป็นออกจากโปรเจ็กต์ที่ใช้เฉพาะภาษาโปรแกรม Java
@UseExperimentalรองรับคลาสเครื่องหมายหลายรายการแล้ว (aosp/1185577, b/145137892)
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.0.0
คำอธิบายประกอบ - เวอร์ชันทดลอง 1.0.0
7 พฤศจิกายน 2019
androidx.annotation:annotation-experimental:1.0.0 และ androidx.annotation:annotation-experimental-lint:1.0.0 จะเปิดตัวโดยไม่มีการเปลี่ยนแปลงใดๆ นับตั้งแต่ 1.0.0-rc01 เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้
ฟีเจอร์หลักของเวอร์ชัน 1.0.0
- การบังคับใช้ความหมายของ Kotlin
@Experimentalในซอร์สโค้ด Java โดยอิงตาม Lint - Annotation ของ Java ที่ให้ลักษณะการทำงานเทียบเท่ากับ Annotation
@Experimentalและ@UseExperimentalของ Kotlin โดยไม่ต้องพึ่งพา Kotlin
Annotation-Experimental เวอร์ชัน 1.0.0-rc01
23 ตุลาคม 2019
androidx.annotation:annotation-experimental:1.0.0-rc01 และ androidx.annotation:annotation-experimental-lint:1.0.0-rc01 เปิดตัวแล้ว เวอร์ชัน 1.0.0-rc01 มีคอมมิตเหล่านี้
ปัญหาที่ทราบแล้ว
เมื่อใช้ Studio 3.5 เวอร์ชันเสถียร คำเตือนจากเครื่องมือตรวจหาการใช้ @Experimental จะไม่แสดงใน IDE สำหรับการใช้ Java ที่ไม่ถูกต้องของคำอธิบายประกอบ @Experimental ของ Kotlin ดู b/140640322
Annotation-Experimental เวอร์ชัน 1.0.0-beta01
9 ตุลาคม 2019
androidx.annotation:annotation-experimental:1.0.0-beta01 และ androidx.annotation:annotation-experimental-lint:1.0.0-beta01 จะเปิดตัวโดยไม่มีการเปลี่ยนแปลงใดๆ นับตั้งแต่เวอร์ชัน 1.0.0-alpha01 เวอร์ชัน 1.0.0-beta01 มีคอมมิตเหล่านี้
Annotation-Experimental เวอร์ชัน 1.0.0-alpha01
18 กันยายน 2019
androidx.annotation:annotation-experimental:1.0.0-alpha01 และ androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 เปิดตัวแล้ว โดยมีคอมมิตที่รวมอยู่ใน annotation-experimental 1.0.0-alpha01 และคอมมิตที่รวมอยู่ใน annotation-experimental-lint 1.0.0-alpha01
ฟีเจอร์ใหม่
ไลบรารีคำอธิบายประกอบ Jetpack Experimental มีการใช้งานที่เข้ากันได้กับ Java สำหรับเครื่องหมาย API ทดลองของ Kotlin อาร์ติแฟกต์
-lintมีการใช้งานข้อจำกัดการใช้งานทดลองตาม Lint และบังคับใช้ข้อจำกัดในการใช้งาน Java ของเครื่องหมาย API ทดลองดั้งเดิมของ Kotlinเมื่อใช้
annotation-experimentalอาร์ติแฟกต์เป็นทรัพยากร Dependency ระบบจะบังคับใช้กฎ Lint ที่annotation-experimental-lintอาร์ติแฟกต์ระบุโดยอัตโนมัติ
เวอร์ชัน 1.1.0
เวอร์ชัน 1.1.0
5 มิถุนายน 2019
androidx.annotation:annotation:1.1.0 จะเปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 1.1.0-rc01
เวอร์ชัน 1.1.0-rc01
7 พฤษภาคม 2019
androidx.annotation:annotation:1.1.0-rc01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 1.1.0-beta01 ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
เวอร์ชัน 1.1.0-beta01
3 เมษายน 2019
androidx.annotation:annotation:1.1.0-beta01 ได้รับการเผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
@InspectablePropertyคำอธิบายประกอบใหม่เพื่อรองรับ API การตรวจสอบมุมมองใหม่ที่เพิ่มใน Android 10 คำอธิบายประกอบนี้ใช้กับตัวรับค่าในมุมมองหรือองค์ประกอบ UI อื่นๆ ได้ เครื่องมือสร้างโค้ดอาจใช้เพื่อสร้างออบเจ็กต์เสริมที่แมปชื่อพร็อพเพอร์ตี้และรหัสแอตทริบิวต์กับค่าพร็อพเพอร์ตี้โดยไม่มีค่าใช้จ่ายในการสะท้อน
การเปลี่ยนแปลง API
- การเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้อง: มีการเปลี่ยน
@ContentViewเป็นคำอธิบายประกอบของตัวสร้าง และนำค่า@LayoutResออก คลาสที่ต้องการรองรับคำอธิบายประกอบ@ContentViewควรเพิ่มคำอธิบายประกอบนี้ลงในตัวสร้างที่ใช้พารามิเตอร์@LayoutRes intซึ่งจะแก้ไขปัญหาเมื่อใช้คำอธิบายประกอบนี้ในโมดูลไลบรารี (b/128352521)
เวอร์ชัน 1.1.0-alpha02
13 มีนาคม 2019
androidx.annotation:annotation:1.1.0-alpha02 ได้รับการเผยแพร่แล้ว ดูรายการคอมมิตทั้งหมดที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ขอบเขตการจำกัด API ใหม่:
RestrictTo.Scope.LIBRARY_GROUP_PREFIXโดยจะจำกัดการใช้งานไว้ที่โค้ดภายในแพ็กเกจซึ่งกลุ่มใช้คำนำหน้ากลุ่มไลบรารีเดียวกันจนถึง.(จุด) สุดท้าย เช่น เนื่องจากไลบรารีfoo.bar:lib1และfoo.baz:lib2ใช้คำนำหน้าfooร่วมกัน จึงใช้ API ของกันและกันได้ ซึ่งจำกัดไว้สำหรับขอบเขตนี้ ในทำนองเดียวกันcom.foo.bar:lib1และcom.foo.baz:lib2จะแชร์คำนำหน้าcom.foo.และแชร์ API ที่จำกัดไว้ในขอบเขตนั้นได้ อย่างไรก็ตาม ไลบรารีcom.bar.qux:lib3จะใช้ API ที่ถูกจำกัดไม่ได้เนื่องจากแชร์เฉพาะคำนำหน้าcom.และไม่ได้แชร์จนถึง.(จุด) สุดท้าย
เวอร์ชัน 1.1.0-alpha01
30 มกราคม 2019
androidx.annotation:annotation 1.1.0-alpha01 ได้รับการเผยแพร่แล้ว
ฟีเจอร์ใหม่
- เพิ่ม
@ContentViewคำอธิบายประกอบที่ช่วยให้คุณระบุได้ว่าควรขยายไฟล์ XML ของเลย์เอาต์ใด ฟีเจอร์นี้รองรับในComponentActivityในรุ่น1.0.0-alpha04และFragmentในรุ่น1.1.0-alpha04เพื่อเป็นทางเลือกแทนการใช้setContentView()หรือการลบล้างonCreateView()ตามลำดับ (aosp/837619)
เวอร์ชัน 1.0.2
เวอร์ชัน 1.0.2
25 กุมภาพันธ์ 2019
androidx.annotation:annotation 1.0.2 ได้รับการเผยแพร่แล้ว
แก้ไขข้อบกพร่อง
- แก้ไขกฎ R8/ProGuard ที่ฝังอยู่ใน JAR ซึ่งอ้างอิงถึงประเภท
android.support.annotationเก่าอย่างไม่ถูกต้องแทนที่จะเป็นandroidx.annotationหมายเหตุ: การดำเนินการนี้จะมีผลกับบิลด์ของคุณก็ต่อเมื่อคุณไม่ได้ใช้getDefaultProguardFileเนื่องจากกฎเริ่มต้นเหล่านั้นมีกฎที่ถูกต้องสำหรับทั้ง 2 แพ็กเกจด้วย (aosp/891685) - เพิ่มกฎ R8/ProGuard ที่เก็บคำอธิบายประกอบ @Keep ไว้โดยชัดแจ้ง ซึ่งจะช่วยให้มั่นใจได้ว่า ProGuard จะไม่นำคำอธิบายประกอบออกจากประเภทก่อนที่จะปฏิบัติตามความหมายของคำอธิบายประกอบนั้นจริงๆ หมายเหตุ: การดำเนินการนี้จะมีผลกับบิลด์ของคุณก็ต่อเมื่อคุณไม่ได้ใช้
getDefaultProguardFileเนื่องจากกฎเริ่มต้นเหล่านั้นมีกฎที่ถูกต้องสำหรับทั้ง 2 แพ็กเกจด้วย (aosp/903818)