Android註解使用之註解編譯android-apt如何切換到annotationProcessor

前言：

    自從EventBus 3.x發佈以後其經過註解預編譯的方式解決了以前經過反射機制所引發的性能效率問題，其中註解預編譯所採用的的就是android-apt的方式，不過最近Apt工具的做者宣佈了再也不維護該工具了，由於Android Studio推出了官方插件，而且能夠經過gradle來簡單的配置，它就是annotationProcessor，今天來學習一下如何將原來的android-apt切換到annotationProcessor。

什麼是APT？

   APT(Annotation Processing Tool)是一種處理註釋的工具,它對源代碼文件進行檢測找出其中的Annotation，使用Annotation進行額外的處理。 Annotation處理器在處理Annotation時能夠根據源文件中的Annotation生成額外的源文件和其它的文件(文件具體內容由Annotation處理器的編寫者決定),APT還會編譯生成的源文件和原來的源文件，將它們一塊兒生成class文件。

使用背景：

  隨着Android Gradle 插件 2.2 版本的發佈，Android Gradle 插件提供了名爲 annotationProcessor  的功能來徹底代替  android-apt ，自此android-apt  做者在官網發表聲明證明了後續將不會繼續維護  android-apt ，並推薦你們使用 Android 官方插件annotationProcessor。

切換步驟：

首先要確保Android Gradle插件版本是2.2以上，目前咱們所使用的Android studio版本是2.2.3，所對應的的Android Gradle版本也是2.2.3

1.）修改Project 的build.gradle配置

android-apt方式

  dependencies {
        classpath 'com.android.tools.build:gradle:2.2.3'
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
    }

修改後annotationProcessor  方式

  dependencies {
        classpath 'com.android.tools.build:gradle:2.2.3'
    }

2.）修改module的build.gradle配置

android-apt方式

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
    }
}
apply plugin: 'com.neenbedankt.android-apt'
dependencies {
    compile 'org.greenrobot:eventbus:3.0.0'
    apt'org.greenrobot:eventbus-annotation-processor:3.0.1'//apt
}

修改後annotationProcessor  方式，只保留dependencies 裏面的引用而且把apt 換成annotationProcessor就能夠了

dependencies {
    compile 'org.greenrobot:eventbus:3.0.0'
    annotationProcessor  'org.greenrobot:eventbus-annotation-processor:3.0.1'
}

3.）對EventBus 3.0 使用索引的兼容

android-apt方式

apt  {
    arguments {
        eventBusIndex "org.greenrobot.eventbusperf.MyEventBusIndex"
    }
}

修改後annotationProcessor  方式

defaultConfig {
        applicationId "com.whoislcj.testhttp"
        minSdkVersion 21
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"
        jackOptions {
            enabled true
        }
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [ eventBusIndex : 'org.greenrobot.eventbusperf.MyEventBusIndex' ]
            }
        }
    }

二者對比

   最近Android N的發佈，android 迎來了Java 8，要想使用Java 8的話必須使用Jack編譯，android-apt只支持javac編譯而annotationProcessor既支持javac同時也支持jack編譯。

總結：

   今天只是簡單的學習了從android-apt如何很好的切換到annotationProcessor，接下來將用annotationProcessor實戰一下本身實現相似Butterknife註解框架。