Annotation

  
Mengekspos metadata yang memudahkan alat dan developer lain memahami kode aplikasi Anda.

Tabel ini mencantumkan semua artefak dalam grup androidx.annotation.

Artefak Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
annotation 1.8.2 - - 1.9.0-alpha03
annotation-experimental 1.4.1 - - 1.5.0-alpha01
Library ini terakhir diperbarui pada: 4 September 2024

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada Annotation, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

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

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.9

Versi 1.9.0-alpha03

4 September 2024

androidx.annotation:annotation-*:1.9.0-alpha03 dirilis. Versi 1.9.0-alpha03 tidak berisi perubahan sejak versi alfa sebelumnya.

Versi 1.9.0-alpha02

21 Agustus 2024

androidx.annotation:annotation-*:1.9.0-alpha02 dirilis. Versi 1.9.0-alpha02 berisi commit ini.

Fitur Baru

Versi 1.9.0-alpha01

26 Juni 2024

androidx.annotation:annotation-*:1.9.0-alpha01 dirilis. Versi 1.9.0-alpha01 berisi commit ini.

Kontribusi Eksternal

  • Menambahkan dukungan untuk target multiplatform linuxArm64 (berkat Jake Wharton)

Versi 1.8

Versi 1.8.2

7 Agustus 2024

androidx.annotation:annotation-*:1.8.2 dirilis. Versi 1.8.2 berisi commit ini.

Perbaikan Bug

Versi 1.8.1

24 Juli 2024

androidx.annotation:annotation-*:1.8.1 dirilis. Versi 1.8.1 berisi commit ini.

Perbaikan Bug

  • Mencakup target Multiplatform Kotlin tambahan: watchos, tvos.

Versi 1.8.0

14 Mei 2024

androidx.annotation:annotation-*:1.8.0 dirilis. Versi 1.8.0 berisi commit ini.

Perubahan penting sejak versi 1.7.0

  • Menambahkan anotasi @ReplaceWith guna mengekspresikan penggantian untuk API yang tidak digunakan lagi
  • Anotasi @MainThread telah dipindahkan ke set sumber umum.

Versi 1.8.0-rc01

1 Mei 2024

androidx.annotation:annotation-*:1.8.0-rc01 dirilis. Versi 1.8.0-rc01 tidak ada perubahan sejak rilis beta sebelumnya.

Versi 1.8.0-beta02

17 April 2024

androidx.annotation:annotation-*:1.8.0-beta02 dirilis. Versi 1.8.0-beta02 tidak berisi perubahan sejak rilis sebelumnya.

Versi 1.8.0-beta01

3 April 2024

androidx.annotation:annotation-*:1.8.0-beta01 dirilis. Versi 1.8.0-beta01 berisi commit ini.

Fitur Baru

  • Anotasi ReplaceWith kini stabil API, tetapi pemeriksaan lint terkait dengan perbaikan otomatis belum dikirim

Versi 1.8.0-alpha02

20 Maret 2024

androidx.annotation:annotation-*:1.8.0-alpha02 dirilis tanpa perubahan penting. Versi 1.8.0-alpha02 berisi commit ini.

Versi 1.8.0-alpha01

21 Februari 2024

androidx.annotation:annotation-*:1.8.0-alpha01 dirilis. Versi 1.8.0-alpha01 berisi commit ini.

Perubahan API

  • Menambahkan anotasi @ReplaceWith guna mengekspresikan penggantian untuk API yang tidak digunakan lagi. (I38db3, b/322373864)

Kontribusi Eksternal

  • Terima kasih Ivan Matkov telah memindahkan anotasi @MainThread ke set sumber umum. (6f228c)

Versi 1.7

Versi 1.7.1

13 Desember 2023

androidx.annotation:annotation-*:1.7.1 dirilis. Versi 1.7.1 berisi commit ini.

Perbaikan Bug

  • Gunakan cakupan compile saat menyisipkan dependensi platform default. (I4958f)

Versi 1.7.0

6 September 2023

androidx.annotation:annotation-*:1.7.0 dirilis. Versi 1.7.0 berisi commit ini.

