筆者注：AA-4.0為AndroidAnnotations-4.0的簡(jiǎn)稱

AA4.0已經(jīng)模塊化了

現(xiàn)在AA-4.0的庫(kù)被分割為一些小的模塊，這意味著你以前在AA-3.x版本之前庫(kù)中使用的一些注解方法都被分拆為一些單獨(dú)的模塊，你需要在Gradle配置文件中添加新的依賴庫(kù)，改變import的包名。

@OrmLiteDao

以@OrmLiteDao的注解使用為例，在引入AA-4.0后，如果你的項(xiàng)目中有用到@OrmLiteDao，那么你需要在app的build.gradle項(xiàng)目依賴中添加下文件：

compile "org.androidannotations:ormlite-api:4.0.0"
apt  "org.androidannotations:ormlite:4.0.0"

修改import的包名：

org.androidannotations.ormlite.annotations.OrmLiteDao

Otto

將Otto庫(kù)整合到AA-4.0中配置如下：

1. 添加AA-4.0到工程；
2. 添加Otto庫(kù)的插件：
   dependencies {
   apt "org.androidannotations:otto:$AAVersion"
   compile "org.androidannotations:otto-api:$AAVersion"
   }
3. 添加Otto庫(kù)依賴
   dependencies { compile 'com.squareup:otto:1.3.8'}

Rest Client

如果項(xiàng)目中使用Rest Client ，需要在build.gradle中添加配置依賴庫(kù)：

     dependencies { 
        apt "org.androidannotations:rest-spring-api:$AAVersion" 
        compile "org.androidannotations:rest-spring:$AAVersion"
    } 

更改導(dǎo)入的包名:

org.androidannotations.rest.spring.annotations.Rest //etc
org.androidannotations.rest.spring.api.RestClientHeaders // etc

@RoboGuice

使用 @RoboGuice
, 在項(xiàng)目的build.gradle中添加依賴：

  compile "org.androidannotations:roboguice-api:4.0.0"
  apt "org.androidannotations:roboguice:4.0.0"

修改 imports :

org.androidannotations.roboguice.annotations.RoboGuice

在Fragment中注解的View對(duì)象會(huì)被清理

在AA-4.0中對(duì)在Fragment中使用@ViewById和@ViewsById的View對(duì)象會(huì)在Fragment的聲明周期onDestoryView()時(shí)設(shè)為null，如果程序執(zhí)行了Fragment的聲明周期事件onDestoryView()后，仍然訪問(wèn)該View，則會(huì)得到NullPointerExceptions異常，為了避免發(fā)生這種情況，可以使用新的注解@IgnoreWhen，如下：

  //當(dāng)前狀態(tài)為DESTORYED，則忽略此方法，不調(diào)用
  @IgnoreWhen(IgnoreWhen.State.VIEW_DESTROYED)
  void someMethodCalledAfterViewDestroyed() { 
      injectedView.setText("Hello"); 
  }

自AA-4.0不再支持2.3.1以下的Android設(shè)備

現(xiàn)在市面上的Android設(shè)備已經(jīng)都是4.0及以上了，2.3的設(shè)備都比較少，所以不支持2.3.1以下的安卓設(shè)備也沒(méi)啥影響。

編譯運(yùn)行最小支持 JDK7不再支持JDK 6

AA-4.0不再支持JDK 6的編譯，不過(guò)你依然可以使用JDK 6的源碼來(lái)編譯。話說(shuō)現(xiàn)在的環(huán)境都支持JDK8了，到時(shí)候在build.gradle的android{}DSL域中配置編譯選項(xiàng)即可。

  //java版本
  compileOptions {    
      sourceCompatibility JavaVersion.VERSION_1_7    
      targetCompatibility JavaVersion.VERSION_1_7
  }

@ReceiverAction 修改

在AA-3.x版本及以前，如果使用@ReceiverAction沒(méi)有指定Action的值，則會(huì)將方法名作為Action，從AA-4.0開(kāi)始不再支持這種方式，必須在注解中指定Action的值。
實(shí)例說(shuō)明：

  @ReceiverAction
  public void simpleAction() { // AA 3.x, action = "simpleAction"
  }

  @ReceiverAction(actions = "simpleAction")
  public void simpleAction() { // AA 4.0.0
  }

去掉了 @OrmLiteDao 注解的model參數(shù)

