Annotation

  
도구 및 다른 개발자가 앱의 코드를 이해하는 데 도움이 되는 메타데이터를 노출합니다.

이 표에는 androidx.annotation 그룹의 모든 아티팩트가 나열됩니다.

아티팩트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
annotation 1.8.2 - - 1.9.0-alpha03
annotation-experimental 1.4.1 - - 1.5.0-alpha01
이 라이브러리는 2024년 9월 4일에 최종 업데이트되었습니다.

종속 항목 선언

Annotation의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

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

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.9

버전 1.9.0-alpha03

2024년 9월 4일

androidx.annotation:annotation-*:1.9.0-alpha03이 출시되었습니다. 버전 1.9.0-alpha03에는 이전 알파 버전 이후의 변경사항이 없습니다.

버전 1.9.0-alpha02

2024년 8월 21일

androidx.annotation:annotation-*:1.9.0-alpha02이 출시되었습니다. 버전 1.9.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

  • mingwX64 플랫폼 지원을 추가했습니다. (I461ca, b/349894318)
  • linuxArm64 Kotlin 멀티플랫폼 타겟 지원을 추가합니다. 추가했습니다. (I139d3, b/338268719)

버전 1.9.0-alpha01

2024년 6월 26일

androidx.annotation:annotation-*:1.9.0-alpha01이 출시되었습니다. 버전 1.9.0-alpha01에 포함된 커밋을 확인하세요.

외부 기여

  • 제이크 와튼 덕분에 linuxArm64 멀티플랫폼 타겟 지원이 추가되었습니다.

버전 1.8

버전 1.8.2

2024년 8월 7일

androidx.annotation:annotation-*:1.8.2이 출시되었습니다. 버전 1.8.2에 포함된 커밋을 확인하세요.

버그 수정

버전 1.8.1

2024년 7월 24일

androidx.annotation:annotation-*:1.8.1이 출시되었습니다. 버전 1.8.1에 포함된 커밋을 확인하세요.

버그 수정

  • 추가 Kotlin 멀티플랫폼 타겟(watchos, tvos)이 포함되어 있습니다.

버전 1.8.0

2024년 5월 14일

androidx.annotation:annotation-*:1.8.0이 출시되었습니다. 버전 1.8.0에 포함된 커밋을 확인하세요.

1.7.0 이후 중요 변경사항

  • 지원 중단된 API의 대체를 표현하기 위해 @ReplaceWith 주석을 추가했습니다.
  • @MainThread 주석을 공통 소스 세트로 이동했습니다.

버전 1.8.0-rc01

2024년 5월 1일

androidx.annotation:annotation-*:1.8.0-rc01이 출시되었습니다. 버전 1.8.0-rc01에는 이전 베타 출시 이후 변경사항이 없습니다.

버전 1.8.0-beta02

2024년 4월 17일

androidx.annotation:annotation-*:1.8.0-beta02이 출시되었습니다. 버전 1.8.0-beta02에는 이전 출시 이후 변경사항이 없습니다.

버전 1.8.0-beta01

2024년 4월 3일

androidx.annotation:annotation-*:1.8.0-beta01이 출시되었습니다. 버전 1.8.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

  • 이제 ReplaceWith 주석이 API에서 안정되지만 자동 수정과 연결된 린트 검사가 아직 제공되지 않았습니다.

버전 1.8.0-alpha02

2024년 3월 20일

androidx.annotation:annotation-*:1.8.0-alpha02이 출시되었습니다. 버전 1.8.0-alpha02에 포함된 커밋을 확인하세요.

버전 1.8.0-alpha01

2024년 2월 21일

androidx.annotation:annotation-*:1.8.0-alpha01이 출시되었습니다. 버전 1.8.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • 지원 중단된 API의 대체를 표현하기 위해 @ReplaceWith 주석을 추가했습니다. 추가했습니다. (I38db3, b/322373864)

외부 기여

  • @MainThread 주석을 공통 소스 세트로 이동해 주신 Ivan Matkov에게 감사드립니다. 추가했습니다. (6f228c)

버전 1.7