Perubahan penting sejak versi 1.6.0

  • Mencakup artefak Multiplatform Kotlin yang menargetkan platform iOS, Linux, dan MacOS.
  • Sekarang Anda dapat menggunakan Anotasi di project KMM. Perhatikan bahwa anotasi target non-Android masih bersifat eksperimental, tetapi kami memutuskan untuk menggabungkan versi agar lebih mudah bagi developer untuk mencobanya. Secara khusus, beberapa anotasi mungkin berpindah antara kode umum dan kode khusus platform selama pengembangan alfa saat kami menyelesaikan batas.

Versi 1.7.0-rc01

23 Agustus 2023

androidx.annotation:annotation-*:1.7.0-rc01 dirilis. Versi 1.7.0-rc01 berisi commit ini.

Rilis ini tidak berisi perubahan apa pun dari versi beta sebelumnya.

Versi 1.7.0-beta01

9 Agustus 2023

androidx.annotation:annotation-*:1.7.0-beta01 dirilis. Versi 1.7.0-beta01 berisi commit ini.

Fitur Baru

  • API stabil untuk rilis

Versi 1.7.0-alpha03

26 Juli 2023

androidx.annotation:annotation-*:1.7.0-alpha03 dirilis. Versi 1.7.0-alpha03 berisi commit ini.

Perbaikan Bug

  • Publikasi POM Maven kini menyertakan artefak multiplatform yang ditargetkan JVM default sebagai dependensi

Versi 1.7.0-alpha02

24 Maret 2023

androidx.annotation:annotation-*:1.7.0-alpha02 dirilis.

Perbaikan Bug

  • Menghapus batasan dependensi dari artefak Maven untuk mengatasi masalah build di Target Native Kotlin (b/274786186, KT-57531).

Versi 1.7.0-alpha01

22 Maret 2023

androidx.annotation:annotation-*:1.7.0-alpha01 dirilis. Versi 1.7.0-alpha01 berisi commit ini.

Fitur Baru

  • Mencakup artefak Multiplatform Kotlin yang menargetkan platform iOS, Linux, dan MacOS.
  • Sekarang Anda dapat menggunakan Anotasi di project KMM. Perhatikan bahwa anotasi target non-Android masih bersifat eksperimental, tetapi kami memutuskan untuk menggabungkan versi agar lebih mudah bagi developer untuk mencobanya. Secara khusus, beberapa anotasi mungkin berpindah antara kode umum dan kode khusus platform selama pengembangan alfa saat kami menyelesaikan batasan.

Versi 1.6

Versi 1.6.0

22 Februari 2023

androidx.annotation:annotation:1.6.0 dan androidx.annotation:annotation-jvm:1.6.0 dirilis. Versi 1.6.0 berisi commit ini.

Perubahan penting sejak versi 1.5.0

  • Menambahkan anotasi @RequiresExtension untuk menyatakan bahwa API memerlukan versi tertentu dari SDK ekstensi tertentu (I5e4fe)
  • Mengonversi library anotasi untuk di-build menggunakan toolchain Multiplatform Kotlin (I3be8d)

Versi 1.6.0-rc01

8 Februari 2023

androidx.annotation:annotation:1.6.0-rc01 dan androidx.annotation:annotation-jvm:1.6.0-rc01 dirilis. Versi 1.6.0-rc01 berisi commit ini.

  • Anotasi telah distabilkan untuk kandidat rilis 1.6.0-rc01.

Versi 1.6.0-beta01

25 Januari 2023

androidx.annotation:annotation:1.6.0-beta01 dan androidx.annotation:annotation-jvm:1.6.0-beta01 dirilis tanpa perubahan dari versi 1.6.0-alpha01.

Versi 1.6.0-alpha01

11 Januari 2023

androidx.annotation:annotation-*:1.6.0-alpha01 dirilis. Versi 1.6.0-alpha01 berisi commit ini.

Versi 1.6.0-dev01

8 Februari 2023

androidx.annotation:annotation-*:1.6.0-dev01 dirilis. Versi 1.6.0-dev01 berisi commit ini.

  • Annotation telah mengaktifkan multi-platform Kotlin untuk pratinjau developer 1.6.0-dev01.

