Annotation | Jetpack | Android Developers

Trang này được dịch bởi Cloud Translation API.

Annotation

Tài liệu tham khảo về API
androidx.annotation

Hiển thị siêu dữ liệu giúp công cụ và các nhà phát triển khác biết được mã của ứng dụng.

Bảng này liệt kê tất cả cấu phần phần mềm trong nhóm androidx.annotation.

Cấu phần phần mềm	Bản phát hành ổn định	Bản phát hành dùng thử	Bản phát hành beta	Bản phát hành alpha
chú thích	1.8.2	-	-	1.9.0-alpha03
annotation-experimental	1.4.1	-	-	1.5.0-alpha01

Lần gần nhất cập nhật thư viện này: ngày 4 tháng 9 năm 2024

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên Annotation, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

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.4.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.4.1")
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Phiên bản 1.9

Phiên bản 1.9.0-alpha03

Ngày 4 tháng 9 năm 2024

Phát hành androidx.annotation:annotation-*:1.9.0-alpha03. Phiên bản 1.9.0-alpha03 không có thay đổi kể từ bản alpha trước.

Phiên bản 1.9.0-alpha02

Ngày 21 tháng 8 năm 2024

Phát hành androidx.annotation:annotation-*:1.9.0-alpha02. Phiên bản 1.9.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

Thêm tính năng hỗ trợ cho nền tảng mingwX64 (I461ca, b/349894318)
Thêm tuỳ chọn hỗ trợ cho mục tiêu đa nền tảng linuxArm64 Kotlin. (I139d3, b/338268719)

Phiên bản 1.9.0-alpha01

Ngày 26 tháng 6 năm 2024

Phát hành androidx.annotation:annotation-*:1.9.0-alpha01. Phiên bản 1.9.0-alpha01 bao gồm các thay đổi sau.

Đóng góp bên ngoài

Thêm hỗ trợ cho mục tiêu đa nền tảng của linuxArm64 (nhờ Jake Wharton!)

Phiên bản 1.8

Phiên bản 1.8.2

Ngày 7 tháng 8 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.2. Phiên bản 1.8.2 bao gồm các thay đổi sau.

Sửa lỗi

Thêm tính năng hỗ trợ cho nền tảng mingwX64 (I461ca, b/349894318)

Phiên bản 1.8.1

Ngày 24 tháng 7 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.1. Phiên bản 1.8.1 bao gồm các thay đổi sau.

Sửa lỗi

Bao gồm các mục tiêu Đa nền tảng Kotlin khác: watchos, tvos.

Phiên bản 1.8.0

Ngày 14 tháng 5 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.0. Phiên bản 1.8.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.7.0

Thêm chú giải @ReplaceWith để thể hiện việc thay thế các API không dùng nữa
Chú giải @MainThread đã được di chuyển đến nhóm tài nguyên chung.

Phiên bản 1.8.0-rc01

Ngày 1 tháng 5 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.0-rc01. Phiên bản 1.8.0-rc01 không có thay đổi nào kể từ bản phát hành beta trước.

Phiên bản 1.8.0-beta02

Ngày 17 tháng 4 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.0-beta02. Phiên bản 1.8.0-beta02 không có thay đổi nào kể từ bản phát hành trước.

Phiên bản 1.8.0-beta01

Ngày 3 tháng 4 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.0-beta01. Phiên bản 1.8.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Chú thích ReplaceWith hiện là API ổn định, nhưng yêu cầu kiểm tra tìm lỗi mã nguồn có liên quan cùng với tính năng tự động sửa lỗi chưa được gửi

Phiên bản 1.8.0-alpha02

Ngày 20 tháng 3 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.0-alpha02 mà không có thay đổi đáng kể nào. Phiên bản 1.8.0-alpha02 bao gồm các thay đổi sau.

Phiên bản 1.8.0-alpha01

Ngày 21 tháng 2 năm 2024

Phát hành androidx.annotation:annotation-*:1.8.0-alpha01. Phiên bản 1.8.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

Thêm chú giải @ReplaceWith để thể hiện sự thay thế cho các API không dùng nữa. (I38db3, b/322373864)

Đóng góp bên ngoài

Cảm ơn Ivan Matkov đã di chuyển chú thích @MainThread sang nhóm tài nguyên chung. (6f228c)

Phiên bản 1.7

Phiên bản 1.7.1

Ngày 13 tháng 12 năm 2023

Phát hành androidx.annotation:annotation-*:1.7.1. Phiên bản 1.7.1 bao gồm các thay đổi sau.

Sửa lỗi

Sử dụng phạm vi compile khi chèn phần phụ thuộc nền tảng mặc định. (I4958f)