버전 1.7.1

2023년 12월 13일

androidx.annotation:annotation-*:1.7.1이 출시되었습니다. 버전 1.7.1에 포함된 커밋을 확인하세요.

버그 수정

  • 기본 플랫폼 종속 항목을 삽입할 때 compile 범위를 사용합니다. 추가했습니다. (I4958f)

버전 1.7.0

2023년 9월 6일

androidx.annotation:annotation-*:1.7.0이 출시되었습니다. 버전 1.7.0에 포함된 커밋을 확인하세요.

1.6.0 이후 중요 변경사항

  • iOS, Linux, MacOS 플랫폼을 타겟팅하는 Kotlin 멀티플랫폼 아티팩트를 포함합니다.
  • 이제 KMM 프로젝트에서 주석을 사용할 수 있습니다. Annotations의 비 Android 대상은 아직 실험 단계이지만 개발자가 더 쉽게 사용해 볼 수 있도록 버전을 병합하기로 결정했습니다. 특히 알파 개발 중에 경계를 마무리하는 과정에서 일반 코드와 플랫폼별 코드 간에 일부 주석이 이동할 수도 있습니다.

버전 1.7.0-rc01

2023년 8월 23일

androidx.annotation:annotation-*:1.7.0-rc01이 출시되었습니다. 버전 1.7.0-rc01에 포함된 커밋을 확인하세요.

이 버전에는 이전 베타의 변경사항이 포함되어 있지 않습니다.

버전 1.7.0-beta01

2023년 8월 9일

androidx.annotation:annotation-*:1.7.0-beta01이 출시되었습니다. 버전 1.7.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

  • 출시를 위해 안정화된 API

버전 1.7.0-alpha03

2023년 7월 26일

androidx.annotation:annotation-*:1.7.0-alpha03이 출시되었습니다. 버전 1.7.0-alpha03에 포함된 커밋을 확인하세요.

버그 수정

  • 이제 Maven POM 게시에 기본 JVM 타겟팅 멀티플랫폼 아티팩트가 종속 항목으로 포함됩니다.

버전 1.7.0-alpha02

2023년 3월 24일

androidx.annotation:annotation-*:1.7.0-alpha02이 출시되었습니다.

버그 수정

  • Kotlin 네이티브 타겟의 빌드 문제를 해결하기 위해 Maven 아티팩트에서 종속 항목 제약 조건을 삭제했습니다. (b/274786186, KT-57531)

버전 1.7.0-alpha01

2023년 3월 22일

androidx.annotation:annotation-*:1.7.0-alpha01이 출시되었습니다. 버전 1.7.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • iOS, Linux, MacOS 플랫폼을 타겟팅하는 Kotlin 멀티플랫폼 아티팩트를 포함합니다.
  • 이제 KMM 프로젝트에서 주석을 사용할 수 있습니다. Annotations의 비 Android 대상은 아직 실험 단계이지만 개발자가 더 쉽게 사용해 볼 수 있도록 버전을 병합하기로 결정했습니다. 특히 알파 개발 중에 경계를 마무리하는 과정에서 일반 코드와 플랫폼별 코드 간에 일부 주석이 이동할 수도 있습니다.

버전 1.6

버전 1.6.0

2023년 2월 22일

androidx.annotation:annotation:1.6.0 및 androidx.annotation:annotation-jvm:1.6.0이 출시되었습니다. 버전 1.6.0에 포함된 커밋을 확인하세요.

1.5.0 이후 중요 변경사항

  • API에 특정 확장 프로그램 SDK의 특정 버전이 필요하다는 사실을 표현하는 @RequiresExtension 주석을 추가했습니다. (I5e4fe)
  • Kotlin Multiplatform 도구 모음을 사용하여 빌드하도록 주석 라이브러리를 변환했습니다. (I3be8d)

버전 1.6.0-rc01

2023년 2월 8일

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

2023년 1월 25일

androidx.annotation:annotation:1.6.0-beta01 및 androidx.annotation:annotation-jvm:1.6.0-beta01이 1.6.0-alpha01에서 변경사항 없이 출시되었습니다.

