Annotation
최근 업데이트 | 현재 안정화 버전 | 다음 버전 후보 | 베타 버전 | 알파 버전 |
---|---|---|---|---|
2021년 2월 24일 | 1.1.0 | 1.2.0-rc01 | - | - |
종속 항목 선언
Annotation의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.
다음과 같이 앱 또는 모듈의 build.gradle
파일에 필요한 아티팩트의 종속 항목을 추가합니다.
dependencies { implementation "androidx.annotation:annotation:1.1.0" // To use the Java-compatible @Experimental API annotation implementation "androidx.annotation:annotation-experimental:1.0.0" }
종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.
의견
제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 만들기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.
자세한 내용은 Issue Tracker 문서를 참고하세요.
버전 1.2.0
버전 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
Annotation-Experimental 버전 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)
Annotation-Experimental 버전 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을 참조하세요.