Phiên bản 1.7.0

Ngày 6 tháng 9 năm 2023

Phát hành androidx.annotation:annotation-*:1.7.0. Phiên bản 1.7.0 chứa những thay đổi đã được xác nhận này.

Thay đổi quan trọng kể từ phiên bản 1.6.0

Bao gồm các cấu phần phần mềm Kotlin Multiplatform nhắm đến các nền tảng iOS, Linux và MacOS.
Giờ đây, bạn có thể sử dụng Chú thích trong các dự án KMM. Lưu ý rằng các mục tiêu Chú thích không dành cho Android vẫn đang trong giai đoạn thử nghiệm nhưng chúng tôi đã quyết định hợp nhất các phiên bản để nhà phát triển dễ dàng dùng thử hơn. Cụ thể, một số chú giải có thể di chuyển giữa mã chung và mã dành riêng cho nền tảng trong quá trình phát triển alpha khi chúng ta hoàn tất các ranh giới.

Phiên bản 1.7.0-rc01

Ngày 23 tháng 8 năm 2023

Phát hành androidx.annotation:annotation-*:1.7.0-rc01. Phiên bản 1.7.0-rc01 bao gồm các thay đổi sau.

Bản phát hành này không chứa bất kỳ thay đổi nào so với bản beta trước đó.

Phiên bản 1.7.0-beta01

Ngày 9 tháng 8 năm 2023

Phát hành androidx.annotation:annotation-*:1.7.0-beta01. Phiên bản 1.7.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

Các API ổn định để phát hành

Phiên bản 1.7.0-alpha03

Ngày 26 tháng 7 năm 2023

Phát hành androidx.annotation:annotation-*:1.7.0-alpha03. Phiên bản 1.7.0-alpha03 bao gồm các thay đổi sau.

Sửa lỗi

Ấn bản POM Maven hiện bao gồm cấu phần phần mềm đa nền tảng nhắm mục tiêu theo JVM mặc định dưới dạng phần phụ thuộc

Phiên bản 1.7.0-alpha02

Ngày 24 tháng 3 năm 2023

Phát hành androidx.annotation:annotation-*:1.7.0-alpha02.

Sửa lỗi

Xoá các điều kiện ràng buộc phần phụ thuộc khỏi các cấu phần phần mềm Maven để giải quyết vấn đề về bản dựng trong Kotlin Native Targets (b/274786186, KT-57531).

Phiên bản 1.7.0-alpha01

Ngày 22 tháng 3 năm 2023

Phát hành androidx.annotation:annotation-*:1.7.0-alpha01. Phiên bản 1.7.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Bao gồm các cấu phần phần mềm Kotlin Multiplatform nhắm đến các nền tảng iOS, Linux và MacOS.
Giờ đây, bạn có thể sử dụng Chú thích trong các dự án KMM. Lưu ý rằng các mục tiêu Chú thích không dành cho Android vẫn đang trong giai đoạn thử nghiệm nhưng chúng tôi đã quyết định hợp nhất các phiên bản để giúp nhà phát triển dùng thử dễ dàng hơn. Cụ thể, một số chú giải có thể di chuyển giữa mã chung và mã dành riêng cho nền tảng trong quá trình phát triển alpha khi chúng ta hoàn tất các ranh giới.

Phiên bản 1.6

Phiên bản 1.6.0

Ngày 22 tháng 2 năm 2023

Phát hành androidx.annotation:annotation:1.6.0 và androidx.annotation:annotation-jvm:1.6.0. Phiên bản 1.6.0 bao gồm các thay đổi sau.

Các thay đổi quan trọng kể từ phiên bản 1.5.0

Thêm chú thích @RequiresExtension để thể hiện rằng API yêu cầu một phiên bản cụ thể của SDK tiện ích cụ thể (I5e4fe)
Chuyển đổi thư viện chú thích để tạo bằng chuỗi công cụ Đa nền tảng Kotlin (I3be8d)

Phiên bản 1.6.0-rc01

Ngày 8 tháng 2 năm 2023

Phát hành androidx.annotation:annotation:1.6.0-rc01 và androidx.annotation:annotation-jvm:1.6.0-rc01. Phiên bản 1.6.0-rc01 bao gồm các thay đổi sau.

Annotation đã được ổn định cho bản phát hành dùng thử 1.6.0-rc01.

Phiên bản 1.6.0-beta01

Ngày 25 tháng 1 năm 2023

androidx.annotation:annotation:1.6.0-beta01 và androidx.annotation:annotation-jvm:1.6.0-beta01 được phát hành mà không có sự thay đổi nào so với phiên bản 1.6.0-alpha01.

Phiên bản 1.6.0-alpha01

