support library 22.2.0 Annotations takahirom

ࣗ෼ʹ͍ͭͯ • takahirom(@new_runnable) ! • ॳϙςνLTͰ͢ • ༏͍ͯͩ͘͘͠͠͞

Support Annotations Google I/O What’s New in Android Development Tools - 13ݸͷ৽͍͠Ξϊςʔγϣϯͷ௥Ճ

Support Annotations compile 'com.android.support:support-annotations:22.2.0' !

Support Annotations ͖ͬͱ͋ͳͨͷϓϩδΣΫτʹ΋ɺɺ ! ./gradlew app:dependencies +--- com.android.support:appcompat-v7:22.2.0 | \--- com.android.support:support-v4:22.2.0 | \--- com.android.support:support-annotations:22.2.0

ΞϊςʔγϣϯҰཡ @WorkerThread
 @UiThread @MainThread @BinderThread
 Thread @CallSuper @CheckResult @RequiresPermission @Keep @VisibleForTesting Ҿ਺νΣοΫ @Size
 @IntRange @FloatRange @ColorInt ϝιου

Thread Annotations • @WorkerThread • @UiThread • @MainThread • @BinderThread

ྫ:@WorkerThread

Ҿ਺νΣοΫ • @Size จࣈྻ΍഑ྻͷ௕͞ͷ࠷େ஋ ࠷খ஋ͳͲΛઃఆ ߹க ͠ͳ͍ͳΒܯࠂ • @IntRange ਺ࣈͷൣғ ൣғ֎ͳΒܯࠂ • @FloatRange float൛ • @ColorInt ৭ͷintͰͳ͚Ε͹ܯࠂ

ྫ:@Size

ϝιου • @CallSuper superϝιουΛݺͼग़͍ͯ͠ͳ͍ͱܯࠂ • @CheckResult ϝιουͷฦΓ஋Λ࢖͍ͬͯͳ͍ͱܯࠂ • @RequiresPermission ඞཁͳύʔϛογϣϯ͕ͳ͍ͱܯࠂ • @Keep ProGuard͕͚͍ͭͯΔϝιουͰແޮʹͳΔ(ࠓ ͸ಈ͔ͳ͍ʁ) • @VisibleForTesting TestͰ࢖͏ϝιου͔ͩΒpublicͳͲ ʹ͍ͯ͠Δͱ͍͏දࣔ

ඪ४ϝιουͷΞϊςʔγϣϯ • Ͳͷϝιου΍ΫϥεʹΞϊςʔγϣϯ͕෇͍͍ͯΔ͔Θ͔ Δ • https://android.googlesource.com/platform/tools/adt/ idea/+/master/android/annotations/android/ ! 
 
 


@MainThread͕Α͘෼͔Βͳ͍

Android Studio಺ͷThreadνΣοΫ

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } checkThreadAnnotation private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } ifจͷத͕࣮ߦ͞ΕΔͱܯࠂ͕දࣔ͞Ε·͢

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } checkThreadAnnotation private static void ProblemsHolder holder String threadContext = getThreadContext(methodCall) if String message = String.format( thread, currently inferred thread is %3$s" describeThread(threadContext)) } } ifจͷத͕࣮ߦ͞ΕΔͱܯࠂ͕දࣔ͞Ε·͢

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } checkThreadAnnotation private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } https://android.googlesource.com/platform/tools/adt/idea/+/master/android/src/org/jetbrains/android/ inspections/ResourceTypeInspection.java ͳͷͰ৚݅จΛݟͯߦ͖·͠ΐ͏

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } checkThreadAnnotation private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 thread, currently inferred thread is %3$s" describeThread(threadContext)) } } https://android.googlesource.com/platform/tools/adt/idea/+/master/android/src/org/jetbrains/android/ inspections/ResourceTypeInspection.java ͳͷͰ৚݅จΛݟͯߦ͖·͠ΐ͏

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } isCompatibleThread private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } isCompatibleThreadͱ͍͏ϝιουͰνΣοΫ͍ͯ͠ΔΑ͏Ͱ͢

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } isCompatibleThread private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) { String threadContext = getThreadContext(methodCall) if thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } isCompatibleThreadͱ͍͏ϝιουͰνΣοΫ͍ͯ͠ΔΑ͏Ͱ͢

isCompatibleThread public static boolean isCompatibleThread(@NonNull String thread1, @NonNull String thread2) {
 if (thread1.equals(thread2)) {
 return true;
 }
 // Allow @UiThread and @MainThread to be combined
 if (thread1.equals(UI_THREAD_ANNOTATION)) {
 if (thread2.equals(MAIN_THREAD_ANNOTATION)) {
 return true;
 }
 } else if (thread1.equals(MAIN_THREAD_ANNOTATION)) {
 if (thread2.equals(UI_THREAD_ANNOTATION)) {
 return true;
 }
 }
 return false;
 } thread1΍thread2ʹ͸MainThreadͳͲͷจࣈྻ͕ೖ͍ͬͯ·͢

