筆者注：AA-4.0為AndroidAnnotations-4.0的簡稱
AA4.0已經(jīng)模塊化了
現(xiàn)在AA-4.0的庫被分割為一些小的模塊诡挂，這意味著你以前在AA-3.x版本之前庫中使用的一些注解方法都被分拆為一些單獨的模塊神郊，你需要在Gradle配置文件中添加新的依賴庫，改變import的包名放棒。
@OrmLiteDao
以@OrmLiteDao的注解使用為例，在引入AA-4.0后己英，如果你的項目中有用到@OrmLiteDao间螟，那么你需要在app的build.gradle項目依賴中添加下文件：
compile "org.androidannotations:ormlite-api:4.0.0"
apt "org.androidannotations:ormlite:4.0.0"
修改import的包名：
org.androidannotations.ormlite.annotations.OrmLiteDao
Otto
將Otto庫整合到AA-4.0中配置如下：
- 添加AA-4.0到工程；
- 添加
Otto庫的插件：
dependencies {
apt "org.androidannotations:otto:$AAVersion"
compile "org.androidannotations:otto-api:$AAVersion"
} - 添加Otto庫依賴
dependencies { compile 'com.squareup:otto:1.3.8'}
Rest Client
如果項目中使用Rest Client 损肛，需要在build.gradle中添加配置依賴庫：
dependencies {
apt "org.androidannotations:rest-spring-api:$AAVersion"
compile "org.androidannotations:rest-spring:$AAVersion"
}
更改導入的包名:
org.androidannotations.rest.spring.annotations.Rest //etc
org.androidannotations.rest.spring.api.RestClientHeaders // etc
@RoboGuice
使用 @RoboGuice
, 在項目的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對象會被清理
在AA-4.0中對在Fragment中使用@ViewById和@ViewsById的View對象會在Fragment的聲明周期onDestoryView()時設為null厢破，如果程序執(zhí)行了Fragment的聲明周期事件onDestoryView()后，仍然訪問該View治拿，則會得到NullPointerExceptions異常摩泪，為了避免發(fā)生這種情況，可以使用新的注解@IgnoreWhen劫谅，如下：
//當前狀態(tài)為DESTORYED见坑，則忽略此方法，不調(diào)用
@IgnoreWhen(IgnoreWhen.State.VIEW_DESTROYED)
void someMethodCalledAfterViewDestroyed() {
injectedView.setText("Hello");
}
自AA-4.0不再支持2.3.1以下的Android設備
現(xiàn)在市面上的Android設備已經(jīng)都是4.0及以上了捏检，2.3的設備都比較少荞驴，所以不支持2.3.1以下的安卓設備也沒啥影響。
編譯運行最小支持 JDK7不再支持JDK 6
AA-4.0不再支持JDK 6的編譯贯城，不過你依然可以使用JDK 6的源碼來編譯熊楼。話說現(xiàn)在的環(huán)境都支持JDK8了，到時候在build.gradle的android{}DSL域中配置編譯選項即可能犯。
//java版本
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
@ReceiverAction 修改
在AA-3.x版本及以前鲫骗，如果使用@ReceiverAction沒有指定Action的值，則會將方法名作為Action悲雳，從AA-4.0開始不再支持這種方式挎峦，必須在注解中指定Action的值。
實例說明：
@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ù)配置選項合瓢，不過在編譯期間坦胶，會自動根據(jù)Dao類判斷model的值，減少了冗余。
實例說明：
@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注解峭咒，可以通過@WindowFeature注解來實現(xiàn)同樣的功能(不顯示標題)
@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這個項目也不再維護纪岁，所以AA-4.0也不再提供對ActionBarSherlock的支持凑队。在項目中可以使用 AppCompat Support Library來替代ActionBarSherlock。
PS：現(xiàn)在應該沒有人用ActionBarSherlock這么古老的庫了吧~
@Extra 和 @AfterExtras 的變動
在AA-4.0中幔翰，不會再在onNewIntent()方法中調(diào)用setIntent()方法漩氨。這個對于3.x的用戶基本上沒影響。
在@Rest 方法中所有的參數(shù)都需要添加注解
對于以前項目使用AA-3.x的遗增，這個改動有點小大叫惊，得改不少關于Rest Client的代碼，從AA-4.0開始你必須明確的告訴編譯處理器每個Rest請求方法中的參數(shù)代表的意思做修。
使用@Body注解指明請求的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
}
總體來說霍狰，AA-4.0中關于@Rest這塊的注解方法，有很多借鑒了Retrofit饰及。這是一個不錯的開端蔗坯，后續(xù)版本可能回減少對于SpringAndroid的項目庫的依賴。逐漸的形成一種插件化的網(wǎng)絡請求注解庫燎含。
END
本文大部分內(nèi)容參考AA 4.0 migration guide 宾濒，此次的AA-4.0版本是一次重大更新，很明顯的改變就是將之前一個庫包含所有的功能拆分成了模塊化的組件瘫镇，根據(jù)項目需求導入相應的組件庫鼎兽，減少了項目的庫依賴，同時也減少了項目的包體積铣除。
其次，對于一些代碼上的規(guī)范也做了不少調(diào)整鹦付，更加重要的是尚粘，對于Fragment生命周期的一些視圖組建的內(nèi)存管理做了進一步的調(diào)整。整體來說建議各位同學升級到AA-4.0版本敲长，這個版本的改動有點大郎嫁，升級需謹慎，別趕著發(fā)版本升個級祈噪。
還是那句經(jīng)典的話泽铛，“no zuo no die,don't try”。