Ngày 11 tháng 1 năm 2023

Phát hành androidx.annotation:annotation-*:1.6.0-alpha01. Phiên bản 1.6.0-alpha01 bao gồm các thay đổi sau.

Phiên bản 1.6.0-dev01

Ngày 8 tháng 2 năm 2023

Phát hành androidx.annotation:annotation-*:1.6.0-dev01. Phiên bản 1.6.0-dev01 bao gồm các thay đổi sau.

Annotation đã bật chế độ đa nền tảng Kotlin cho bản dùng thử cho nhà phát triển 1.6.0-dev01.

Tính năng mới

Thêm chú giải @RequiresExtension để thể hiện rằng API yêu cầu một phiên bản cụ thể của SDK tiện ích cụ thể. (I5e4fe)
Chuyển đổi thư viện chú thích để tạo bằng chuỗi công cụ Đa nền tảng Kotlin (I3be8d)

Phiên bản 1.5.0

Ngày 21 tháng 9 năm 2022

Phát hành androidx.annotation:annotation:1.5.0. Phiên bản 1.5.0 bao gồm các thay đổi sau.

Các thay đổi quan trọng kể từ phiên bản 1.4.0

Thư viện Chú thích đã được di chuyển hoàn toàn sang các nguồn Kotlin, nhằm hỗ trợ các trang web sử dụng mục tiêu dành riêng cho Kotlin cũng như các tính năng chú thích khác tương thích với Kotlin.

Phiên bản 1.5.0-rc01

Ngày 7 tháng 9 năm 2022

Phát hành androidx.annotation:annotation:1.5.0-rc01. Phiên bản 1.5.0-rc01 bao gồm các thay đổi sau.

Không có thay đổi nào so với bản phát hành beta 1.5.0 trước đó.

Phiên bản 1.5.0-beta01

Ngày 24 tháng 8 năm 2022

Phát hành androidx.annotation:annotation:1.5.0-beta01. Phiên bản 1.5.0-beta01 bao gồm các thay đổi sau.

Bản phát hành này không có gì thay đổi so với bản phát hành trước. Phiên bản beta chưa sử dụng được nền tảng API.

Phiên bản 1.5.0-alpha02

Ngày 10 tháng 8 năm 2022

Phát hành androidx.annotation:annotation:1.5.0-alpha02. Phiên bản 1.5.0-alpha02 bao gồm các thay đổi sau.

Không có gì thay đổi so với bản phát hành alpha trước.

Phiên bản 1.5.0-alpha01

Ngày 27 tháng 7 năm 2022

Phát hành androidx.annotation:annotation:1.5.0-alpha01. Phiên bản 1.5.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Thư viện Chú thích đã được di chuyển hoàn toàn sang các nguồn Kotlin, nhằm hỗ trợ các trang web sử dụng mục tiêu dành riêng cho Kotlin cũng như các tính năng chú thích khác tương thích với Kotlin.

Phiên bản 1.4.0

Ngày 15 tháng 6 năm 2022

Phát hành androidx.annotation:annotation:1.4.0. Phiên bản 1.4.0 bao gồm các thay đổi sau.

Thay đổi quan trọng kể từ phiên bản 1.3.0

@RestrictTo đã được di chuyển sang các nguồn Kotlin và hiện hỗ trợ trang web sử dụng @file. Do đó, thư viện Chú thích hiện phụ thuộc vào thư viện chuẩn trong Kotlin.
@ReturnThis (b/140249763): Đảm bảo rằng các phương thức ghi đè của phương thức này phải trả về cùng một phiên bản (dành cho trình tạo, v.v.)
@OpenForTesting (b/141539024): Bạn có thể chú thích các lớp và phương thức Kotlin được đánh dấu là "mở" bằng chú thích này và công cụ tìm lỗi mã nguồn sẽ đảm bảo rằng lớp này chỉ được phân lớp con (và các phương thức chỉ bị ghi đè) từ các kiểm thử đơn vị
@DeprecatedSinceApi (b/37116481): Cho biết rằng phương thức (hoặc lớp hay trường) được chú thích là một phần của thư viện điều chỉnh cho phiên bản cũ cho API nền tảng và không còn cần đến cấp độ API nhất định nữa.
@EmptySuper: Cho biết phương thức này được xác định là trống. Vì vậy, bạn không cần phải gọi phương thức này khi ghi đè (thậm chí trên thực tế bạn không nên gọi phương thức này; chẳng hạn như phương thức có thể chứa tính năng kiểm tra khả năng tương thích ngược).

Phiên bản 1.4.0-rc01

Ngày 1 tháng 6 năm 2022

Phát hành androidx.annotation:annotation:1.4.0-rc01. Phiên bản 1.4.0-rc01 bao gồm các thay đổi sau.