버전 1.6.0-alpha01

2023년 1월 11일

androidx.annotation:annotation-*:1.6.0-alpha01이 출시되었습니다. 버전 1.6.0-alpha01에 포함된 커밋을 확인하세요.

버전 1.6.0-dev01

2023년 2월 8일

androidx.annotation:annotation-*:1.6.0-dev01이 출시되었습니다. 버전 1.6.0-dev01에 포함된 커밋을 확인하세요.

  • 개발자 프리뷰 1.6.0-dev01에서 Kotlin 멀티 플랫폼에 대해 주석이 사용 설정되었습니다.

새로운 기능

  • @RequiresExtension 주석을 추가하여 API에 특정한 SDK 확장 프로그램의 특정 버전이 필요하다는 것을 표현합니다. (I5e4fe)
  • Kotlin Multiplatform 도구 모음을 사용하여 빌드하도록 주석 라이브러리를 변환했습니다. (I3be8d)

버전 1.5.0

버전 1.5.0

2022년 9월 21일

androidx.annotation:annotation:1.5.0이 출시되었습니다. 버전 1.5.0에 포함된 커밋을 확인하세요.

1.4.0 이후 중요 변경사항

  • 주석 라이브러리가 Kotlin 소스로 완전히 이전되어 Kotlin 전용 타겟 사용 사이트 및 기타 Kotlin 호환 주석 기능이 지원됩니다.

버전 1.5.0-rc01

2022년 9월 7일

androidx.annotation:annotation:1.5.0-rc01이 출시되었습니다. 버전 1.5.0-rc01에 포함된 커밋을 확인하세요.

  • 이전 1.5.0 베타 버전에서 변경된 사항이 없습니다.

버전 1.5.0-beta01

2022년 8월 24일

androidx.annotation:annotation:1.5.0-beta01이 출시되었습니다. 버전 1.5.0-beta01에 포함된 커밋을 확인하세요.

  • 이전 버전에서 변경된 사항이 없습니다. 베타용으로 API 노출 영역이 정지되었습니다.

버전 1.5.0-alpha02

2022년 8월 10일

androidx.annotation:annotation:1.5.0-alpha02이 출시되었습니다. 버전 1.5.0-alpha02에 포함된 커밋을 확인하세요.

  • 이전 알파 출시 이후 변경사항이 없습니다.

버전 1.5.0-alpha01

2022년 7월 27일

androidx.annotation:annotation:1.5.0-alpha01이 출시되었습니다. 버전 1.5.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 주석 라이브러리가 Kotlin 소스로 완전히 이전되어 Kotlin 전용 타겟 사용 사이트 및 기타 Kotlin 호환 주석 기능이 지원됩니다.

버전 1.4.0

버전 1.4.0

2022년 6월 15일

androidx.annotation:annotation:1.4.0이 출시되었습니다. 버전 1.4.0에 포함된 커밋을 확인하세요.

1.3.0 이후 중요 변경사항

  • @RestrictTo가 Kotlin 소스로 이전되었으며 이제 @file 사용 사이트를 지원합니다. 따라서 이제 주석 라이브러리가 Kotlin 표준 라이브러리에 종속됩니다.
  • @ReturnThis(b/140249763): 이 메서드의 재정의 메서드가 동일한 인스턴스를 반환해야 합니다(빌더용 등).
  • @OpenForTesting(b/141539024): 'open'으로 표시된 Kotlin 클래스와 메서드는 이 주석을 달 수 있습니다. 린트는 이 클래스가 단위 테스트에서 서브클래스로만 분류되고 메서드만 재정의되도록 합니다.
  • @DeprecatedSinceApi(b/37116481): 주석이 달린 메서드(또는 클래스나 필드)가 플랫폼 API 백포트 라이브러리의 일부이며 이는 지정된 API 수준부터 더 이상 필요하지 않음을 나타냅니다.
  • @EmptySuper: 이 메서드가 비어 있기로 정의되므로 재정의할 때 이 메서드를 호출할 필요가 없으며 실제로 호출하지 않아야 합니다. 예를 들어 이전 버전과의 호환성 검사가 포함될 수 있습니다.