雖然在AA-4.0中移除了model的參數(shù)配置選項(xiàng)，不過(guò)在編譯期間，會(huì)自動(dòng)根據(jù)Dao類判斷model的值，減少了冗余。
實(shí)例說(shuō)明：

@OrmLiteDao(helper = DatabaseHelper.class, model = Car.class) // AA 3.x
Dao<Car, Long> injectedDao;

@OrmLiteDao(helper = DatabaseHelper.class) // AA 4.0.0
Dao<Car, Long> injectedDao;

去掉了 @NoTitle 注解

可能是為了代碼規(guī)范，在AA-4.0中去掉了@NoTitle注解，可以通過(guò)@WindowFeature注解來(lái)實(shí)現(xiàn)同樣的功能(不顯示標(biāo)題)

  @NoTitle // AA 3.x
  @EActivity
  public class MyActivity extends Activity {
  }
  
  @WindowFeature(Window.FEATURE_NO_TITLE) // AA 4.0.0
  @EActivitypublic class MyActivity extends Activity {
  }

不再支持ActionBarSherlock

由于Android官方的AppCompat比ActionBarSherlock要好，而且ActionBarSherlock這個(gè)項(xiàng)目也不再維護(hù)，所以AA-4.0也不再提供對(duì)ActionBarSherlock的支持。在項(xiàng)目中可以使用 AppCompat Support Library來(lái)替代ActionBarSherlock。

PS：現(xiàn)在應(yīng)該沒(méi)有人用ActionBarSherlock這么古老的庫(kù)了吧~

@Extra 和 @AfterExtras 的變動(dòng)

在AA-4.0中，不會(huì)再在onNewIntent()方法中調(diào)用setIntent()方法。這個(gè)對(duì)于3.x的用戶基本上沒(méi)影響。

在@Rest 方法中所有的參數(shù)都需要添加注解

對(duì)于以前項(xiàng)目使用AA-3.x的，這個(gè)改動(dòng)有點(diǎn)小大，得改不少關(guān)于Rest Client的代碼，從AA-4.0開(kāi)始你必須明確的告訴編譯處理器每個(gè)Rest請(qǐng)求方法中的參數(shù)代表的意思。
使用@Body注解指明請(qǐng)求的body類型：

 @Rest(converters = GsonHttpMessageConverter.class)
 public interface MyRestClient { 
    @Put 
    void putEvent(Event event); // AA 3.x request body is the event variable  
  }

  @Rest(converters = GsonHttpMessageConverter.class)
  public interface MyRestClient { 
    @Put 
    void putEvent(@Body Event event); // AA 4.0.0
  }

使用@Path指明url中的參數(shù):

  @Rest(converters = GsonHttpMessageConverter.class)
  public interface MyRestClient { 
      @Get("/events/{id}" 
      Event getEvent(int id); // AA 3.x the id method param is an url variable
  }

  @Rest(converters = GsonHttpMessageConverter.class)
  public interface MyRestClient { 
      @Get("/events/{id}" 
      Event getEvent(@Path int id); // AA 4.0.0
  }

總體來(lái)說(shuō)，AA-4.0中關(guān)于@Rest這塊的注解方法，有很多借鑒了Retrofit。這是一個(gè)不錯(cuò)的開(kāi)端，后續(xù)版本可能回減少對(duì)于SpringAndroid的項(xiàng)目庫(kù)的依賴。逐漸的形成一種插件化的網(wǎng)絡(luò)請(qǐng)求注解庫(kù)。

END

本文大部分內(nèi)容參考AA 4.0 migration guide ，此次的AA-4.0版本是一次重大更新，很明顯的改變就是將之前一個(gè)庫(kù)包含所有的功能拆分成了模塊化的組件，根據(jù)項(xiàng)目需求導(dǎo)入相應(yīng)的組件庫(kù)，減少了項(xiàng)目的庫(kù)依賴，同時(shí)也減少了項(xiàng)目的包體積。
其次，對(duì)于一些代碼上的規(guī)范也做了不少調(diào)整，更加重要的是，對(duì)于Fragment生命周期的一些視圖組建的內(nèi)存管理做了進(jìn)一步的調(diào)整。整體來(lái)說(shuō)建議各位同學(xué)升級(jí)到AA-4.0版本，這個(gè)版本的改動(dòng)有點(diǎn)大，升級(jí)需謹(jǐn)慎，別趕著發(fā)版本升個(gè)級(jí)。
還是那句經(jīng)典的話，“no zuo no die,don't try”。