Đã hoàn thiện về nền tảng và chức năng của API để có thể phát hành.

Phiên bản 1.4.0-beta01

Ngày 18 tháng 5 năm 2022

Phát hành androidx.annotation:annotation:1.4.0-beta01. Phiên bản 1.4.0-beta01 bao gồm các thay đổi sau.

Không có thay đổi nào kể từ bản phát hành alpha cuối cùng. Nền tảng API đã bị khoá đối với bản phát hành Beta.

Phiên bản 1.4.0-alpha02

Ngày 9 tháng 2 năm 2022

Phát hành androidx.annotation:annotation:1.4.0-alpha02. Phiên bản 1.4.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

Thêm các chú thích @ReturnThis, @OpenForTesting, @EmptySuper và @DeprecatedSinceApi. (21946a2)
@ReturnThis (b/140249763): Đảm bảo rằng các phương thức ghi đè của phương thức này phải trả về cùng một phiên bản (dành cho trình tạo, v.v.)
@OpenForTesting (b/141539024): Bạn có thể chú thích các lớp và phương thức Kotlin được đánh dấu là "mở" bằng chú thích này và công cụ tìm lỗi mã nguồn sẽ đảm bảo rằng lớp này chỉ được phân lớp con (và các phương thức chỉ bị ghi đè) từ các kiểm thử đơn vị
@DeprecatedSinceApi (b/37116481): Cho biết rằng phương thức (hoặc lớp hoặc trường) được chú thích là một phần của thư viện điều chỉnh cho phiên bản cũ cho API nền tảng và không còn cần đến cấp độ API nhất định nữa.
@EmptySuper: Cho biết phương thức này được xác định là trống. Vì vậy, bạn không cần phải gọi phương thức này khi ghi đè (thậm chí trên thực tế bạn không nên gọi phương thức này; chẳng hạn như phương thức có thể chứa tính năng kiểm tra khả năng tương thích ngược).

Phiên bản 1.4.0-alpha01

Ngày 15 tháng 12 năm 2021

Phát hành androidx.annotation:annotation:1.4.0-alpha01. Phiên bản 1.4.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

Di chuyển chú thích RestrictTo sang các nguồn Kotlin (Ia6336)

Phiên bản 1.3.0

Ngày 3 tháng 11 năm 2021

Phát hành androidx.annotation:annotation:1.3.0. Phiên bản 1.3.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.2.0

Chú thích @Discouraged để đánh dấu các API không còn được dùng nữa nhưng có tác động tiêu cực đáng kể đến hiệu suất và không nên được gọi trong mã sản phẩm thông thường
Chú thích @Context để đánh dấu các Ngữ cảnh chung để nhà phát triển có thể di chuyển sang các API mới dễ dàng hơn
Chú thích @GravityInt để đánh dấu các phần tử có chứa giá trị trọng lực được gói thành số nguyên
Ngừng sử dụng @InspectableProperty và thay bằng @Attribute trong androidx.resourceinspection

Phiên bản 1.3.0-rc01

Ngày 27 tháng 10 năm 2021

Phát hành androidx.annotation:annotation:1.3.0-rc01. Phiên bản 1.3.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.3.0-beta01

Ngày 29 tháng 9 năm 2021

Phát hành androidx.annotation:annotation:1.3.0-beta01. Phiên bản 1.3.0-beta01 bao gồm các thay đổi sau.

Thay đổi về API

Yêu cầu nội dung giải thích trong 'thông báo' cho @Discouraged. (I3390f)
Thêm chú thích @Discouraged để đánh dấu các phần tử không được khuyến khích. (Ib2549)
Hiển thị chú thích RestrictTo từ cửa sổ bật lên tài liệu về Studio (Ie8e1a, b/183134648)

Sửa lỗi

Thêm chú thích Ngữ cảnh để đánh dấu Ngữ cảnh chung, nhờ đó, nhà phát triển có thể di chuyển sang các API mới dễ dàng hơn. (Ie581a)

Phiên bản 1.3.0-alpha01

Ngày 24 tháng 3 năm 2021

Phát hành androidx.annotation:annotation:1.3.0-alpha01. Phiên bản 1.3.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

Ngừng sử dụng @InspectableProperty và thay bằng @Attribute trong androidx.resourceinspection. (Ic0eff)
Thêm chú thích @GravityInt để đánh dấu các phần tử có chứa giá trị trọng lực được gói thành số nguyên (Ifcaa4, b/180620048)

Annotation-Experimental Phiên bản 1.5

Phiên bản 1.5.0-alpha01

Ngày 21 tháng 8 năm 2024

