หมายเหตุ

  
แสดงข้อมูลเมตาที่ช่วยให้เครื่องมือและนักพัฒนาซอฟต์แวร์รายอื่นๆ เข้าใจโค้ดของแอป

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

อาร์ติแฟกต์ รุ่นที่เสถียร ตัวเลือกถอนการอ้างสิทธิ์ รุ่นเบต้า รุ่นอัลฟ่า
หมายเหตุ 1.8.1 - - 1.9.0-alpha01
การทดสอบคำอธิบายประกอบ 1.4.1 - - -
คลังนี้ได้รับการอัปเดตล่าสุดเมื่อวันที่ 24 กรกฎาคม 2024

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

หากต้องการเพิ่มทรัพยากร Dependency สำหรับคำอธิบายประกอบ คุณต้องเพิ่มที่เก็บ Google Maven ไปยัง อ่านที่เก็บ Maven ของ Google เพื่อดูข้อมูลเพิ่มเติม

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

ดึงดูด

dependencies {
    implementation "androidx.annotation:annotation:1.8.1"
    // 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.1")
    // 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.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 และเป็นการ จำนวนการคอมมิตที่รวมอยู่ในที่ไม่ระบุตัวตน-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)