isCompatibleThread public static boolean isCompatibleThread(@NonNull String thread1, @NonNull String thread2) {
 if (thread1.equals(thread2)) {
 return true;
 }
 // Allow @UiThread and @MainThread to be combined
 if (thread1.equals(UI_THREAD_ANNOTATION)) {
 if (thread2.equals(MAIN_THREAD_ANNOTATION)) {
 return true;
 }
 } else if (thread1.equals(MAIN_THREAD_ANNOTATION)) {
 if (thread2.equals(UI_THREAD_ANNOTATION)) {
 return true;
 }
 }
 return false;
 } ಉ͡ͳΒ͹͙͢ʹtrueΛฦ͠·͢

isCompatibleThread public static boolean isCompatibleThread(@NonNull String thread1, @NonNull String thread2) {
 if (thread1.equals(thread2)) {
 return true;
 }
 // Allow @UiThread and @MainThread to be combined
 if (thread1.equals(UI_THREAD_ANNOTATION)) {
 if (thread2.equals(MAIN_THREAD_ANNOTATION)) {
 return true;
 }
 } else if (thread1.equals(MAIN_THREAD_ANNOTATION)) {
 if (thread2.equals(UI_THREAD_ANNOTATION)) {
 return true;
 }
 }
 return false;
 } MainThreadͱUIThread͸ಉ͡ѻ͍Λ͠ɺଞ͸ҟͳΔͷͰfalseΛฦ͠·͢

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } getThreadContext private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } ࣍ʹgetThreadContextͰͲͷThreadͰ࣮ߦ͍ͯ͠Δ͔ͷ൑ఆΛݟͯߦ͖·͠ΐ͏

private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } getThreadContext private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) { String threadContext = getThreadContext(methodCall) if thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } ࣍ʹgetThreadContextͰͲͷThreadͰ࣮ߦ͍ͯ͠Δ͔ͷ൑ఆΛݟͯߦ͖·͠ΐ͏