Phát hành androidx.annotation:annotation-experimental:1.5.0-alpha01. Phiên bản 1.5.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

Thêm message vào RequiresOptIn để khớp với chú giải Kotlin stdlib có giá trị chuỗi trống mặc định. (I1f50e)

Annotation-Experimental Phiên bản 1.4

Phiên bản 1.4.1

Ngày 3 tháng 4 năm 2024

Phát hành androidx.annotation:annotation-experimental:1.4.1. Phiên bản 1.4.1 bao gồm các thay đổi sau.

Sửa lỗi

Hãy khắc phục việc sử dụng isKotlin để tránh vô tình kích hoạt quá trình kiểm tra RequiresOptIn trong các tệp Kotlin. (I2d8c1f)

Phiên bản 1.4.0

Ngày 24 tháng 1 năm 2024

Phát hành androidx.annotation:annotation-experimental:1.4.0. Phiên bản 1.4.0 bao gồm các thay đổi sau.

Thay đổi quan trọng kể từ phiên bản 1.3.0

Thêm tính năng hỗ trợ cho nhiều nền tảng Kotlin
Khắc phục khả năng tương thích với Kotlin 2.0
Hiện cảnh báo về việc sử dụng Java của các thuộc tính Kotlin được chú thích thử nghiệm (I8bd43)
Sửa vị trí của chú thích tự động sửa lỗi trên các phương thức Kotlin (Id7a41)

Phiên bản 1.4.0-rc01

Ngày 10 tháng 1 năm 2024

Phát hành androidx.annotation:annotation-experimental:1.4.0-rc01. Phiên bản 1.4.0-rc01 không có thay đổi nào kể từ bản phát hành trước.

Phiên bản 1.4.0-beta01

Ngày 13 tháng 12 năm 2023

Phát hành androidx.annotation:annotation-experimental:1.4.0-beta01. Không có thay đổi nào kể từ bản phát hành trước.

Phiên bản 1.4.0-alpha01

Ngày 29 tháng 11 năm 2023

Phát hành androidx.annotation:annotation-experimental:1.4.0-alpha01. Phiên bản 1.4.0-alpha01 bao gồm các thay đổi sau.

Sửa lỗi

Tạm thời xoá nội dung đề xuất tự động sửa lỗi ở cấp lớp để khắc phục vấn đề b/301598518. (Id98b2)
Hiện cảnh báo về việc sử dụng Java của các thuộc tính Kotlin được chú thích thử nghiệm (I8bd43)
Sửa vị trí của chú thích tự động sửa lỗi trên các phương thức Kotlin (Id7a41)

Phiên bản 1.4.0-dev01

Ngày 8 tháng 2 năm 2023

Phát hành androidx.annotation:annotation-experimental:1.4.0-dev01. Phiên bản 1.4.0-dev01 bao gồm các thay đổi sau.

Annotation-experimental đã bật chế độ đa nền tảng Kotlin trong bản dùng thử cho nhà phát triển 1.4.0-dev01.

Annotation-Experimental Phiên bản 1.3.1

Phiên bản 1.3.1

Ngày 21 tháng 6 năm 2023

Phát hành androidx.annotation:annotation-experimental:1.3.1. Phiên bản 1.3.1 bao gồm các thay đổi sau.

Sửa lỗi

Đặt chú thích ở đầu danh sách đối tượng sửa đổi khi áp dụng tính năng tự động sửa lỗi tìm lỗi mã nguồn. (b/251172715)
Sử dụng tính năng kiểm tra tìm lỗi mã nguồn để ngăn việc sử dụng androidx.annotation.RequiresOptIn trong các nguồn Kotlin (b/241097743)

Annotation-Experimental Phiên bản 1.3.0

Phiên bản 1.3.0

Ngày 7 tháng 9 năm 2022

Phát hành androidx.annotation:annotation-experimental:1.3.0. Phiên bản 1.3.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.2.0

Thêm hỗ trợ cho việc sử dụng @androidx.annotation.OptIn ở cấp gói (I24d58)
Đã chuyển phần phụ thuộc Kotlin stdlib sang loại API, thay vì chỉ biên dịch. Tức là tất cả ứng dụng của thư viện Annotation-Experimental sẽ bao gồm thư viện tiêu chuẩn Kotlin trong phần phụ thuộc chuyển đổi của chúng.

Phiên bản 1.3.0-rc01

Ngày 24 tháng 8 năm 2022

Phát hành androidx.annotation:annotation-experimental:1.3.0-rc01. Phiên bản 1.3.0-rc01 có những thay đổi sau.

Bản phát hành này không có gì khác so với bản phát hành trước. Chưa triển khai được RC.

Phiên bản 1.3.0-beta01

