android-annotations使用入門

轉載請標明出處：http://write.blog.csdn.net/postedit/41577317

androidannotation是一個非常牛逼的框架（https://github.com/excilys/androidannotations/wiki），可以做到：依賴注入（Dependency Injection），簡化的線程模型（Simplified threading model)，事件綁定（Event binding），REST Client。

非常好用，更重要的是它對性能無影響！本文我們簡要的來看一下一些入門的東西。
1.從例子開始（參考https://github.com/excilys/androidannotations/wiki/FirstActivity）：
AndroidManifest.xml
[html] view plaincopy

2. package="com.example.hello"
3. android:versionCode="1"
4. android:versionName="1.0" >
5. android:minSdkVersion="14"
6. android:targetSdkVersion="18" />
7. android:allowBackup="true"
8. android:icon="@drawable/ic_launcher"
9. android:label="@string/app_name">
10. android:name="com.example.hello.MainActivity_"
11. android:label="@string/app_name" >
19. 裡面定義了兩個activity，注意名字後面都帶了一個下劃線。
    
    2.MainActivity.java:注意這裡的名字沒有下劃線
    [java] view plaincopy
    1. @EActivity(R.layout.activity_main)
    2. public class MainActivity extends Activity {
    3. @ViewById(R.id.myInput)
    4. EditText myInput;
    5. @ViewById(R.id.myTextView)
    6. TextView textView;
    7. @ViewById(R.id.myButton2)
    8. Button btn2;
    9. @StringRes(R.string.go_to_second)
    10. String btn2Txt;
    11. @AfterViews
    12. protected void afterViews(){
    13. btn2.setText(btn2Txt);
    14. }
    15. @Click
    16. void myButton() {
    17. String name = myInput.getText().toString();
    18. textView.setText("Hello " + name);
    19. }
    20. @Click
    21. void myButton2(){
    22. SecondActivity_.intent(this).start();
    23. }
    24. }
    25. activity_main.xml
    26. xmlns:tools="http://schemas.android.com/tools"
    27. android:layout_width="match_parent"
    28. android:layout_height="match_parent"
    29. android:orientation="vertical" >
    30. android:id="@+id/myInput"
    31. android:layout_width="fill_parent"
    32. android:layout_height="wrap_content" />
    33. android:id="@+id/myButton"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="Click me!" />
        android:id="@+id/myTextView"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content" />
        android:id="@+id/myButton2"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="@string/go_to_second"/>
        SecondActivity的源碼就不貼了。
        
        使用注入以後，代碼看上去變得很簡潔，再也沒有那一大堆findViewById之類的了。
        
        如何進行編譯運行呢（參考https://github.com/excilys/androidannotations/wiki/CustomizeAnnotationProcessing）：
        （1）如果是使用javac，需要傳遞-AandroidManifestFile=/path/to/AndroidManifest.xml這個參數，指明Manifest文件。
        （2）如果是使用Eclipse，在項目上點擊右鍵->Properties->Java Compiler->Annotation Processing->Enable annotation processing，
        然後在Factory Path中添加AndroidAnnotations的jar包。
        （3）如果是使用maven，maven-compiler-plugin的3.1版本可以設置編譯參數。
        [html] view plaincopy

        2. maven-compiler-plugin
        3. 3.1
        5. UTF-8
        6. 1.6
        7. 1.6
        9. -Atrace=true
        10. -AlogLevel=trace
        11. -AlogConsoleAppender=true
        12. -AandroidManifestFile=/path/to/AndroidManifest.xml
        15. 所有的可用的參數如下：
            （1）trace：boolean，用來啟用或者禁用@Trace注解，這個注解用會通過log記錄方法的執行。
            （2）androidManifestFile：string，默認情況下，AndroidAnnotations會在它的父文件夾中遞歸查找AndroidManifest.xml，假如你的工程的結構比較特殊，可以用這個進行指定。
            （3）resourcePackageName：string，默認情況下，AndroidAnnotations會從AndroidManifest.xml文件中提取應用的package來找到R文件，假如R文件是在一個定制的package中，可以用它來設置。
            （4）logFile：string，從3.0開始，AndroidAnnotations使用自定義的logger來在記錄代碼執行過程中的日志。日志默認會寫在{outputFolder}/androidannotations.log文件中。
            {outputFolder}參數按照下面的順序進行查找：target-> build -> bin -> root project folder。如果找不到{outputFolder}，可以使用logFile指定輸出的文件。{outputFolder}可以使用占位符來動態改變文件名。
            （5）logLevel：string，enum(trace, debug, info, warn, error)：默認的日志級別是DEBUG，改為TRACE可能會有用。
            （6）logAppenderConsole：boolean，默認情況下，AndroidAnnotations會使用FileAppender和MessagerAppender2個日志appender，FileAppender會寫在日志文件中，MessagerAppender在IDE的消息列表中顯示。可以設置logAppenderConsole為true來啟用另一個ConsoleAppender。
            （7）threadControl：boolean，用來啟用或者禁用@SupposeUiThread和@SupposeBackground注解，默認是true，可以保證方法是在正確的線程中調用。
            
            3.對性能的影響
            無影響！因為它的原理是生成Activity類的子類，並不是使用反射！我們可以看下編譯器幫我們自動生成的activity：
            [java] view plaincopy
            1. public final class MainActivity_ extends MainActivity{
            2. @Override
            3. public void onCreate(Bundle savedInstanceState) {
            4. init_(savedInstanceState);//這裡會處理@StringRes，@ColorRes等等
            5. super.onCreate(savedInstanceState);
            6. setContentView(layout.activity_main);//這裡對應@EActivity(R.layout.activity_main)
            7. }
            10. private void init_(Bundle savedInstanceState) {
            11. Resources resources_ = this.getResources();
            12. btn2Txt = resources_.getString(string.go_to_second);
            13. }
            16. @Override
            17. public void setContentView(int layoutResID) {
            18. super.setContentView(layoutResID);
            19. afterSetContentView_();
            20. }
            23. @Override
            24. public void setContentView(View view, LayoutParams params) {
            25. super.setContentView(view, params);
            26. afterSetContentView_();
            27. }
            30. @Override
            31. public void setContentView(View view) {
            32. super.setContentView(view);
            33. afterSetContentView_();
            34. }
            37. private void afterSetContentView_() {
            38. //@ViewById
            39. textView = ((TextView) findViewById(id.myTextView));
            40. myInput = ((EditText) findViewById(id.myInput));
            41. btn2 = ((Button) findViewById(id.myButton2));
            42. //@Click
            43. {
            44. View view = findViewById(id.myButton2);
            45. if (view!= null) {
            46. view.setOnClickListener(new OnClickListener() {
            51. @Override
            52. public void onClick(View view) {
            53. MainActivity_.this.myButton2();
            54. }
            57. }
            58. );
            59. }
            60. }
            61. //@Click
            62. {
            63. View view = findViewById(id.myButton);
            64. if (view!= null) {
            65. view.setOnClickListener(new OnClickListener() {
            70. @Override
            71. public void onClick(View view) {
            72. MainActivity_.this.myButton();
            73. }
            76. }
            77. );
            78. }
            79. }
            80. afterViews();//這裡調用了@AfterViews標注的afterViews()方法
            81. }
            82. public static MainActivity_.IntentBuilder_ intent(Context context) {
            83. return new MainActivity_.IntentBuilder_(context);
            84. }
            85. public static class IntentBuilder_ {//這個是給startActivity和startActivityForResult用的
            86. private Context context_;
            87. private final Intent intent_;
            90. public IntentBuilder_(Context context) {
            91. context_ = context;
            92. intent_ = new Intent(context, MainActivity_.class);
            93. }
            96. public Intent get() {
            97. return intent_;
            98. }
            101. public MainActivity_.IntentBuilder_ flags(int flags) {
            102. intent_.setFlags(flags);
            103. return this;
            104. }
            107. public void start() {
            108. context_.startActivity(intent_);
            109. }
            112. public void startForResult(int requestCode) {
            113. if (context_ instanceof Activity) {
            114. ((Activity) context_).startActivityForResult(intent_, requestCode);
            115. } else {
            116. context_.startActivity(intent_);
            117. }
            118. }
            119. }
            120. }
                 

                 最後看一下完整的pom.xml的例子（https://github.com/excilys/androidannotations/blob/develop/examples/maveneclipse/pom.xml）：

                 [html] view plaincopy
                 3. 4.0.0
                 4. org.androidannotations
                 5. maveneclipse
                 6. 0.0.1-SNAPSHOT
                 7. apk
                 8. maveneclipse
                 11. UTF-8
                 12. 4.1.1.4
                 13. 16
                 14. 3.2
                 15. 1.6
                 20. com.google.android
                 21. android
                 22. ${android.version}
                 23. provided
                 26. org.androidannotations
                 27. androidannotations
                 28. ${androidannotations.version}
                 29. provided
                 32. org.androidannotations
                 33. androidannotations-api
                 34. ${androidannotations.version}
                 41. maven-compiler-plugin
                 42. 3.1
                 44. ${java.version}
                 45. ${java.version}
                 47. -AlogLevel=trace
                 52. com.jayway.maven.plugins.android.generation2
                 53. android-maven-plugin
                 54. 3.9.0-rc.3
                 57. ${android.platform}
                 59. true
                 61. true