Fitur Baru

  • Menambahkan anotasi @RequiresExtension untuk menyatakan bahwa API memerlukan versi tertentu dari SDK ekstensi tertentu. (I5e4fe)
  • Mengonversi library anotasi untuk di-build menggunakan toolchain Multiplatform Kotlin (I3be8d)

Versi 1.5.0

Versi 1.5.0

21 September 2022

androidx.annotation:annotation:1.5.0 dirilis. Versi 1.5.0 berisi commit ini.

Perubahan penting sejak versi 1.4.0

  • Library anotasi telah dimigrasikan sepenuhnya ke sumber Kotlin, sehingga menghasilkan dukungan untuk situs penggunaan target khusus Kotlin dan fitur anotasi yang kompatibel dengan Kotlin.

Versi 1.5.0-rc01

7 September 2022

androidx.annotation:annotation:1.5.0-rc01 dirilis. Versi 1.5.0-rc01 berisi commit ini.

  • Tidak ada perubahan dari rilis beta 1.5.0 sebelumnya.

Versi 1.5.0-beta01

24 Agustus 2022

androidx.annotation:annotation:1.5.0-beta01 dirilis. Versi 1.5.0-beta01 berisi commit ini.

  • Tidak ada perubahan dari rilis sebelumnya. Platform API telah dibekukan untuk versi beta.

Versi 1.5.0-alpha02

10 Agustus 2022

androidx.annotation:annotation:1.5.0-alpha02 dirilis. Versi 1.5.0-alpha02 berisi commit ini.

  • Tidak ada perubahan sejak rilis alfa sebelumnya.

Versi 1.5.0-alpha01

27 Juli 2022

androidx.annotation:annotation:1.5.0-alpha01 dirilis. Versi 1.5.0-alpha01 berisi commit ini.

Fitur Baru

  • Library anotasi telah dimigrasikan sepenuhnya ke sumber Kotlin, sehingga menghasilkan dukungan untuk situs penggunaan target khusus Kotlin dan fitur anotasi yang kompatibel dengan Kotlin.

Versi 1.4.0

Versi 1.4.0

15 Juni 2022

androidx.annotation:annotation:1.4.0 dirilis. Versi 1.4.0 berisi commit ini.

Perubahan penting sejak versi 1.3.0

  • @RestrictTo telah dimigrasikan ke sumber Kotlin dan kini mendukung situs penggunaan @file. Akibatnya, library Annotation sekarang bergantung pada library standar Kotlin.
  • @ReturnThis (b/140249763): Memastikan bahwa metode pengganti metode ini harus menampilkan instance yang sama (ditujukan untuk builder dll.)
  • @OpenForTesting (b/141539024): Class dan metode Kotlin yang ditandai "open" dapat dianotasi dengan anotasi ini, dan lint akan memastikan bahwa class ini hanya dibuat subclass-nya (dan metode hanya diganti) dari pengujian unit
  • @DeprecatedSinceApi (b/37116481): Menunjukkan bahwa metode (atau class atau kolom) yang dianotasi adalah bagian dari library backport untuk API platform, yang tidak lagi diperlukan pada API level tertentu.
  • @EmptySuper: Menunjukkan bahwa metode ini didefinisikan kosong sehingga saat mengganti, Anda tidak perlu memanggilnya (dan sebenarnya tidak boleh; misalnya, dapat berisi pemeriksaan kompatibilitas mundur).

Versi 1.4.0-rc01

1 Juni 2022

androidx.annotation:annotation:1.4.0-rc01 dirilis. Versi 1.4.0-rc01 berisi commit ini.

  • Platform dan fungsi API telah diselesaikan untuk rilis ini.

Versi 1.4.0-beta01

18 Mei 2022

androidx.annotation:annotation:1.4.0-beta01 dirilis. Versi 1.4.0-beta01 berisi commit ini.

  • Tidak ada perubahan sejak versi alfa terakhir. Platform API telah dikunci untuk rilis Beta.

Versi 1.4.0-alpha02

9 Februari 2022

