AndroidAnnotations(Code Diet)android快速开发框架

最近用了一款很不错的android快速开发框架，1000行的代码瞬间变成几百行，不用你会后悔的

特点：

(1) 依赖注入：包括view，extras，系统服务，资源等等
(2) 简单的线程模型，通过annotation表示方法运行在ui线程还是后台线程
(3) 事件绑定：通过annotation表示view的响应事件，不用在写内部类
(4) REST客户端：定义客户端接口，自动生成REST请求的实现
(5) 没有你想象的复杂：AndroidAnnotations只是在在编译时生成相应子类
(6) 不影响应用性能：仅50kb，在编译时完成，不会对运行时有性能影响。
PS：与roboguice的比较：roboguice通过运行时读取annotations进行反射，所以可能影响应用性能，而AndroidAnnotations在编译时生成子类，所以对性能没有影响

现在我们开始试用这个吧

• 首先我们要准备一下基本环境

1.因为目前主流市场IDE环境转入android studio，所以我就直说它的搭建环境吧，打开build.gradle（project）文件导入我们需要的编译环境，下载编译环境工具包

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.1.+' 
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.4'   //导入编译AndroidAnnotations框架需要使用的工具包
    }
}
tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}
allprojects {
    repositories {
        jcenter()                                            //下载jcenter服务器上的插件工具包
    }
}

2.打开build.gradle（Module）文件导入我们需要的编译环境，导入下载的工具包apt，下载框架需要的包，然后在运行之前编译的配置，并且输出日志

apply plugin: 'android'
apply plugin: 'android-apt'                                 //导入下载的工具

dependencies {
    compile fileTree(include: '*.jar', dir: 'libs')
    compile project(':SwitchCompatLibrary')
    compile 'com.orhanobut:logger:1.1+'
    compile 'org.androidannotations:androidannotations:3.3.1'          //导入框架包
    apt 'org.androidannotations:androidannotations:3.3.1'              //用之前下载的工具根据框架包编译项目
}
apt{                                                         //输出日志文件
    arguments{
        trace true
        androidManifestFile variant.outputs[0].processResources.manifestFile
    }
}

android {
    compileSdkVersion 15
    buildToolsVersion "21.1.2"
    lintOptions{
        checkReleaseBuilds false
    }
    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs = ['src']
            resources.srcDirs = ['src']
            aidl.srcDirs = ['src']
            renderscript.srcDirs = ['src']
            res.srcDirs = ['res']
            assets.srcDirs = ['assets']
            jniLibs.srcDirs=['libs']
        }

        instrumentTest.setRoot('tests')

        debug.setRoot('build-types/debug')
        release.setRoot('build-types/release')
    }
}

大部分情况网络情况不好下，这个包是下载不下来的，我们可以下载在本地放在libs文件下

compile 'org.androidannotations:androidannotations:3.3.1'          //导入框架包
    apt 'org.androidannotations:androidannotations:3.3.1'              //用之前下载的工具根据框架包编译项目
使用方法

compile files('libs/androidannotations.jar')

• 接下来我们使用了

闲话不多了，直接给代码了，下面这段代码是我们平时一般写android的原生代码

public class BookmarksToClipboardActivity extends Activity {
  
  BookmarkAdapter adapter;
 
  ListView bookmarkList;
 
  EditText search;
 
  BookmarkApplication application;
 
  Animation fadeIn;
 
  ClipboardManager clipboardManager;
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
 
    requestWindowFeature(Window.FEATURE_NO_TITLE);
    getWindow().setFlags(FLAG_FULLSCREEN, FLAG_FULLSCREEN);
 
    setContentView(R.layout.bookmarks);
 