Ngày 10 tháng 8 năm 2022

Phát hành androidx.annotation:annotation-experimental:1.3.0-beta01. Phiên bản 1.3.0-beta01 bao gồm các thay đổi sau.

Không có thay đổi nào so với phiên bản alpha. Thư viện này đã ổn định để có thể phát hành bản beta.

Phiên bản 1.3.0-alpha01

Ngày 27 tháng 7 năm 2022

Phát hành androidx.annotation:annotation-experimental:1.3.0-alpha01. Phiên bản 1.3.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

Thêm hỗ trợ cho việc sử dụng @androidx.annotation.OptIn ở cấp gói (I24d58)

Annotation-Experimental Phiên bản 1.2.0

Phiên bản 1.2.0

Ngày 15 tháng 12 năm 2021

Phát hành androidx.annotation:annotation-experimental:1.2.0. Phiên bản 1.2.0 bao gồm các thay đổi sau.

Những thay đổi quan trọng kể từ phiên bản 1.1.0

Thư viện này hiện hướng đến cấp độ ngôn ngữ Java 8.

Phiên bản 1.2.0-rc01

Ngày 1 tháng 12 năm 2021

Phát hành androidx.annotation:annotation-experimental:1.2.0-rc01. Phiên bản 1.2.0-rc01 bao gồm các thay đổi sau.

Không có thay đổi nào so với bản thử nghiệm.

Phiên bản 1.2.0-beta01

Ngày 17 tháng Mười một, 2021

androidx.annotation:annotation-experimental:1.2.0-beta01 đã phát hành. Phiên bản 1.2.0-beta01 bao gồm các thay đổi sau.

Các thay đổi về API

Các API đã được hoàn tất cho phiên bản thử nghiệm.

Annotation-Experimental Phiên bản 1.2.0-alpha01

Ngày 30 tháng 6 năm 2021

Phát hành androidx.annotation:annotation-experimental:1.2.0-alpha01. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Thư viện hiện hướng đến cấp độ ngôn ngữ Java 8

Phiên bản 1.2.0

Ngày 24 tháng 3 năm 2021

Phát hành androidx.annotation:annotation:1.2.0. Phiên bản 1.2.0 bao gồm các thay đổi sau.

Những thay đổi lớn kể từ phiên bản 1.1.0

Thêm chú thích @ChecksSdkIntAtLeast, có thể dùng để xác định các phương thức hoặc trường dùng để truy cập vào cổng ở cấp SDK và đáp ứng quy trình kiểm tra tìm lỗi mã nguồn cho NewApi.
Thêm chú thích @DoNotInline, được ghép nối với quy tắc Proguard để ngăn việc các thành viên được đưa vào cùng dòng trong quá trình tối ưu hoá.
Nhiều chú thích hiện được chú thích bằng @Documented để đảm bảo chúng nằm trong cùng tài liệu cho thành viên được chú thích.

Phiên bản 1.2.0-rc01

Ngày 24 tháng 2 năm 2021

Phát hành androidx.annotation:annotation:1.2.0-rc01. Phiên bản 1.2.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.2.0-beta01

Ngày 13 tháng 1 năm 2021

Phát hành androidx.annotation:annotation:1.2.0-beta01. Phiên bản 1.2.0-beta01 bao gồm các thay đổi sau.

Thay đổi về API

Chú thích @DoNotInline mới hướng dẫn các trình tối ưu hoá mã (ví dụ: Proguard, R8) để không nằm trong cùng phương thức được chú thích. (I3dfe8, b/141326133)

Phiên bản 1.2.0-alpha01

Ngày 14 tháng 5 năm 2020

Phát hành androidx.annotation:annotation:1.2.0-alpha01. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Thêm chú thích @ChecksSdkIntAtLeast. Thao tác này sẽ cho phép androidx và người dùng chú thích các phương thức và trường đại diện cho hoạt động kiểm tra SDK_INT. (I89a54, b/120255046)

Annotation-Experimental Phiên bản 1.1.0

Phiên bản 1.1.0

Ngày 7 tháng 4 năm 2021

Phát hành androidx.annotation:annotation-experimental:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau.

Những thay đổi lớn kể từ phiên bản 1.0.0

Các chú thích thử nghiệm của Jetpack đã được viết lại trong Kotlin để hỗ trợ nhiều lớp đánh dấu và cải thiện hoạt động xử lý các mã lệnh không dùng nữa.
Chúng tôi đã thêm chú thích RequiresOptIn và OptIn để giống với Kotlin, đồng thời các chú thích Experimental và UsesExperimental không còn được dùng nữa.

Phiên bản 1.1.0-rc02

Ngày 24 tháng 3 năm 2021