androidx.annotation:annotation:1.4.0-alpha02 dirilis. Versi 1.4.0-alpha02 berisi commit ini.

Fitur Baru

  • Menambahkan anotasi @ReturnThis, @OpenForTesting, @EmptySuper, dan @DeprecatedSinceApi. (21946a2)

  • @ReturnThis (b/140249763): Memastikan bahwa metode pengganti metode ini harus menampilkan instance yang sama (ditujukan untuk builder dll.)

  • @OpenForTesting (b/141539024): Class dan metode Kotlin yang ditandai "open" dapat dianotasi dengan anotasi ini, dan lint akan memastikan bahwa class ini hanya dibuat subclass-nya (dan metode hanya diganti) dari pengujian unit

  • @DeprecatedSinceApi (b/37116481): Menunjukkan bahwa metode yang dianotasi (atau class atau kolom) adalah bagian dari library backport untuk API platform, yang tidak lagi diperlukan pada API level tertentu.

  • @EmptySuper: Menunjukkan bahwa metode ini didefinisikan kosong sehingga saat mengganti, Anda tidak perlu memanggilnya (dan sebenarnya tidak boleh; misalnya, dapat berisi pemeriksaan kompatibilitas mundur).

Versi 1.4.0-alpha01

15 Desember 2021

androidx.annotation:annotation:1.4.0-alpha01 dirilis. Versi 1.4.0-alpha01 berisi commit ini.

Perubahan API

  • Memigrasikan anotasi RestrictTo ke sumber Kotlin (Ia6336)

Versi 1.3.0

Versi 1.3.0

3 November 2021

androidx.annotation:annotation:1.3.0 dirilis. Versi 1.3.0 berisi commit berikut ini.

Perubahan penting sejak versi 1.2.0

  • Anotasi @Discouraged untuk menandai API yang tidak dapat digunakan lagi secara wajar tetapi memiliki dampak performa negatif yang signifikan dan tidak boleh dipanggil dalam kode produksi normal
  • Anotasi @Context untuk menandai Konteks generik sehingga developer dapat melakukan migrasi ke API baru dengan lebih mudah
  • Anotasi @GravityInt untuk menandai elemen berisi nilai gravitasi yang disertakan ke dalam bilangan bulat
  • @InspectableProperty tidak digunakan lagi dan diganti dengan @Attribute untuk androidx.resourceinspection

Versi 1.3.0-rc01

27 Oktober 2021

androidx.annotation:annotation:1.3.0-rc01 dirilis. Versi 1.3.0-rc01 berisi commit ini.

Versi 1.3.0-beta01

29 September 2021

androidx.annotation:annotation:1.3.0-beta01 dirilis. Versi 1.3.0-beta01 berisi commit ini.

Perubahan API

  • Mewajibkan penjelasan di 'message' untuk @Discouraged. (I3390f)
  • Menambahkan anotasi @Discouraged untuk menandai elemen yang tidak disarankan. (Ib2549)
  • Membuat anotasi RestrictTo terlihat dari pop-up dokumen Studio (Ie8e1a, b/183134648)

Perbaikan Bug

  • Menambahkan anotasi Context untuk menandai Context generik, sehingga developer dapat bermigrasi ke API baru dengan lebih mudah. (Ie581a)

Versi 1.3.0-alpha01

24 Maret 2021

androidx.annotation:annotation:1.3.0-alpha01 dirilis. Versi 1.3.0-alpha01 berisi commit ini.

Perubahan API

  • @InspectableProperty tidak digunakan lagi dan digantikan dengan @Attribute di androidx.resourceinspection. (Ic0eff)
  • Menambahkan anotasi @GravityInt untuk menandai elemen berisi nilai gravitasi yang disertakan ke dalam bilangan bulat. (Ifcaa4, b/180620048)

Annotation-Experimental Versi 1.5

Versi 1.5.0-alpha01

21 Agustus 2024

androidx.annotation:annotation-experimental:1.5.0-alpha01 dirilis. Versi 1.5.0-alpha01 berisi commit ini.