버전 1.4.0-rc01

2022년 6월 1일

androidx.annotation:annotation:1.4.0-rc01이 출시되었습니다. 버전 1.4.0-rc01에 포함된 커밋을 확인하세요.

  • API 노출 영역 및 기능의 출시가 확정되었습니다.

버전 1.4.0-beta01

2022년 5월 18일

androidx.annotation:annotation:1.4.0-beta01이 출시되었습니다. 버전 1.4.0-beta01에 포함된 커밋을 확인하세요.

  • 마지막 알파 이후 변경사항이 없습니다. 베타 출시를 위해 API 노출 영역이 잠겼습니다.

버전 1.4.0-alpha02

2022년 2월 9일

androidx.annotation:annotation:1.4.0-alpha02가 출시되었습니다. 버전 1.4.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

  • @ReturnThis, @OpenForTesting, @EmptySuper, @DeprecatedSinceApi 주석을 추가했습니다. (21946a2)

  • @ReturnThis(b/140249763): 이 메서드의 재정의 메서드가 동일한 인스턴스를 반환해야 합니다(빌더용 등).

  • @OpenForTesting(b/141539024): 'open'으로 표시된 Kotlin 클래스와 메서드는 이 주석을 달 수 있습니다. 린트는 이 클래스가 단위 테스트에서 서브클래스로만 분류되고 메서드만 재정의되도록 합니다.

  • @DeprecatedSinceApi(b/37116481): 주석이 달린 메서드(또는 클래스나 필드)가 플랫폼 API 백포트 라이브러리의 일부이며 이는 지정된 API 수준부터 더 이상 필요하지 않음을 나타냅니다.

  • @EmptySuper: 이 메서드가 비어 있기로 정의되므로 재정의할 때 이 메서드를 호출할 필요가 없으며 실제로 호출하지 않아야 합니다. 예를 들어 이전 버전과의 호환성 검사가 포함될 수 있습니다.

버전 1.4.0-alpha01

2021년 12월 15일

androidx.annotation:annotation:1.4.0-alpha01이 출시되었습니다. 버전 1.4.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • RestrictTo 주석을 Kotlin 소스로 이전했습니다. (Ia6336)

버전 1.3.0

버전 1.3.0

2021년 11월 3일

androidx.annotation:annotation:1.3.0이 출시되었습니다. 버전 1.3.0에 포함된 커밋을 확인하세요.

1.2.0 이후 중요 변경사항

  • @Discouraged 주석이 지원 중단할 합당한 이유가 없으나 성능에는 부정적인 영향을 크게 미치고 일반 프로덕션 코드로 호출하면 안 되는 API를 표시합니다.
  • @Context 주석이 개발자가 새로운 API로 더 쉽게 이전할 수 있도록 일반 컨텍스트를 표시합니다.
  • @GravityInt 주석이 정수로 처리된 중력값을 포함하는 요소를 표시합니다.
  • @InspectableProperty를 지원 중단하고 androidx.resourceinspection의 @Attribute로 대체했습니다.

버전 1.3.0-rc01

2021년 10월 27일

androidx.annotation:annotation:1.3.0-rc01이 출시되었습니다. 버전 1.3.0-rc01에 포함된 커밋을 확인하세요.

버전 1.3.0-beta01

2021년 9월 29일

androidx.annotation:annotation:1.3.0-beta01이 출시되었습니다. 버전 1.3.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • @Discouraged의 '메시지'에 설명이 필요합니다. (I3390f)
  • 권장되지 않는 요소를 표시하는 @Discouraged 주석을 추가했습니다. (Ib2549)
  • Android 스튜디오 문서 팝업에서 RestrictTo 주석이 표시되도록 합니다. (Ie8e1a, b/183134648)

버그 수정

  • 일반 컨텍스트를 표시하는 컨텍스트 주석을 추가하여 개발자가 새 API로 더 쉽게 이전할 수 있습니다. (Ie581a)

버전 1.3.0-alpha01

2021년 3월 24일