@Nullable
 private static String getThreadContext(PsiCallExpression methodCall) {
 PsiMethod method = PsiTreeUtil.getParentOfType(methodCall, PsiMethod.class, true);
 if (method != null) {
 PsiAnnotation[] annotations = getAllAnnotations(method);
 for (PsiAnnotation annotation : annotations) {
 String qualifiedName = annotation.getQualifiedName();
 if (qualifiedName == null) {
 continue;
 }
 
 if (qualifiedName.startsWith(SUPPORT_ANNOTATIONS_PREFIX) && qualifiedName.endsWith(THREAD_SUFFIX)) {
 return qualifiedName;
 }
 } …….
 } getThreadContext (1/2) @Nullable
 private static String getThreadContext(PsiCallExpression methodCall) {
 PsiMethod method = PsiTreeUtil.getParentOfType(methodCall, PsiMethod.class, true);
 if (method != null) {
 PsiAnnotation[] annotations = getAllAnnotations(method);
 for (PsiAnnotation annotation : annotations) {
 String qualifiedName = annotation.getQualifiedName();
 if (qualifiedName == null) {
 continue;
 }
 
 if (qualifiedName.startsWith(SUPPORT_ANNOTATIONS_PREFIX) && qualifiedName.endsWith(THREAD_SUFFIX)) {
 return qualifiedName;
 }
 } …….
 } ϝιουʹ͍͍ͭͯΔΞϊςʔγϣϯΛऔಘͯͦ͠ΕΛฦ͠·͢

@Nullable
 private static String getThreadContext(PsiCallExpression methodCall) {
 PsiMethod method = PsiTreeUtil.getParentOfType(methodCall, PsiMethod.class, true);
 if (method != null) {
 PsiAnnotation[] annotations = getAllAnnotations(method);
 for (PsiAnnotation annotation : annotations) {
 String qualifiedName = annotation.getQualifiedName();
 if (qualifiedName == null) {
 continue;
 }
 
 if (qualifiedName.startsWith(SUPPORT_ANNOTATIONS_PREFIX) && qualifiedName.endsWith(THREAD_SUFFIX)) {
 return qualifiedName;
 }
 } …….
 } getThreadContext (1/2) @Nullable
 private static PsiMethod method = PsiTreeUtil.getParentOfType(methodCall if PsiAnnotation[] annotations = getAllAnnotations(method) for String qualifiedName = annotation.getQualifiedName() if 
 } ……. } ϝιουʹ͍͍ͭͯΔΞϊςʔγϣϯΛऔಘͯͦ͠ΕΛฦ͠·͢

@Nullable
 private static String getThreadContext(PsiCallExpression methodCall) {
 PsiMethod method = PsiTreeUtil.getParentOfType(methodCall, PsiMethod.class, true);
 if (method != null) {
 ……
 // See if we're extending a class with a known threading context
 PsiClass cls = method.getContainingClass();
 if (cls != null) {
 annotations = getAllAnnotations(cls);
 for (PsiAnnotation annotation : annotations) {
 String qualifiedName = annotation.getQualifiedName();
 if (qualifiedName == null) {
 continue;
 }
 
 if (qualifiedName.startsWith(SUPPORT_ANNOTATIONS_PREFIX) && qualifiedName.endsWith(THREAD_SUFFIX)) {
 return qualifiedName;
 }
 }
 }
 } getThreadContext (2/2) @Nullable
 private static String getThreadContext(PsiCallExpression methodCall) {
 PsiMethod method = PsiTreeUtil.getParentOfType(methodCall, PsiMethod.class, true);
 if (method != null) {
 ……
 // See if we're extending a class with a known threading context
 PsiClass cls = method.getContainingClass();
 if (cls != null) {
 annotations = getAllAnnotations(cls);
 for (PsiAnnotation annotation : annotations) {
 String qualifiedName = annotation.getQualifiedName();
 if (qualifiedName == null) {
 continue;
 }
 
 if (qualifiedName.startsWith(SUPPORT_ANNOTATIONS_PREFIX) && qualifiedName.endsWith(THREAD_SUFFIX)) {
 return qualifiedName;
 }
 }
 }
 } ͦΕ͚ͩͰͳ͘ɺΫϥεʹ͍͍ͭͯΔΞϊςʔγϣϯΛऔಘ͠·͢

@Nullable
 private static String getThreadContext(PsiCallExpression methodCall) {
 PsiMethod method = PsiTreeUtil.getParentOfType(methodCall, PsiMethod.class, true);
 if (method != null) {
 ……
 // See if we're extending a class with a known threading context
 PsiClass cls = method.getContainingClass();
 if (cls != null) {
 annotations = getAllAnnotations(cls);
 for (PsiAnnotation annotation : annotations) {
 String qualifiedName = annotation.getQualifiedName();
 if (qualifiedName == null) {
 continue;
 }
 
 if (qualifiedName.startsWith(SUPPORT_ANNOTATIONS_PREFIX) && qualifiedName.endsWith(THREAD_SUFFIX)) {
 return qualifiedName;
 }
 }
 }
 } getThreadContext (2/2) @Nullable
 private static PsiMethod method = PsiTreeUtil.getParentOfType(methodCall if ……
 // See if we're extending a class with a known threading context
 PsiClass cls = method.getContainingClass() if annotations = getAllAnnotations(cls) for String qualifiedName = annotation.getQualifiedName() if 
 }
 }
 } ͦΕ͚ͩͰͳ͘ɺΫϥεʹ͍͍ͭͯΔΞϊςʔγϣϯΛऔಘ͠·͢

getThreadContext private static void checkThreadAnnotation(PsiCallExpression methodCall, ProblemsHolder holder, PsiMethod method, String qualifiedName) {
 String threadContext = getThreadContext(methodCall);
 if (threadContext != null && !isCompatibleThread(threadContext, qualifiedName)) {
 String message = String.format("Method %1$s must be called from the %2$s thread, currently inferred thread is %3$s",
 method.getName(), describeThread(qualifiedName), describeThread(threadContext));
 holder.registerProblem(methodCall, message);
 } } ͭ·Γݺͼग़͠ݩͷϝιουͱΫϥεͷΞϊςʔγϣϯΛݟ͍ͯ·͢

@WorkerThreadΛ͚ͭΕ͹OK

AnnotationͷϧʔϧΛڧ੍͢Δ rootͷbuild.gradleͰ ! classpath 'com.android.tools.build:gradle:1.2.3' ↓ classpath 'com.android.tools.build:gradle:1.3.0-beta1' !

AnnotationͷϧʔϧΛڧ੍͢Δ ./gradlew lint ! :app:lint FAILED ! FAILURE: Build failed with an exception. ! * What went wrong: Execution failed for task ':app:lint'. > Lint found errors in the project; aborting build.

·ͱΊ • ґଘؔ܎Ͱೖͬͯ͘ΔͷͰҙࣝͤͣ؆୯ʹ࢖͑Δ • Android StudioͷதΛ೷͚͹ͳΜͰܯࠂ͕ग़ͳ͍͔෼͔Δ(ͦ͜· Ͱݡ͘ͳ͍) • AnnotationͰઃఆͨ͠ϧʔϧΛڧ੍Ͱ͖Δ • ݁ߏ࠷ۙίʔυ͕มΘ͍͍ͬͯͬͯΔͷͰɺ͜Ε͔Βݡ͘ͳΔ͔ ΋ʁ • (ࣗ෼Ͱ΋ਅࣅͯ͠ϓϥάΠϯͱͯ͠ಉ͡Α͏ͳ΋ͷ͕࡞ΕΔ)

Hungarian Inspection Plugin

Thanks w "OESPJE5PPMT1SPKFDU4JUF w IUUQUPPMTBOESPJEDPNUFDIEPDTTVQQPSUBOOPUBUJPOT ! w "OESPJE0QFO4PVSDF1SPKFDU w IUUQTBOESPJEHPPHMFTPVSDFDPNQMBUGPSNUPPMTBEUJEFB w IUUQTBOESPJEHPPHMFTPVSDFDPNQMBUGPSNUPPMTCBTF ! w 5IF$POGFSFODF4QFBLFS*OWFTUNFOU w IUUQKBLFXIBSUPODPNUIFDPOGFSFODFTQFBLFSJOWFTUNFOU

͋Γ͕ͱ͏͍͟͝·ͨ͠ʂ