Phát hành androidx.annotation:annotation-experimental:1.1.0-rc02. Phiên bản 1.1.0-rc02 bao gồm các thay đổi sau.

Sửa lỗi

Thêm các quy tắc Proguard để đảm bảo rằng thao tác tối ưu hoá mã không cảnh báo về việc thiếu các chú thích meta Kotlin.

Phiên bản 1.1.0-rc01

Ngày 10 tháng 3 năm 2021

Phát hành androidx.annotation:annotation-experimental:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Không có thay đổi nào kể từ bản phát hành thử nghiệm trước đó.

Phiên bản 1.1.0-beta01

Ngày 27 tháng 1 năm 2021

Phát hành androidx.annotation:annotation-experimental:1.1.0-beta01. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Thay đổi về API

Biến thể androidx của chú thích Experimental không còn được dùng để cung cấp tính năng tương đương cho Kotlin. Chúng tôi đã thay thế nó bằng một biến thể androidx của chú thích RequiresOptIn và công cụ phân tích phát hiện lỗi sai cho Java đã được cập nhật để hỗ trợ cả chú thích Kotlin mới và biến thể androidx mới. (I52495, b/151331381)

Phiên bản 1.1.0-alpha01

Ngày 22 tháng 7 năm 2020

Phát hành androidx.annotation:annotation-experimental:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Giờ đây, thư viện chú thích thử nghiệm được viết bằng Kotlin, nhưng không yêu cầu thêm thư viện chuẩn Kotlin làm phần phụ thuộc. Phần này bao gồm một tệp Proguard cho phép loại bỏ siêu dữ liệu Kotlin không cần thiết khỏi các dự án chỉ sử dụng ngôn ngữ lập trình Java.
@UseExperimental hiện hỗ trợ nhiều lớp đánh dấu (aosp/1185577, b/145137892)

Annotation-Experimental Phiên bản 1.0.0

Ngày 7 tháng 11 năm 2019

Phát hành androidx.annotation:annotation-experimental:1.0.0 và androidx.annotation:annotation-experimental-lint:1.0.0 mà không có thay đổi nào kể từ 1.0.0-rc01. Phiên bản 1.0.0 bao gồm các thay đổi sau.

Các tính năng chính của phiên bản 1.0.0

Thực thi dựa trên tìm lỗi mã nguồn của ngữ nghĩa Kotlin @Experimental trong mã nguồn Java
Các chú thích Java cung cấp hoạt động tương đương với các chú thích @Experimental và @UseExperimental của Kotlin mà không cần đến phần phụ thuộc trên Kotlin

Annotation-Experimental Phiên bản 1.0.0-rc01

Ngày 23 tháng 10 năm 2019

Phát hành androidx.annotation:annotation-experimental:1.0.0-rc01 và androidx.annotation:annotation-experimental-lint:1.0.0-rc01. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Lỗi đã biết

Khi sử dụng Studio 3.5 một cách ổn định, những cảnh báo từ trình phát hiện tìm lỗi mã nguồn sử dụng @Experimental sẽ không hiển thị trong IDE đối với các mục đích sử dụng Java không hợp lệ của chú thích @Experimental của Kotlin. Xem b/140640322.

Annotation-Experimental Phiên bản 1.0.0-beta01

Ngày 9 tháng 10 năm 2019

Phát hành androidx.annotation:annotation-experimental:1.0.0-beta01 và androidx.annotation:annotation-experimental-lint:1.0.0-beta01 mà không có thay đổi nào kể từ 1.0.0-alpha01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Annotation-Experimental Phiên bản 1.0.0-alpha01

Ngày 18 tháng 9 năm 2019

Phát hành androidx.annotation:annotation-experimental:1.0.0-alpha01 và androidx.annotation:annotation-experimental-lint:1.0.0-alpha01. Đây là các thay đổi có trong chú thích-thử nghiệm 1.0.0-alpha01 và đây là các thay đổi có trong annotation-experimental-lint 1.0.0-alpha01

Tính năng mới

Thư viện chú thích thử nghiệm Jetpack cung cấp hoạt động triển khai các điểm đánh dấu API thử nghiệm của Kotlin tương thích với Java. Cấu phần phần mềm -lint cung cấp hoạt động triển khai các giới hạn sử dụng thử nghiệm dựa trên tìm lỗi mã nguồn và thực thi các giới hạn sử dụng các điểm đánh dấu API thử nghiệm gốc của Kotlin của Java.
Khi sử dụng cấu phần phần mềm annotation-experimental làm phần phụ thuộc, các quy tắc tìm lỗi mã nguồn do cấu phần phần mềm annotation-experimental-lint cung cấp sẽ tự động được thực thi.