androidx.annotation:annotation:1.3.0-alpha01이 출시되었습니다. 버전 1.3.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • androidx.resourceinspection에서 @InspectableProperty가 지원 중단되고 @Attribute로 대체되었습니다. (Ic0eff)
  • 정수로 처리된 중력 값을 포함하는 요소를 표시하기 위해 @GravityInt 주석이 추가되었습니다. (Ifcaa4, b/180620048)

Annotation-Experimental 버전 1.5

버전 1.5.0-alpha01

2024년 8월 21일

androidx.annotation:annotation-experimental:1.5.0-alpha01이 출시되었습니다. 버전 1.5.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • message를 RequiresOptIn에 추가하여 Kotlin stdlib 주석과 기본 빈 문자열 값을 일치시킵니다. 추가했습니다. (I1f50e)

Annotation-Experimental 버전 1.4

버전 1.4.1

2024년 4월 3일

androidx.annotation:annotation-experimental:1.4.1이 출시되었습니다. 버전 1.4.1에 포함된 커밋을 확인하세요.

버그 수정

  • Kotlin 파일에서 실수로 RequiresOptIn 검사를 트리거하지 않도록 isKotlin 사용을 수정합니다. 추가했습니다. (I2d8c1f)

버전 1.4.0

2024년 1월 24일

androidx.annotation:annotation-experimental:1.4.0이 출시되었습니다. 버전 1.4.0에 포함된 커밋을 확인하세요.

1.3.0 이후 중요 변경사항

  • Kotlin 멀티 플랫폼 지원 추가
  • Kotlin 2.0과의 호환성 수정
  • 실험용으로 주석 처리된 Kotlin 속성의 Java 사용에 관한 경고를 표시합니다. (I8bd43)
  • Kotlin 메서드에서 자동 수정 주석의 배치를 수정합니다. (Id7a41)

버전 1.4.0-rc01

2024년 1월 10일

androidx.annotation:annotation-experimental:1.4.0-rc01이 출시되었습니다. 버전 1.4.0-rc01에는 이전 출시 이후의 변경사항이 없습니다.

버전 1.4.0-beta01

2023년 12월 13일

androidx.annotation:annotation-experimental:1.4.0-beta01이 출시되었습니다. 이전 출시 이후 변경사항이 없습니다.

버전 1.4.0-alpha01

2023년 11월 29일

androidx.annotation:annotation-experimental:1.4.0-alpha01이 출시되었습니다. 버전 1.4.0-alpha01에 포함된 커밋을 확인하세요.

버그 수정

  • b/301598518을 해결하기 위해 클래스 수준의 자동 수정 추천을 일시적으로 삭제합니다. 추가했습니다. (Id98b2)
  • 실험용으로 주석 처리된 Kotlin 속성의 Java 사용에 관한 경고를 표시합니다. (I8bd43)
  • Kotlin 메서드에서 자동 수정 주석의 배치를 수정합니다. (Id7a41)

버전 1.4.0-dev01

2023년 2월 8일

androidx.annotation:annotation-experimental:1.4.0-dev01이 출시되었습니다. 버전 1.4.0-dev01에 포함된 커밋을 확인하세요.

  • 개발자 프리뷰 1.4.0-dev01에서 Kotlin 멀티 플랫폼에 대해 Annotation-experimental이 사용 설정되었습니다.

Annotation-Experimental 버전 1.3.1

버전 1.3.1

2023년 6월 21일

androidx.annotation:annotation-experimental:1.3.1이 출시되었습니다. 버전 1.3.1에 포함된 커밋을 확인하세요.

버그 수정

  • 린트 자동 수정을 적용할 때 수정자 목록의 시작 부분에 주석을 배치합니다. b/251172715를 참조하세요.
  • 린트 검사를 사용하여 Kotlin 소스에서 androidx.annotation.RequiresOptIn를 사용하지 않도록 합니다. (b/241097743)

Annotation-Experimental 버전 1.3.0

버전 1.3.0

2022년 9월 7일

androidx.annotation:annotation-experimental:1.3.0이 출시되었습니다. 버전 1.3.0에 포함된 커밋을 확인하세요.