    bookmarkList = (ListView) findViewById(R.id.bookmarkList);
    search = (EditText) findViewById(R.id.search);
    application = (BookmarkApplication) getApplication();
    fadeIn = AnimationUtils.loadAnimation(this, anim.fade_in);
    clipboardManager = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);
 
    View updateBookmarksButton1 = findViewById(R.id.updateBookmarksButton1);
    updateBookmarksButton1.setOnClickListener(new OnClickListener() {
 
      @Override
      public void onClick(View v) {
        updateBookmarksClicked();
      }
    });
 
    View updateBookmarksButton2 = findViewById(R.id.updateBookmarksButton2);
    updateBookmarksButton2.setOnClickListener(new OnClickListener() {
 
      @Override
      public void onClick(View v) {
        updateBookmarksClicked();
      }
    });
 
    bookmarkList.setOnItemClickListener(new OnItemClickListener() {
 
      @Override
      public void onItemClick(AdapterView<?> p, View v, int pos, long id) {
        Bookmark selectedBookmark = (Bookmark) p.getAdapter().getItem(pos);
        bookmarkListItemClicked(selectedBookmark);
      }
    });
 
    initBookmarkList();
  }
 
  void initBookmarkList() {
    adapter = new BookmarkAdapter(this);
    bookmarkList.setAdapter(adapter);
  }
 
  void updateBookmarksClicked() {
    UpdateBookmarksTask task = new UpdateBookmarksTask();
 
    task.execute(search.getText().toString(), application.getUserId());
  }
  
  private static final String BOOKMARK_URL = //
  "http://www.bookmarks.com/bookmarks/{userId}?search={search}";
  
  
  class UpdateBookmarksTask extends AsyncTask<String, Void, Bookmarks> {
 
    @Override
    protected Bookmarks doInBackground(String... params) {
      String searchString = params[0];
      String userId = params[1];
 
      RestTemplate client = new RestTemplate();
      HashMap<String, Object> args = new HashMap<String, Object>();
      args.put("search", searchString);
      args.put("userId", userId);
      HttpHeaders httpHeaders = new HttpHeaders();
      HttpEntity<Bookmarks> request = new HttpEntity<Bookmarks>(httpHeaders);
      ResponseEntity<Bookmarks> response = client.exchange( //
          BOOKMARK_URL, HttpMethod.GET, request, Bookmarks.class, args);
      Bookmarks bookmarks = response.getBody();
 
      return bookmarks;
    }
 
    @Override
    protected void onPostExecute(Bookmarks result) {
      adapter.updateBookmarks(result);
      bookmarkList.startAnimation(fadeIn);
    }
    
  }
 
  void bookmarkListItemClicked(Bookmark selectedBookmark) {
    clipboardManager.setText(selectedBookmark.getUrl());
  }
 
}

这段是我们用了框架后写过的代码

@NoTitle
@Fullscreen
@EActivity(R.layout.bookmarks)
public class BookmarksToClipboardActivity extends Activity {
  
  BookmarkAdapter adapter;
  
  @ViewById
  ListView bookmarkList;
 
  @ViewById
  EditText search;
  
  @App
  BookmarkApplication application;
  
  @RestService
  BookmarkClient restClient;
 
  @AnimationRes
  Animation fadeIn;
  
  @SystemService
  ClipboardManager clipboardManager;
 
  @AfterViews
  void initBookmarkList() {
    adapter = new BookmarkAdapter(this);
    bookmarkList.setAdapter(adapter);
  }
  
  @Click({R.id.updateBookmarksButton1, R.id.updateBookmarksButton2})
  void updateBookmarksClicked() {
    searchAsync(search.getText().toString(), application.getUserId());
  }
  
  @Background
  void searchAsync(String searchString, String userId) {
    Bookmarks bookmarks = restClient.getBookmarks(searchString, userId);
    updateBookmarks(bookmarks);
  }
 
  @UiThread
  void updateBookmarks(Bookmarks bookmarks) {
    adapter.updateBookmarks(bookmarks);
    bookmarkList.startAnimation(fadeIn);
  }
  
  @ItemClick
  void bookmarkListItemClicked(Bookmark selectedBookmark) {
    clipboardManager.setText(selectedBookmark.getUrl());
  }
 
}

@Rest("http://www.bookmarks.com")
public interface BookmarkClient {
  
  @Get("/bookmarks/{userId}?search={search}")
  Bookmarks getBookmarks(String search, String userId);
 
}

对比之后我们发现我们代码少了很多，很多人可能会顾虑代码少了，里面是不是做了很多消耗性能多余的操作，这里大家不用担心，根据AndroidAnnotations写的代码，在编译时生成子类，子类的代码和原生一模一样，所以对性能没有影响

• 常用地址

1. api地址和demo地址https://github.com/excilys/androidannotations/wiki/Cookbook
2. 下载地址https://github.com/excilys/androidannotations

• 总结

1. 基本语法就不和大家说呢，对程序员来说有了api文档和demo就行了
2. 这个框架语法很简单用一下就会了，就是环境有点蛋疼，这里只说了一个IDE环境搭配，其它的大家可以看文档
3. 东西虽然很好，但是希望android初学者学好基础后再来使用框架，框架是不断推出新的，如果你基础都不知道，以后变迁项目，或者项目报错你会对很多错误很茫然的，对你以后的发展也不好。