Perubahan API

  • Tambahkan message ke RequiresOptIn untuk mencocokkan anotasi stdlib Kotlin dengan nilai string kosong default. (I1f50e)

Annotation-Experimental Versi 1.4

Versi 1.4.1

3 April 2024

androidx.annotation:annotation-experimental:1.4.1 dirilis. Versi 1.4.1 berisi commit ini.

Perbaikan Bug

  • Memperbaiki penggunaan isKotlin agar tidak memicu pemeriksaan RequiresOptIn secara tidak sengaja di file Kotlin. (I2d8c1f)

Versi 1.4.0

24 Januari 2024

androidx.annotation:annotation-experimental:1.4.0 dirilis. Versi 1.4.0 berisi commit ini.

Perubahan penting sejak versi 1.3.0

  • Menambahkan dukungan untuk multi-platform Kotlin
  • Memperbaiki kompatibilitas dengan Kotlin 2.0
  • Menampilkan peringatan untuk penggunaan Java dari properti Kotlin yang diberi anotasi secara eksperimental (I8bd43)
  • Memperbaiki penempatan anotasi perbaikan otomatis pada metode Kotlin (Id7a41)

Versi 1.4.0-rc01

10 Januari 2024

androidx.annotation:annotation-experimental:1.4.0-rc01 dirilis. Versi 1.4.0-rc01 tidak berisi perubahan sejak rilis sebelumnya.

Versi 1.4.0-beta01

13 Desember 2023

androidx.annotation:annotation-experimental:1.4.0-beta01 dirilis. Tidak ada perubahan sejak rilis sebelumnya.

Versi 1.4.0-alpha01

29 November 2023

androidx.annotation:annotation-experimental:1.4.0-alpha01 dirilis. Versi 1.4.0-alpha01 berisi commit ini.

Perbaikan Bug

  • Hapus saran perbaikan otomatis tingkat kelas untuk sementara guna mengatasi b/301598518. (Id98b2)
  • Menampilkan peringatan untuk penggunaan Java dari properti Kotlin yang diberi anotasi secara eksperimental (I8bd43)
  • Memperbaiki penempatan anotasi perbaikan otomatis pada metode Kotlin (Id7a41)

Versi 1.4.0-dev01

8 Februari 2023

androidx.annotation:annotation-experimental:1.4.0-dev01 dirilis. Versi 1.4.0-dev01 berisi commit ini.

  • Annotation-experimental telah mengaktifkan multi-platform Kotlin untuk pratinjau developer 1.4.0-dev01.

Annotation-Experimental Versi 1.3.1

Versi 1.3.1

21 Juni 2023

androidx.annotation:annotation-experimental:1.3.1 dirilis. Versi 1.3.1 berisi commit ini.

Perbaikan Bug

  • Menempatkan anotasi di awal daftar pengubah saat menerapkan perbaikan otomatis lint. (b/251172715)
  • Menggunakan pemeriksaan lint untuk mencegah penggunaan androidx.annotation.RequiresOptIn di sumber Kotlin (b/241097743)

Annotation-Experimental Versi 1.3.0

Versi 1.3.0

7 September 2022

androidx.annotation:annotation-experimental:1.3.0 dirilis. Versi 1.3.0 berisi commit berikut ini.

Perubahan penting sejak versi 1.2.0

  • Menambahkan dukungan untuk penggunaan tingkat paket dari @androidx.annotation.OptIn (I24d58)
  • Memindahkan dependensi stdlib Kotlin ke jenis API, bukan khusus kompilasi. Ini berarti semua klien library Annotation-Experimental akan menyertakan library standar Kotlin dalam dependensi transitifnya.

Versi 1.3.0-rc01

24 Agustus 2022

androidx.annotation:annotation-experimental:1.3.0-rc01 dirilis. Versi 1.3.0-rc01 berisi commit ini.

  • Tidak ada perubahan dari rilis sebelumnya. Penerapan telah dibekukan untuk versi RC.

Versi 1.3.0-beta01

10 Agustus 2022

androidx.annotation:annotation-experimental:1.3.0-beta01 dirilis. Versi 1.3.0-beta01 berisi commit ini.

  • Tidak ada perubahan dari versi alfa. Library ini telah distabilkan untuk rilis beta.