1.2.0 이후 중요 변경사항

  • @androidx.annotation.OptIn의 패키지 수준 사용에 대한 지원이 추가되었습니다(I24d58).
  • Kotlin stdlib 종속 항목을 컴파일 전용이 아닌 API 유형으로 이동했습니다. 즉, Annotation-Experimental 라이브러리의 모든 클라이언트가 전이 종속 항목에 Kotlin 표준 라이브러리를 포함합니다.

버전 1.3.0-rc01

2022년 8월 24일

androidx.annotation:annotation-experimental:1.3.0-rc01이 출시되었습니다. 버전 1.3.0-rc01에 포함된 커밋을 확인하세요.

  • 이전 버전에서 변경된 사항이 없습니다. RC 구현이 중단되었습니다.

버전 1.3.0-beta01

2022년 8월 10일

androidx.annotation:annotation-experimental:1.3.0-beta01이 출시되었습니다. 버전 1.3.0-beta01에 포함된 커밋을 확인하세요.

  • 알파 버전에서 변경된 사항이 없습니다. 이 라이브러리는 베타 출시를 위해 안정화되었습니다.

버전 1.3.0-alpha01

2022년 7월 27일

androidx.annotation:annotation-experimental:1.3.0-alpha01이 출시되었습니다. 버전 1.3.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • @androidx.annotation.OptIn의 패키지 수준 사용에 대한 지원이 추가되었습니다(I24d58).

Annotation-Experimental 버전 1.2.0

버전 1.2.0

2021년 12월 15일

androidx.annotation:annotation-experimental:1.2.0이 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.

1.1.0 이후 중요 변경사항

이제 이 라이브러리는 자바 8 언어 수준을 타겟팅합니다.

버전 1.2.0-rc01

2021년 12월 1일

androidx.annotation:annotation-experimental:1.2.0-rc01이 출시되었습니다. 버전 1.2.0-rc01에 포함된 커밋을 확인하세요.

베타에서 변경된 사항이 없습니다.

버전 1.2.0-beta01

2021년 11월 17일

androidx.annotation:annotation-experimental:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

API 베타 버전을 확정했습니다.

Annotation-Experimental 버전 1.2.0-alpha01

2021년 6월 30일

androidx.annotation:annotation-experimental:1.2.0-alpha01이 출시되었습니다. 버전 1.2.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 이제 라이브러리는 자바 8 언어 수준을 타겟팅합니다.

버전 1.2.0

버전 1.2.0

2021년 3월 24일

androidx.annotation:annotation:1.2.0이 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.

1.1.0 이후 주요 변경사항

  • SDK 수준에서 액세스를 통제하는 데 사용된 메서드나 필드를 식별하고 NewApi 린트 검사를 충족하는 데 사용할 수 있는 @ChecksSdkIntAtLeast 주석이 추가되었습니다.
  • 최적화 중에 구성원이 인라인되지 않도록 Proguard 규칙과 페어링되는 @DoNotInline 주석이 추가되었습니다.
  • 이제 주석 처리된 구성원에 관한 주석이 문서에 표시되도록 다양한 주석이 @Documented로 주석 처리됩니다.

버전 1.2.0-rc01

2021년 2월 24일

androidx.annotation:annotation:1.2.0-rc01이 출시되었습니다. 버전 1.2.0-rc01에 포함된 커밋을 확인하세요.

버전 1.2.0-beta01

2021년 1월 13일

androidx.annotation:annotation:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • 새 @DoNotInline 주석은 주석 지정된 메서드를 인라인 처리하지 않도록 코드 옵티마이저(예: Proguard, R8)에 지시합니다. (I3dfe8, b/141326133)

버전 1.2.0-alpha01

2020년 5월 14일

androidx.annotation:annotation:1.2.0-alpha01가 출시되었습니다. 버전 1.2.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • @ChecksSdkIntAtLeast 주석이 추가되었습니다. 이를 사용하여 androidx와 사용자는 SDK_INT 검사를 나타내는 메서드와 필드에 주석을 추가할 수 있습니다. (I89a54, b/120255046)

