Annotation

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

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

아티팩트 공개 버전 출시 후보 베타 버전 알파 버전
annotation 1.4.0 - - 1.5.0-alpha01
annotation-experimental 1.2.0 - - 1.3.0-alpha01
이 라이브러리는 2022년 7월 27일에 마지막으로 업데이트되었습니다.

종속 항목 선언

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

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

Groovy

dependencies {
    implementation "androidx.annotation:annotation:1.4.0"
    // To use the Java-compatible @Experimental API annotation
    implementation "androidx.annotation:annotation-experimental:1.2.0"
}

Kotlin

dependencies {
    implementation("androidx.annotation:annotation:1.4.0")
    // To use the Java-compatible @Experimental API annotation
    implementation("androidx.annotation:annotation-experimental:1.2.0")
}

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

의견

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

새로운 문제 제출하기

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

버전 1.5.0

버전 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.3.0

버전 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을 참조하세요.