หมายเหตุ
ตารางนี้แสดงรายการอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.annotation
อาร์ติแฟกต์ | รุ่นที่เสถียร | ตัวเลือกถอนการอ้างสิทธิ์ | รุ่นเบต้า | รุ่นอัลฟ่า |
---|---|---|---|---|
หมายเหตุ | 1.8.2 | - | - | 1.9.0-alpha01 |
การทดสอบคำอธิบายประกอบ | 1.4.1 | - | - | - |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency สำหรับคำอธิบายประกอบ คุณต้องเพิ่มที่เก็บ Google Maven ไปยัง อ่านที่เก็บ Maven ของ Google เพื่อดูข้อมูลเพิ่มเติม
เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle
สำหรับ
ในแอปหรือโมดูล
ดึงดูด
dependencies { implementation "androidx.annotation:annotation:1.8.2" // To use the Java-compatible @androidx.annotation.OptIn API annotation implementation "androidx.annotation:annotation-experimental:1.4.1" }
Kotlin
dependencies { implementation("androidx.annotation:annotation:1.8.2") // To use the Java-compatible @androidx.annotation.OptIn API annotation implementation("androidx.annotation:annotation-experimental:1.4.1") }
ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากร Dependency ได้ที่หัวข้อเพิ่มการอ้างอิงของบิลด์
ความคิดเห็น
ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมี ไอเดียในการปรับปรุงไลบรารีนี้ โปรดดูที่ ปัญหาที่มีอยู่ ในไลบรารีนี้ก่อนที่จะสร้างใหม่ คุณสามารถเพิ่มการโหวตให้กับปัญหาที่มีอยู่ได้โดย คลิกปุ่มดาว
ดูเอกสารประกอบเกี่ยวกับเครื่องมือติดตามปัญหา เพื่อดูข้อมูลเพิ่มเติม
เวอร์ชัน 1.9
เวอร์ชัน 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 เพิ่มเติม:
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 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ใช้ขอบเขต
compile
เมื่อแทรกทรัพยากร Dependency ของแพลตฟอร์มเริ่มต้น (I4958f)
เวอร์ชัน 1.7.0
6 กันยายน 2023
ปล่อย androidx.annotation:annotation-*:1.7.0
แล้ว เวอร์ชัน 1.7.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.6.0
- รวมอาร์ติแฟกต์ของ Kotlin หลายแพลตฟอร์มที่กำหนดเป้าหมายเป็นแพลตฟอร์ม 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 (b/274786186, KT-57531)
เวอร์ชัน 1.7.0-alpha01
22 มีนาคม 2023
ปล่อย androidx.annotation:annotation-*:1.7.0-alpha01
แล้ว เวอร์ชัน 1.7.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- รวมอาร์ติแฟกต์ของ Kotlin หลายแพลตฟอร์มที่กำหนดเป้าหมายเป็นแพลตฟอร์ม 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 มีคอมมิตเหล่านี้
- คำอธิบายประกอบได้เปิดใช้ Kotlin หลายแพลตฟอร์มสำหรับเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ 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 ที่มีเครื่องหมาย "เปิด" อาจใส่คำอธิบายประกอบด้วยคำอธิบายประกอบนี้ได้ และ 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 ได้รับการปรับปรุงสำหรับการเปิดตัวแล้ว
เวอร์ชัน 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 ที่มีเครื่องหมาย "เปิด" สามารถใส่คำอธิบายประกอบด้วยคำอธิบายประกอบนี้ได้ และ 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
- ต้องมีคำอธิบายใน "ข้อความ" สำหรับ @Discourious (I3390F)
- เพิ่มคำอธิบายประกอบ @Discouraving สำหรับการทำเครื่องหมายองค์ประกอบที่ไม่แนะนำ (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.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
- แสดงคำเตือนการใช้ Java สำหรับพร็อพเพอร์ตี้ Kotlin ที่มีคำอธิบายประกอบในการทดสอบ (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)
- แสดงคำเตือนการใช้ Java สำหรับพร็อพเพอร์ตี้ Kotlin ที่มีคำอธิบายประกอบการทดลอง (I8bd43)
- แก้ไขตำแหน่งคำอธิบายประกอบการแก้ไขอัตโนมัติในเมธอด Kotlin (Id7a41)
เวอร์ชัน 1.4.0-dev01
8 กุมภาพันธ์ 2023
ปล่อย androidx.annotation:annotation-experimental:1.4.0-dev01
แล้ว เวอร์ชัน 1.4.0-dev01 มีคอมมิตเหล่านี้
- การทดสอบคำอธิบายประกอบได้เปิดใช้หลายแพลตฟอร์มของ Kotlin สำหรับเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ 1.4.0-dev01
เวอร์ชันทดลองของคำอธิบายประกอบ 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) - ย้ายทรัพยากร Dependency ของ Kotlin stdlib ไปยังประเภท API แทนคอมไพล์เท่านั้นแล้ว ซึ่งหมายความว่าไคลเอ็นต์ทั้งหมดของไลบรารีคำอธิบายประกอบแบบทดลองจะรวมไลบรารีมาตรฐานของ Kotlin ในทรัพยากร Dependency แบบทรานซิทีฟ
เวอร์ชัน 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 ได้รับการสรุปผลสำหรับรุ่นเบต้าแล้ว
เวอร์ชันทดลองของคำอธิบายประกอบเวอร์ชัน 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 และเป็นไปตามการตรวจสอบ Lint ของNewApi
ได้ - เพิ่มคำอธิบายประกอบ
@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 เพื่อให้มั่นใจว่าการเพิ่มประสิทธิภาพโค้ดจะไม่เตือนเมื่อขาดคำอธิบายประกอบเมตาของ 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
- เวอร์ชัน Androidx ของคำอธิบายประกอบทดลองเป็น เลิกใช้งานแล้วเพื่อให้ ความเท่าเทียมกับ Kotlin เนื่องจากมีการแทนที่ด้วยเวอร์ชัน androidx ของ ต้องใช้คำอธิบายประกอบ sOptIn และฟีเจอร์วิเคราะห์โค้ดที่ใช้ 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 เป็นทรัพยากร Dependency ซึ่งรวมถึงไฟล์ 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
โดยใช้ Lint ในซอร์สโค้ด Java - คำอธิบายประกอบ Java ที่มีลักษณะการทำงานเทียบเท่ากับคำอธิบายประกอบ
@Experimental
และ@UseExperimental
ของ Kotlin โดยไม่จำเป็นต้องพึ่งพา Kotlin
คำอธิบายประกอบเวอร์ชันทดลอง 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 เวอร์ชันเสถียร คำเตือนจากเครื่องมือตรวจสอบการใช้งาน Lint ของ @Experimental
จะไม่แสดงใน IDE สำหรับการใช้ Java ที่ไม่ถูกต้องของคำอธิบายประกอบ Kotlin @Experimental
โปรดดู b/140640322
เวอร์ชันทดลองของคำอธิบายประกอบ 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 มีการคอมมิตเหล่านี้
เวอร์ชันทดลองของคำอธิบายประกอบเวอร์ชัน 1.0.0-alpha01
18 กันยายน 2019
ปล่อย androidx.annotation:annotation-experimental:1.0.0-alpha01
และ androidx.annotation:annotation-experimental-lint:1.0.0-alpha01
แล้ว นี่คือ คอมมิตที่รวมอยู่ในการทดสอบ 1.0.0-alpha01
และเป็นการ จำนวนการคอมมิตที่รวมอยู่ในanalytics-experimental-lint 1.0.0-alpha01
ฟีเจอร์ใหม่
ไลบรารีคำอธิบายประกอบเวอร์ชันทดลองของ Jetpack มีการใช้งานตัวทำเครื่องหมาย API เวอร์ชันทดลองของ Kotlin ที่ใช้ร่วมกับ Java ได้ อาร์ติแฟกต์
-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 คำอธิบายประกอบนี้สามารถใช้กับ Getters บนการดูหรือองค์ประกอบ 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 ที่ฝังอยู่ในโหล รายการเหล่านี้อ้างอิงประเภท
android.support.annotation
แบบเก่าแทนandroidx.annotation
อย่างไม่ถูกต้อง หมายเหตุ: สิ่งนี้จะส่งผลต่อบิลด์ของคุณก็ต่อเมื่อคุณไม่ได้ใช้getDefaultProguardFile
เนื่องจากกฎเริ่มต้นเหล่านั้นมีกฎที่ถูกต้องสำหรับทั้งสองแพ็กเกจด้วย (aosp/891685) - เพิ่มกฎ R8/ProGuard ซึ่งมีคำอธิบายประกอบ @Keep นั้นอย่างชัดเจน วิธีนี้ช่วยให้ ProGuard ไม่นำคำอธิบายประกอบออกจากประเภทต่างๆ ก่อนที่จะยึดตามความหมายจริง หมายเหตุ: สิ่งนี้จะส่งผลต่อบิลด์ของคุณก็ต่อเมื่อคุณไม่ได้ใช้
getDefaultProguardFile
เนื่องจากกฎเริ่มต้นเหล่านั้นมีกฎที่ถูกต้องสำหรับทั้งสองแพ็กเกจด้วย (aosp/903818)