หมายเหตุ

ตารางนี้แสดงอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.annotation

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มการอ้างอิงใน Annotation คุณต้องเพิ่มที่เก็บ Google Maven ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google

เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูลของคุณ

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"
}

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 มีการเปลี่ยนแปลงเหล่านี้

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

• เพิ่มแพลตฟอร์มเป้าหมาย JS (I2310b)
• อัปเดต Kotlin เป็นเวอร์ชัน 1.9 (I1a14c)

เวอร์ชัน 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-เบต้า01

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 scope เมื่อแทรกการอ้างอิงแพลตฟอร์มเริ่มต้น (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 (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 (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.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 เพื่อให้ตรงกับคำอธิบายประกอบ stdlib ของ Kotlin ที่มีค่าสตริงว่างเริ่มต้น (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 และเป็นไปตามการตรวจสอบ 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 เพื่อให้แน่ใจว่าการเพิ่มประสิทธิภาพโค้ดจะไม่เตือนเกี่ยวกับ 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)