Versi 1.3.0-alpha01

27 Juli 2022

androidx.annotation:annotation-experimental:1.3.0-alpha01 dirilis. Versi 1.3.0-alpha01 berisi commit ini.

Perubahan API

  • Menambahkan dukungan untuk penggunaan tingkat paket dari @androidx.annotation.OptIn (I24d58)

Annotation-Experimental Versi 1.2.0

Versi 1.2.0

15 Desember 2021

androidx.annotation:annotation-experimental:1.2.0 dirilis. Versi 1.2.0 berisi commit ini.

Perubahan penting sejak 1.1.0

Library kini menargetkan tingkat bahasa Java 8.

Versi 1.2.0-rc01

1 Desember 2021

androidx.annotation:annotation-experimental:1.2.0-rc01 dirilis. Versi 1.2.0-rc01 berisi commit ini.

Tidak ada perubahan dari versi beta.

Versi 1.2.0-beta01

17 November 2021

androidx.annotation:annotation-experimental:1.2.0-beta01 dirilis. Versi 1.2.0-beta01 berisi commit ini.

Perubahan API

API telah diselesaikan untuk versi beta.

Annotation-Experimental Versi 1.2.0-alpha01

30 Juni 2021

androidx.annotation:annotation-experimental:1.2.0-alpha01 dirilis. Versi 1.2.0-alpha01 berisi commit ini.

Fitur Baru

  • Library kini menargetkan tingkat bahasa Java 8

Versi 1.2.0

Versi 1.2.0

24 Maret 2021

androidx.annotation:annotation:1.2.0 dirilis. Versi 1.2.0 berisi commit ini.

Perubahan utama sejak versi 1.1.0

  • Menambahkan anotasi @ChecksSdkIntAtLeast, yang dapat digunakan untuk mengidentifikasi metode atau kolom yang digunakan untuk membuka akses pada tingkat SDK dan memenuhi pemeriksaan lint NewApi.
  • Menambahkan anotasi @DoNotInline, yang disambungkan dengan aturan Proguard untuk mencegah anggota ditampilkan secara inline selama pengoptimalan.
  • Berbagai jenis anotasi kini dianotasikan dengan @Documented untuk memastikannya muncul dalam dokumentasi bagi anggota yang dianotasi.

Versi 1.2.0-rc01

24 Februari 2021

androidx.annotation:annotation:1.2.0-rc01 dirilis. Versi 1.2.0-rc01 berisi commit ini.

Versi 1.2.0-beta01

13 Januari 2021

androidx.annotation:annotation:1.2.0-beta01 dirilis. Versi 1.2.0-beta01 berisi commit ini.

Perubahan API

  • Anotasi @DoNotInline baru yang menginstruksikan pengoptimal kode (misalnya Proguard, R8) untuk tidak menyisipkan metode yang dianotasi. (I3dfe8, b/141326133)

Versi 1.2.0-alpha01

14 Mei 2020

androidx.annotation:annotation:1.2.0-alpha01 dirilis. Versi 1.2.0-alpha01 berisi commit ini.

Fitur Baru

  • Menambahkan anotasi @ChecksSdkIntAtLeast. Ini memungkinkan androidx dan pengguna menganotasi metode dan kolom yang merepresentasikan pemeriksaan SDK_INT. (I89a54, b/120255046)

Annotation-Experimental Versi 1.1.0

Versi 1.1.0

7 April 2021

androidx.annotation:annotation-experimental:1.1.0 dirilis. Versi 1.1.0 berisi commit ini.

Perubahan utama sejak versi 1.0.0

  • Anotasi eksperimental Jetpack telah ditulis ulang di Kotlin untuk memberikan dukungan bagi beberapa class penanda dan penanganan penghentian yang lebih baik.
  • Anotasi RequiresOptIn dan OptIn telah ditambahkan untuk paritas dengan Kotlin. Anotasi Experimental dan UsesExperimental tidak digunakan lagi.

Versi 1.1.0-rc02

24 Maret 2021

