Annotation
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 |
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.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") }
Để 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.
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 thá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 thá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 thá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 thá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 thá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
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 thá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 thá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
Phiên bản 1.4.0
Ngày 15 thá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 thá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 thá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 thá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
Phiên bản 1.3.0
Ngày 3 thá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
trongandroidx.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 thá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
trongandroidx.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àoRequiresOptIn
để 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 traRequiresOptIn
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 thá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 thá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 thá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 thá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
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 choNewApi
. - 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 thá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 thá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 thá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 traSDK_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íchExperimental
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 thá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
Annotation-Experimental Phiên bản 1.0.0
Ngày 7 thá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 thá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ềmannotation-experimental-lint
cung cấp sẽ tự động được thực thi.
Phiên bản 1.1.0
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ệnfoo.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ệncom.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ợ trongComponentActivity
ở phiên bản1.0.0-alpha04
vàFragment
trong bản phát hành1.1.0-alpha04
lần lượt để thay thế cho việc sử dụngsetContentView()
hoặc ghi đèonCreateView()
. (aosp/837619)
Phiên bản 1.0.2
Phiên bản 1.0.2
Ngày 25 thá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ụnggetDefaultProguardFile
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)