Annotation-Experimental 버전 1.1.0

버전 1.1.0

2021년 4월 7일

androidx.annotation:annotation-experimental:1.1.0이 출시되었습니다. 버전 1.1.0에 포함된 커밋을 확인하세요.

1.0.0 이후 주요 변경사항

  • Jetpack의 실험용 주석은 여러 마커 클래스를 지원하고 지원 중단 처리를 개선하기 위해 Kotlin으로 재작성되었습니다.
  • Kotlin과 동일하도록 RequiresOptIn과 OptIn 주석을 추가했고 Experimental과 UsesExperimental 주석은 지원 중단했습니다.

버전 1.1.0-rc02

2021년 3월 24일

androidx.annotation:annotation-experimental:1.1.0-rc02가 출시되었습니다. 버전 1.1.0-rc02에 포함된 커밋을 확인하세요.

버그 수정

  • 코드 최적화에서 Kotlin 메타 주석 누락 경고를 표시하지 않도록 Proguard 규칙이 추가되었습니다.

버전 1.1.0-rc01

2021년 3월 10일

androidx.annotation:annotation-experimental:1.1.0-rc01이 출시되었습니다. 버전 1.1.0-rc01에 포함된 커밋을 확인하세요.

이전의 베타 버전 이후 변경사항이 없습니다.

버전 1.1.0-beta01

2021년 1월 27일

androidx.annotation:annotation-experimental:1.1.0-beta01이 출시되었습니다. 버전 1.1.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

  • 실험용 주석의 androidx 변형이 Kotlin과의 패리티를 제공하기 위해 지원 중단되었습니다. RequiresOptIn 주석의 androidx 변형으로 대체되었으며 자바 관련 린터가 새 Kotlin 주석과 새 androidx 변형을 모두 지원하도록 업데이트되었습니다. (I52495, b/151331381)

버전 1.1.0-alpha01

2020년 7월 22일

androidx.annotation:annotation-experimental:1.1.0-alpha01가 출시되었습니다. 버전 1.1.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 실험용 주석 라이브러리는 이제 Kotlin으로 작성되지만, Kotlin 표준 라이브러리를 종속 항목으로 포함하지 않아도 됩니다. 자바 프로그래밍 언어만 사용하는 프로젝트에서 불필요한 Kotlin 메타데이터를 제거할 수 있는 Proguard 파일이 포함되어 있습니다.
  • @UseExperimental는 이제 여러 마커 클래스를 지원합니다. (aosp/1185577, b/145137892)

Annotation-Experimental 버전 1.0.0

Annotation-Experimental 버전 1.0.0

2019년 11월 7일

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 의미 체계를 적용합니다.
  • 자바 주석은 Kotlin의 종속성 없이도 Kotlin의 @Experimental 및 @UseExperimental 주석과 동등한 동작을 제공합니다.

Annotation-Experimental 버전 1.0.0-rc01

2019년 10월 23일

androidx.annotation:annotation-experimental:1.0.0-rc01 및 androidx.annotation:annotation-experimental-lint:1.0.0-rc01이 출시되었습니다. 버전 1.0.0-rc01에 포함된 커밋을 확인하세요.

알려진 문제

Android 스튜디오 3.5 공개 버전 사용 시 Kotlin @Experimental 주석의 잘못된 자바 사용과 관련하여 @Experimental 사용 린트 감지기의 경고가 IDE에 표시되지 않습니다. b/140640322를 참조하세요.

Annotation-Experimental 버전 1.0.0-beta01

2019년 10월 9일

androidx.annotation:annotation-experimental:1.0.0-beta01 및 androidx.annotation:annotation-experimental-lint:1.0.0-beta01 버전은 1.0.0-alpha01 이후 변경사항 없이 출시되었습니다. 버전 1.0.0-beta01에 포함된 커밋을 확인하세요.

Annotation-Experimental 버전 1.0.0-alpha01

2019년 9월 18일