androidx.annotation:annotation-experimental:1.1.0-rc02 dirilis. Versi 1.1.0-rc02 berisi commit ini.

Perbaikan Bug

  • Menambahkan aturan Proguard untuk memastikan bahwa pengoptimalan kode tidak memperingatkan hilangnya anotasi meta Kotlin

Versi 1.1.0-rc01

10 Maret 2021

androidx.annotation:annotation-experimental:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit berikut.

Tidak ada perubahan sejak rilis beta sebelumnya.

Versi 1.1.0-beta01

27 Januari 2021

androidx.annotation:annotation-experimental:1.1.0-beta01 dirilis. Versi 1.1.0-beta01 berisi commit ini.

Perubahan API

  • Varian androidx dari anotasi Eksperimental tidak digunakan lagi untuk memberikan kesamaan dengan Kotlin. Diganti dengan varian androidx dari anotasi RequiresOptIn, dan linter Java telah diupdate untuk mendukung anotasi Kotlin baru dan varian androidx baru. (I52495, b/151331381)

Versi 1.1.0-alpha01

22 Juli 2020

androidx.annotation:annotation-experimental:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Fitur Baru

  • Sekarang library anotasi eksperimental ditulis dalam Kotlin, tetapi tidak mengharuskan library standar Kotlin untuk disertakan sebagai dependensi. Fitur ini meliputi file Proguard yang memungkinkan metadata Kotlin yang tidak perlu dihilangkan dari project yang hanya menggunakan bahasa pemrograman Java.
  • @UseExperimental sekarang mendukung beberapa class penanda (aosp/1185577, b/145137892)

Annotation-Experimental Versi 1.0.0

Annotation-Experimental Versi 1.0.0

7 November 2019

androidx.annotation:annotation-experimental:1.0.0 dan androidx.annotation:annotation-experimental-lint:1.0.0 dirilis tanpa perubahan sejak versi 1.0.0-rc01. Versi 1.0.0 berisi commit ini.

Fitur utama 1.0.0

  • Pemberlakuan berbasis Lint dari semantik @Experimental Kotlin dalam kode sumber Java
  • Anotasi Java yang memberikan perilaku yang setara dengan anotasi @Experimental dan @UseExperimental Kotlin tanpa memerlukan dependensi pada Kotlin

Annotation-Experimental Versi 1.0.0-rc01

23 Oktober 2019

androidx.annotation:annotation-experimental:1.0.0-rc01 dan androidx.annotation:annotation-experimental-lint:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit ini.

Masalah umum

Jika menggunakan Studio 3.5 stabil, peringatan dari detektor lint penggunaan @Experimental tidak ditampilkan dalam IDE untuk penggunaan Java yang tidak valid atas anotasi @Experimental Kotlin. Lihat b/140640322.

Annotation-Experimental Versi 1.0.0-beta01

9 Oktober 2019

androidx.annotation:annotation-experimental:1.0.0-beta01 dan androidx.annotation:annotation-experimental-lint:1.0.0-beta01 dirilis tanpa perubahan sejak versi 1.0.0-alpha01. Versi 1.0.0-beta01 berisi commit ini.

Annotation-Experimental Versi 1.0.0-alpha01

18 September 2019

androidx.annotation:annotation-experimental:1.0.0-alpha01 dan androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 dirilis. Ini adalah commit yang disertakan dalam annotation-experimental 1.0.0-alpha01, dan ini adalah commit yang disertakan dalam annotation-experimental-lint 1.0.0-alpha01

Fitur baru

  • Library anotasi Eksperimental Jetpack menyediakan implementasi yang kompatibel dengan Java untuk penanda API eksperimental Kotlin. Artefak -lint menyediakan penerapan berbasis Lint dari pembatasan penggunaan eksperimental dan memberlakukan pembatasan pada penggunaan Java atas penanda API eksperimental native Kotlin.

  • Saat menggunakan artefak annotation-experimental sebagai dependensi, aturan Lint yang diberikan oleh artefak annotation-experimental-lint akan diberlakukan secara otomatis.

Versi 1.1.0

Versi 1.1.0

5 Juni 2019

