Annotations 3

android-apt plugin
What is this?
android-apt 플러그인은 안드로이드 스튜디오에서 annotation processors의 보조 도구로 볼 수 있습니다.두 가지 기능이 있습니다.

annotationprocessor는 컴파일기에만 의존하고 마지막 apk나library에 포함되지 않습니다

annotationprocessor에서 생성된 것입니다.java 파일에서 source paths를 설정하여 안드로이드 Studio에서 제대로 참조될 수 있도록 합니다

.
Including and using the plugin in build script
프로젝트 build을 설정합니다.gradle

buildscript {
    repositories {
      mavenCentral()
    }
    dependencies {
        // replace with the current version of the Android plugin
        classpath 'com.android.tools.build:gradle:1.3.0'
        // the latest version of the android-apt plugin
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
    }
}

apply plugin: 'com.android.application'
apply plugin: 'com.neenbedankt.android-apt'

Passing processor arguments
일부 주석 프로세서는 사용자 정의 파라미터를 전달해야 하는데, 이것은 apt.arguments를 사용합니다.예를 들어 AndroidAnnotation은 다음과 같이 구성할 수 있습니다.

apt {
    arguments {
            resourcePackageName android.defaultConfig.applicationId
            androidManifestFile variant.outputs[0]?.processResources?.manifestFile
    }
}

Android Annotations는 Android Manifest를 알아야 합니다.xml 위치입니다.variant를 검색하여 서로 다른 flavor에 서로 다른 안드로이드 Manifest를 설정합니다.xml.그러나 모든variants(예를 들어 unit tests)가 대응하는 속성이 있는 것은 아니기 때문에groovy의?조작부호가 안전성을 확보합니다.

def getManifestByVariant(variant) {
    // return the value based on the variant
    if (variant.name == 'release') {
        return '/my/path/to/the/manifest.xml'
    }
    return variant.outputs[0]?.processResources?.manifestFile
}

apt {
     arguments {
         if (variant.name == 'debug') {
            resourcePackageName "com.myapp.package.name.debug"
            // more options
         }             
         androidManifestFile project.getManifestByVariant(variant)             
     }
}

Comfiguration a compiler style dependency
Annotations processors는 일반적으로 API와 processor 두 부분을 포함하는데, processor가 생성한 코드는 API에 의해 사용된다.일부 항목의 서로 다른 의존 작용의 시간 범위는 다르다. 예를 들어Dagger는 두 개의artifacts가 있는데 각각dagger-compiler와dagger이다.dagger-compiler는 컴파일기에만 작용하고dagger는 운행할 때에만 작용한다.이러한 의존 관계를 구성하면 다음과 같이 플러그인에 apt configuration이 추가됩니다.

dependencies {
 apt 'com.squareup.dagger:dagger-compiler:1.1.0'
 compile 'com.squareup.dagger:dagger:1.1.0'
}

instrumentation test code의 경우 processor에서 생성한 code가 필요합니다.androidTestapt configuration:

dependencies {
 androidTestApt 'com.github.frankiesardo:android-auto-value-processor:0.1'
 androidTestCompile 'com.github.frankiesardo:android-auto-value:0.1'
}

Additional configuration
javac의 기본 발견 메커니즘을 차단하고 컴파일러가 지정한 프로세스를 설정할 수 있습니다. 구체적인 동작은 다음과 같습니다.

apt {
    processor "my.class.name"
    processor "another.processor.class.name"
    // if you only want to run the processors above
    disableDiscovery true
}

Configuration of other annotation processor
프로세스와 API가 같은artifact를 사용한다면 특별한 설정이 필요하지 않습니다.compile 핸들로 추가하면 됩니다.또한 프로세스가 생성한 코드가 프로젝트에서 인용되면android스튜디오는reference 문제를 정확하게 해결할 수 있습니다.
annotationProcessor
Android Gradle plugin 2.2 버전은 apt 플러그인 기능을 지원하지만, 제한이 있습니다. 즉, Jack을 켜야 하며, Hugo는 Migration 방안도 제공합니다. 이 글을 참고하십시오.
Sample
AptDemo