前言

什么是Apt

APT從原理上講是一個(gè)編譯期的注解處理工具（Annotation Processing Tool）。一些主流的三方庫(kù)（ButterKnife，Glide）都用到了這個(gè)技術(shù)來(lái)生成代碼。

Apt有什么好處

1. 自動(dòng)生成模板代碼，提高了開(kāi)發(fā)效率
2. 編譯期對(duì)注解的處理，相對(duì)于運(yùn)行期對(duì)注解的處理，性能上要好的多。

Gradle腳本中的apt和annotationProcessor

這兩個(gè)從廣義上說(shuō)都是編譯期的注解處理工具。只不過(guò)android-apt(其實(shí)是一個(gè)gradle插件，apt是插件命令)是早期的github的一個(gè)開(kāi)源項(xiàng)目，annotationProcessor是gradle build tools 2.2之后自帶的編譯期注解工具（官方支持的，可替代開(kāi)源的gradle插件android-apt）。android-apt的作者已經(jīng)發(fā)表聲明表示Android Studio插件已經(jīng)支持annotationProcessor，并且會(huì)警告和阻止使用android-apt。總的來(lái)說(shuō)，看你的gradle build tools的版本，低版本用android-apt(需要引入插件)，高版本用annotationProcessor(無(wú)需引入插件)

代碼設(shè)計(jì)

需求分析

這里將route模塊分成三部分（一個(gè)android library，兩個(gè)java library）
1、router-annotation（java library）

這里java工程里面只放注解的聲明類。這里只實(shí)現(xiàn)了兩個(gè)注解RouterActivity、RouterField。

2、router-compiler （java library）

這個(gè)工程是編譯期依賴的工程，作用是編譯期掃描代碼，根據(jù)RouterActivity、RouterField這兩個(gè)注解的使用，生成相關(guān)代碼。這里需要講下如何掃描代碼并且生成代碼的。這部分功能的實(shí)現(xiàn)主要依賴兩個(gè)庫(kù)：Google的auto-service（掃描代碼），Squareup的javapoet（生成代碼）

3、router (android library)

主要邏輯代碼。在這個(gè)模塊中會(huì)定義一些功能類和接口。router-compiler模塊可以根據(jù)這些接口和功能類generate邏輯代碼。需要注意的是router-compiler是不需要依賴router的，router-compiler是根據(jù)包名+類名的方式獲取類的。

代碼實(shí)現(xiàn)

router-annotation

RouterActivity是一個(gè)注解，用此注解修飾的Activity根據(jù)指定的路由地址，會(huì)自動(dòng)添加到路由表中，當(dāng)系統(tǒng)掛載了路由表之后，就可根據(jù)指定的路由地址來(lái)訪問(wèn)特定的Activity了。代碼如下：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface RouterActivity {
  String[] value();
}

這里Activity可用多個(gè)路由地址修改。

RouterField是一個(gè)用于表示Activity跳轉(zhuǎn)時(shí)參數(shù)傳遞的注解，用這個(gè)注解修飾的成員變量，表示為接收Intent參數(shù)的變量。

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface RouterField {
  String[] value();
}

router-compiler

這個(gè)模塊只包含一個(gè)類RouterProcessor，這個(gè)類的大致結(jié)構(gòu)如下:

//此處用AutoService注解，就可實(shí)現(xiàn)編譯期自動(dòng)掃描代碼
@AutoService(Processor.class)
public class RouterProcessor extends AbstractProcessor{
  private Elements elementUtils;
  private String targetModuleName = "";
  @Override
  public Set<String> getSupportedAnnotationTypes() {
    //支持的注解類型
    return Collections.singleton(RouterActivity.class.getCanonicalName());
  }

  @Override
  public boolean process(Set<? extends TypeElement> set, RoundEnvironment roundEnvironment) {
   //處理代碼掃描結(jié)果的關(guān)鍵函數(shù)
   ...
    return true;
  }

  @Override
  public synchronized void init(ProcessingEnvironment processingEnvironment) {
    super.init(processingEnvironment);
    //在掃描代碼之前可從build.gradle中讀取一些配置項(xiàng)
  }

  @Override
  public SourceVersion getSupportedSourceVersion() {
    //表示支持的Jdk版本
    return SourceVersion.RELEASE_7;
  }
}

下面分別講解一下函數(shù)的實(shí)現(xiàn)：

1、init函數(shù)

我們的項(xiàng)目大多都是多module的形式，這時(shí)候我們就需要為每個(gè)module創(chuàng)建一個(gè)Activity路由注冊(cè)表，然后在Application初始化的時(shí)候?qū)⑺械穆酚勺?cè)表掛載上，達(dá)到Activity路由跳轉(zhuǎn)的目的。這里我們?cè)趇nit函數(shù)中，配置每個(gè)模塊路由表的前綴名稱。

 @Override
  public synchronized void init(ProcessingEnvironment processingEnvironment) {
    super.init(processingEnvironment);
    elementUtils = processingEnvironment.getElementUtils();
    Map<String, String> map = processingEnvironment.getOptions();
    Set<String> keys = map.keySet();
    for (String key: keys) {
      if ("targetModuleName".equals(key)) {
        this.targetModuleName = map.get(key);
      }
      System.out.println(key + " + " + map.get(key));

并在module的build.gradle文件下配置如下代碼：

apt {
  arguments {
    targetModuleName 'moduleName'
  }
}

2、process函數(shù)

這個(gè)函數(shù)的大致流程如下：找到所有被RouterActivity修飾的Activity；實(shí)現(xiàn)router模塊中的RouterInitializer接口，將每個(gè)Activity的路由地址加入路由表中；同時(shí)為每個(gè)Activity創(chuàng)建一個(gè)XXXActivityHelper（用于更友好的Activity調(diào)整），并將每個(gè)XXXAcitivyHelper放入RouterHelper中，提供get方法獲取。process函數(shù)的具體實(shí)現(xiàn)，可詳見(jiàn)項(xiàng)目源碼（都是一些代碼生成的語(yǔ)句，沒(méi)有多少邏輯）。

router

1. RouterInitializer接口，用于每個(gè)module注冊(cè)表的實(shí)現(xiàn)
2. ActivityHelper，封裝了一些參數(shù)解析邏輯，更方便的Activity跳轉(zhuǎn)
3. SafeBundle, 對(duì)Activity的參數(shù)進(jìn)行了封裝
4. Router, 路由核心類，支持url跳轉(zhuǎn)，解析url，并實(shí)現(xiàn)跳轉(zhuǎn)。
5. 'RouterCenterActivity', 可被外部瀏覽器喚起的中轉(zhuǎn)Activity（外面根據(jù)url scheme喚醒RouterCenterActivity，RouterCenterActivity分發(fā)路由地址）

代碼使用

初始化Router

public class DemoApp extends Application {

  @Override
  public void onCreate() {
    super.onCreate();
    Router.init("demo"); //自定義scheme協(xié)議
  }
}

Activity跳轉(zhuǎn)

@RouterActivity({"main"})
public class MainActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    findViewById(R.id.btn_second).setOnClickListener(new View.OnClickListener() {
      @Override
      public void onClick(View v) {
        RouterHelper.getSecondActivityHelper().start(MainActivity.this);
      }
    });
  }
}

@RouterActivity({"second"})
public class SecondActivity extends AppCompatActivity {
  @Override
  protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_second);
  }
}

build目錄生成的代碼如下：

詳細(xì)代碼可查看：Github項(xiàng)目。

現(xiàn)階段代碼還不完善，后期會(huì)添加更多功能。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論