androidx.annotation:annotation:1.1.0 dirilis tanpa perubahan dari versi 1.1.0-rc01.

Versi 1.1.0-rc01

7 Mei 2019

androidx.annotation:annotation:1.1.0-rc01 dirilis tanpa perubahan dari 1.1.0-beta01. Commit yang disertakan dalam versi ini dapat dilihat di sini.

Versi 1.1.0-beta01

3 April 2019

androidx.annotation:annotation:1.1.0-beta01 dirilis. Commit yang disertakan dalam versi ini dapat dilihat di sini.

Fitur baru

  • Anotasi @InspectableProperty baru untuk mendukung API pemeriksaan tampilan baru yang ditambahkan di Android 10. Anotasi ini dapat diterapkan ke pengambil pada tampilan atau elemen UI lainnya. Fitur pembuatan kode dapat menggunakannya untuk membuat objek pendamping yang memetakan nama properti dan ID atribut ke nilai properti tanpa overhead pantulan.

Perubahan API

  • Perubahan yang dapat menyebabkan gangguan: @ContentView telah diubah menjadi anotasi konstruktor dan nilai @LayoutRes telah dihapus. Class yang ingin mendukung anotasi @ContentView harus menambahkan anotasi ini ke konstruktor yang menggunakan parameter @LayoutRes int. Perubahan ini memperbaiki masalah saat menggunakan anotasi ini dalam modul library. (b/128352521)

Versi 1.1.0-alpha02

13 Maret 2019

androidx.annotation:annotation:1.1.0-alpha02 dirilis. Daftar lengkap commit yang disertakan dalam versi ini dapat dilihat di sini.

Fitur baru

  • Cakupan pembatasan API baru: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Cakupan ini membatasi penggunaan pada kode dalam paket yang grupnya memiliki awalan grup library yang sama hingga . terakhir (titik). Misalnya, karena library foo.bar:lib1 dan foo.baz:lib2 memiliki awalan foo yang sama, keduanya dapat menggunakan API milik satu sama lain yang dibatasi pada cakupan ini. Demikian pula, com.foo.bar:lib1 dan com.foo.baz:lib2 memiliki awalan com.foo. yang sama dan dapat sama-sama menggunakan API yang dibatasi pada cakupan tersebut. Namun, library com.bar.qux:lib3 tidak akan dapat menggunakan API yang dibatasi karena hanya memiliki awalan com. yang sama dan tidak sepenuhnya sampai . terakhir (titik).

Versi 1.1.0-alpha01

30 Januari 2019

androidx.annotation:annotation 1.1.0-alpha01 dirilis.

Fitur baru

  • Menambahkan anotasi @ContentView yang memungkinkan Anda menunjukkan file XML tata letak yang harus di-inflate. Hal ini didukung di ComponentActivity dalam rilis 1.0.0-alpha04, dan Fragment dalam rilis 1.1.0-alpha04, sebagai alternatif untuk menggunakan setContentView() atau menggantikan onCreateView(), secara berurutan. (aosp/837619)

Versi 1.0.2

Versi 1.0.2

25 Februari 2019

androidx.annotation:annotation 1.0.2 dirilis.

Perbaikan bug

  • Memperbaiki aturan R8/ProGuard yang tersemat dalam jar. Sebelumnya, aturan ini salah merujuk pada jenis android.support.annotation lama, bukan androidx.annotation. Catatan: Perubahan ini hanya akan berdampak pada build Anda jika sebelumnya Anda tidak menggunakan getDefaultProguardFile karena aturan default tersebut juga menyertakan aturan yang benar untuk kedua paket. (aosp/891685)
  • Menambahkan aturan R8/ProGuard yang mempertahankan anotasi @Keep secara eksplisit. Aturan ini memastikan bahwa ProGuard tidak menghapus anotasi dari jenis sebelum benar-benar mematuhi semantiknya. Catatan: Perubahan ini hanya akan berdampak pada build Anda jika sebelumnya Anda tidak menggunakan getDefaultProguardFile karena aturan default tersebut juga menyertakan aturan yang benar untuk kedua paket. (aosp/903818)