Phiên bản 1.1.0

Ngày 5 tháng 6 năm 2019

Phát hành androidx.annotation:annotation:1.1.0 mà không có thay đổi nào từ phiên bản 1.1.0-rc01.

Phiên bản 1.1.0-rc01

Ngày 7 tháng 5 năm 2019

Phát hành androidx.annotation:annotation:1.1.0-rc01 mà không có thay đổi nào kể so với 1.1.0-beta01. Bạn có thể xem các thay đổi trong phiên bản này tại đây.

Phiên bản 1.1.0-beta01

Ngày 3 tháng 4 năm 2019

Phát hành androidx.annotation:annotation:1.1.0-beta01. Bạn có thể xem các thay đổi trong phiên bản này tại đây.

Tính năng mới

Chú thích @InspectableProperty mới để hỗ trợ các API kiểm tra chế độ xem mới được thêm vào Android 10. Bạn có thể áp dụng chú thích này cho phương thức getter trên các chế độ xem hoặc các thành phần khác trên giao diện người dùng. Các công cụ tạo mã có thể sử dụng chú thích này để tạo các đối tượng đồng hành liên kết tên thuộc tính và mã nhận dạng thuộc tính với các giá trị thuộc tính mà không cần đến mức hao tổn phản ánh.

Thay đổi về API

Thay đổi có thể gây lỗi: @ContentView đã được thay đổi thành chú thích hàm khởi tạo và giá trị @LayoutRes đã bị xoá. Các lớp muốn hỗ trợ các chú thích @ContentView phải thêm chú thích này vào hàm khởi tạo có thông số @LayoutRes int. Cách này sẽ khắc phục được vấn đề khi sử dụng chú thích này trong các mô-đun thư viện. (b/128352521)

Phiên bản 1.1.0-alpha02

Ngày 13 tháng 3 năm 2019

Phát hành androidx.annotation:annotation:1.1.0-alpha02. Bạn có thể xem danh sách đầy đủ các thay đổi trong phiên bản này tại đây.

Tính năng mới

Phạm vi hạn chế API mới: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Phạm vi mới này hạn chế việc sử dụng để mã hoá trong các gói chứa các nhóm có cùng một tiền tố nhóm thư viện cho đến . cuối cùng (dấu chấm). Ví dụ: vì các thư viện foo.bar:lib1 và foo.baz:lib2 dùng chung tiền tố foo, nên những thư viện này có thể sử dụng các API của nhau bị giới hạn trong phạm vi này. Tương tự, com.foo.bar:lib1 và com.foo.baz:lib2 dùng chung tiền tố com.foo. có thể chia sẻ các API bị giới hạn trong phạm vi đó. Tuy nhiên, thư viện com.bar.qux:lib3 sẽ không thể sử dụng API bị giới hạn vì thư viện này chỉ dùng chung tiền tố com. mà không dùng cho đến . (dấu chấm) cuối cùng.

Phiên bản 1.1.0-alpha01

Ngày 30 tháng 1 năm 2019

Phát hành androidx.annotation:annotation 1.1.0-alpha01.

Tính năng mới

Thêm chú thích @ContentView cho phép bạn chỉ định tệp XML bố cục nào sẽ được tăng cường. Việc này được hỗ trợ trong ComponentActivity ở phiên bản 1.0.0-alpha04 và Fragment trong bản phát hành 1.1.0-alpha04 lần lượt để thay thế cho việc sử dụng setContentView() hoặc ghi đè onCreateView(). (aosp/837619)

Phiên bản 1.0.2

Ngày 25 tháng 2 năm 2019

Phát hành androidx.annotation:annotation 1.0.2.

Sửa lỗi

Chỉnh sửa các quy tắc R8/ProGuard đã được nhúng vào JAR. Các thuộc tính này đã tham chiếu sai các loại android.support.annotation cũ thay vì androidx.annotation. Lưu ý: Điều này sẽ chỉ ảnh hưởng đến các bản dựng của bạn nếu bạn đã không sử dụng getDefaultProguardFile vì các quy tắc mặc định đó cũng bao gồm quy tắc chính xác cho cả hai gói. (aosp/891685)
Thêm quy tắc R8/ProGuard để lưu giữ rõ ràng chú thích @Keep. Điều này đảm bảo rằng ProGuard không xoá chú thích khỏi các loại trước khi thực sự tôn trọng ngữ nghĩa. Lưu ý: Điều này sẽ chỉ ảnh hưởng đến các bản dựng của bạn nếu bạn đã không sử dụng getDefaultProguardFile vì các quy tắc mặc định đó cũng bao gồm quy tắc chính xác cho cả hai gói. (aosp/903818)