Android Annotation 정리
Published in
11 min readMar 29, 2021
안드로이드 사용되는 어노테이션은 무엇이 있는지 알아봅니다.
✨ Res 관련 어노테이션
메서드나 지역 변수, 필드 반환 값이 리소스 참조가 될 것으로 예상됨을 나타냅니다.
@AnimatorRes:animator 리소스 참조 —android.R.animator.fade_in@AnimRes: anim 리소스 참조 —android.R.anim.fade_in@AnyRes: 모든 타입의 리소스 참조 (특정 타입을 알고 있는 경우 구체적인 주석을 사용하면 됨)@ArrayRes: 배열 타입의 리소스 참조 —android.R.array.phoneTypes@AttrRes: attribute 리소스 참조 —android.R.attr.action@BoolRes: boolean 리소스 참조@ColorRes: color 리소스 참조 —anroid.R.color.white@DimenRes: dimen 리소스 참조 —android.R.dimen.app_icon_size@DrawableRes: drawable 리소스 참조 —android.R.attr.alertDialogIcon@FontRes: font 리소스 참조 —R.font.myfont@FractionRes: 퍼센트 리소스 참조 —R.fraction.pivot_x@IdRes: id 리소스 참조 —R.id.button@IntegerRes: integer 리소스 참조 —android.R.integer.config_shortAnimTime@InterpolatorRes: interpolator 리소스 참조 —android.R.interpolator.cycle@LayoutRes: layout 리소스 참조 —android.R.layout.list_content@MenuRes: menu 리소스 참조@NavigationRes: navigation 리소스 참조 —R.navigation.flow@PluralsRes: plurals(개수에 따른 문자열 표현)리소스 참조 —getQuantityString메서드 처럼 아이템의 갯수에 따른 각각 다른 문자열을 표현하고 싶을 때 사용하는 resource 타입입니다. 참고@RawRes: raw(원본 리소스들: txt, 음악 파일 등) 리소스 참조@StringRes: string 리소스 참조@StyleableRes: styleable 리소스 참조 —android.R.styleable.TextView_text@StyleRes: style 리소스 참조 —android.R.style.TextAppearance@TransitionRes: transition(전환 애니메이션 효과) 리소스 참조@XmlRes: XML 리소스 참조
🚀 Thread 관련 어노테이션
메소드에 해당 어노테이션이 붙은 경우 해당 스레드에서 호출될 수 있음을 나타내며 클래스에 붙은 경우 클래스의 모든 메소드는 해당 스레드에서 호출 될 수 있습니다.
@AnyThread: 모든 스레드에서 호출 가능합니다.@BindThread: 바인더 스레드에서만 호출 가능합니다. (서비스의 별도 스레드)@MainThread(@UiThread): 메인(UI) 스레드에서만 호출 가능합니다.@WorkerThread: worker(백그라운드 작업 같은 오래 걸리는 작업) 스레드에서만 호출 가능합니다.
🛠 그 밖의 유용한 어노테이션
@CallSuper: 이 어노테이션이 붙은 메서드를 하위 클래스에서 오버라이드 할 땐 반드시 상위 클래스의 메서드를 호출하도록 강제함을 나타냅니다.
ex ) 액티비티의 라이프사이클 메서드
@CheckResult: 해당 어노테이션이 붙은 메서드가 리턴한 결과값을 개발자가 따로 사용하지 않고 무시했을 때 오류를 뱉어냅니다.
@CheckResult
fun trim(s: String) = s.trim()...
s.trim() // 결과값을 따로 세팅하지 않아주었으므로 컴파일 에러 발생
val str = s.trim() // ok
@CheckSdkIntAtLeast: 해당 어노테이션이 추가된 메서드가 SDK_INT API 레벨이 최소 주어진 값인지 검사하고 결과를 반환하거나 지정된 람다식을 실행합니다.
@ChecksSdkIntAtLeast(api = Build.VERSION_CODES.O)
fun isAtLeastO() = Build.VERSION.SDK_INT >= 26// 어노테이션의 인자로 들어갈 수 있는 속성은 다음과 같습니다.
// api: Int -> 최소 API
// codename: String -> 최소 API의 코드명("R")
// lambda: Int -> 최소 API 레벨을 만족할 경우 실행될 람다의 파라미터 번호
// parameter: Int -> 최소 API 레벨이 파라미터에 지정되며 첫 번째 파라미터 번호는 0부터 시작입니다.@ChecksSdkIntAtLeast(parameter = 0, lambda = 1)
inline fun fromApi(value: Int, action: () -> Unit) {
if (Build.VERSION.SDK_INT >= value) {
action()
}
}
// 0번째 파라미터에 최소 API 레벨을 주었으며 1번째 파라미터에 실행될 람다식을 넣어줌을 // 뜻합니다.// Kotlin 프로퍼티에도 사용 가능
@get:ChecksSdkIntAtLeast(api = Build.VERSION_CODES.GINGERBREAD)
val isGingerbread: Boolean
get() = Build.VERSION.SDK_INT >= Build.VERSION_CODES.GINGERBREAD
@ContentView: 생성자에 연결할 수 있는 어노테이션이며LayoutRes를 생성자의 인자로 받으면setContentView를 대체해줍니다.
class MainFragment: Fragment {
fun MainFragment() {
// 아래 생성자는 @ContentView 어노테이션이 연결되어 있습니다.
super(R.layout.main)
}
}// Fragment 내부 코드
@ContentView
public Fragment(@LayoutRes int contentLayoutId) {
this();
mContentLayoutId = contentLayoutId;
}
@DoNotInline: 코드가 빌드 시 최적화 할 때 어노테이션이 연결된 메소드는 인라인으로 변경되지 않아야 함을 나타냅니다. 이는 일반적으로 별도의 클래스에 포함되도록 의도적으로 라인 외부 메서드의 인라인을 방지하는 데 사용됩니다.@GuardedBy: 해당 필드나 메소드를 사용하려면 락을 보유해야만 접근할 수 있다는 것을 의미합니다.
private val anyLock = Any()
@GuardedBy("anyLock") // anyLock 객체를 보유해야 필드 접근 가능
@Volatile
private var lockObject : Any? = null
fun getLock(): Any? {
synchronized(anyLock) {
if (lockObject == null) {
lockObject = Any()
}
}
return lockObject
}@Keep: 빌드 시 코드가 최적화 될 때 어노테이션이 연결된 요소를 제거하지 않아야 함을 나타냅니다.@OptIn: 어노테이션이 연결된 파일, 선언, 식에서 opt-in API를 사용할 수 있습니다.@RequiresOptIn: 해당 어노테이션이 연결된 요소가 OptIn API의 마커임을 나타냅니다. 불안정하거나 비표준 API의 일부로 간주되며 해당 요소를 호출하려면 OptIn을 사용하거나@OptIn어노테이션을 달아야합니다.@RequiresApi: 해당 어노테이션은@TargetApi와 유사하게 지정된 API ㅔ벨 이상에서만 호출되어야 함을 의미하지만 해당 메소드에 대한 호출자의 요구 사항임을 더욱 명확하게 나타냅니다.@RequirePermission: 하나 이상의 권한이 필요하거나 필요할 수 있음을 나타내는 어노테이션 입니다.
// 단일 권한이 필요한 예
@RequiresPermission(ACCESS_COARSE_LOCATION)
abstract fun getLastKnownLocation(String provider): Location// 하나 이상의 권한을 요구하는 예
@RequiresPermission(
anyOf = { ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION }
)
abstract fun getLastKnownLocation(String provider): Location// 여러 권한이 필요한 예
@RequiresPermission(
allOf = {ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION}
)
abstract fun getLastKnownLocation(String provider): Location// Content Provider에 대해 별도의 읽기 및 쓰기 권한을 요구하는 예
@RequiresPermission.Read(
@RequiresPermission(READ_HISTORY_BOOKMARKS)
) @RequiresPermission.Write(
@RequiresPermission(WRITE_HISTORY_BOOKMARKS)
)
const val BOOKMARKS_URI = Uri.parse("content://browser/bookmarks")// 매개 변수에 지정된 경우 어노테이션은 메소드에 매개 변수 값에 따른 권한이 필요함을
// 나타냅니다.
fun startActivity(@RequiresPermission intent: Intent) { ... }
@RestrictTo: 해당 요소는 특정 범위 내에서만 액세스해야 함을 나타냅니다(Scope)
// 라이브러리 내 사용 제한 예(Group Id)
@RestrictTo(GROUP_ID)
fun resetPaddingToInitialValues() { ... }// 테스트에서만 사용 제한 예
@RestrictScope(TESTS)
abstract fun getUserId(): Int// 서브 클래시에서만 사용을 제한하는 예
@RestrictScope(SUBCLASSES)
fun onDrawForeground(canvas: Canvas) { ... }
@VisibleForTesting: 선택적으로 가시성을 지정할 수 있습니다. 기본적으로 테스팅 용으로만 공개될 수 있게 지정됩니다.
@VisibleForTesting(otherwise = VisibleForTesting.PROTECTED)
fun printDiagnostics(): String { ... }// NONE -> 인자가 없을 시 기본 지정. 해당 요소는 테스트에서만 호출되어야 합니다.
// PACKAGE_PRIVATE -> 패키지 비공개 가시성을 갖습니다.
// PRIVATE
// PROTECTED
@ColorInt: 패킹된 색상 int를 나타냄을 의미합니다.@Dimension: 변수, 필드 또는 메소드의 반환 값이 dimension을 나타낼 것으로 예상됨을 나타냅니다.unit인수로 DP(0), PX(1), SP(2)를 지정할 수 있습니다.@Px: 변수, 필드 또는 메소드의 반환 값이 pixel dimension임을 나타냅니다.@FloatRange, @IntRange: 각각 주어진 범위에서 float 또는 double, int이어야 함을 나타냅니다.
@FloatRange(from=0.0, to=1.0)
fun getAlpha(): Float { ... }@Size: 어노테이션이 연결된 요소가 주어진 크기 또는 길이를 가져야 함을 나타냅니다. -1은 설정되지 않음을 의미합니다.
fun getLocationInWindow(@Size(2) location: IntArray) { ... }Size(value: Long, min: Long, max: Long, multiple: Long)
// value -> 정확한 크기 지정
// min -> 최소 크기
// max -> 최대 크기
// multiple -> 해당 인자의 배수 크기
이상으로 다양한 안드로이드의 어노테이션에 대해 알아보았습니다.