androidx.annotation:annotation-experimental:1.0.0-alpha01 및 androidx.annotation:annotation-experimental-lint:1.0.0-alpha01가 출시되었습니다. annotation-experimental 1.0.0-alpha01에는 이러한 커밋이 포함되어 있으며 annotation-experimental-lint 1.0.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Jetpack 실험용 주석 라이브러리는 Kotlin 실험용 API 마커의 자바 호환 구현을 제공합니다. -lint 아티팩트는 실험 사용 제한의 린트 기반 구현을 제공하며 Kotlin 네이티브 실험용 API 마커의 자바 사용에 제한을 적용합니다.

  • annotation-experimental 아티팩트를 종속성으로 사용할 때 annotation-experimental-lint 아티팩트에서 제공하는 린트 규칙이 자동으로 적용됩니다.

버전 1.1.0

버전 1.1.0

2019년 6월 5일

androidx.annotation:annotation:1.1.0 버전은 1.1.0-rc01에서 변경사항 없이 출시되었습니다.

버전 1.1.0-rc01

2019년 5월 7일

androidx.annotation:annotation:1.1.0-rc01 버전은 1.1.0-beta01에서 변경사항 없이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버전 1.1.0-beta01

2019년 4월 3일

androidx.annotation:annotation:1.1.0-beta01이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

새로운 기능

  • 새로운 뷰 검사 API를 지원하는 새 @InspectableProperty 주석이 Android 10에 추가되었습니다. 이 주석을 뷰 또는 다른 UI 요소의 getter에 적용할 수 있습니다. 코드 생성 도구에서 이 주석을 사용하여 리플렉션 오버헤드 없이 속성 이름 및 속성 ID를 속성 값에 매핑하는 컴패니언 객체를 생성할 수 있습니다.

API 변경사항

  • 브레이킹 체인지: @ContentView가 생성자 주석으로 변경되고 @LayoutRes 값이 삭제되었습니다. @ContentView 주석을 지원할 클래스는 @LayoutRes int 매개변수를 사용하는 생성자에 이 주석을 추가해야 합니다. 그러면 라이브러리 모듈에서 이 주석을 사용할 때 발생하는 문제가 수정됩니다. b/128352521을 참조하세요.

버전 1.1.0-alpha02

2019년 3월 13일

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 라이브러리는 com. 접두사만 공유하고 마지막 마침표(.)까지는 모두 공유하지 않기 때문에 제한된 API를 사용할 수 없습니다.

버전 1.1.0-alpha01

2019년 1월 30일

androidx.annotation:annotation 1.1.0-alpha01이 출시되었습니다.

새로운 기능

  • 확장해야 하는 레이아웃 XML 파일을 나타낼 수 있는 @ContentView 주석이 추가되었습니다. 이 주석은 setContentView()를 사용하거나 onCreateView()를 재정의하는 대신 각각 1.0.0-alpha04의 ComponentActivity 및 1.1.0-alpha04의 Fragment에서 지원됩니다. aosp/837619를 참조하세요.

버전 1.0.2

버전 1.0.2

2019년 2월 25일

androidx.annotation:annotation 1.0.2가 출시되었습니다.

버그 수정

  • jar에 삽입된 R8/ProGuard 규칙을 수정했습니다. 이러한 규칙은 androidx.annotation 대신 이전 android.support.annotation 유형을 잘못 참조하고 있었습니다. 참고: 이 문제는 getDefaultProguardFile을 사용하지 않을 때만 빌드에 영향을 주었습니다. 기본 규칙에는 두 패키지 모두의 올바른 규칙이 포함되어 있기 때문입니다. aosp/891685를 참고하세요.
  • @Keep 주석을 명시적으로 유지하는 R8/ProGuard 규칙을 추가했습니다. 이에 따라 ProGuard는 의미 체계를 실제로 준수하기 전에 유형에서 주석을 삭제하지 않습니다. 참고: 이 문제는 getDefaultProguardFile을 사용하지 않을 때만 빌드에 영향을 주었습니다. 기본 규칙에는 두 패키지 모두의 올바른 규칙이 포함되어 있기 때문입니다. aosp/903818을 참조하세요.