> Android在线手册 > 【FastDev4Android框架开发】AndroidAnnnotations注入框架介绍和Android Studios基本配置(七)

.简介(Introduction):

         AndroidAnnotations是一个能够让你快速进行Android开发的开源框架,它可以让我更加专注于业务功能开发。并且使代码更加精简,使项目更加容易维护,它的目标就是“Fast Android Development.Easymaintainance”。相信采用清晰意图且简单的代码来实现我们的功能目标。

它的首页地址是(Http://androidannotations.org/)大家如果有兴趣可以去官网看一下,并且首页他们提供了一个例子,进行原生开发以及使用注入框架开发的代码对比。例子也可以看到代码比之前几乎少写了一半。这样看来其中一个优点就不言而喻了直接代码量减少了很多,便于我们项目开发以及维护。项目框架介绍wiki地址:https://github.com/excilys/androidannotations/wiki。项目源代码Github地址:https://github.com/excilys/androidannotations.。大家都可以去下载下来学习一下。

Robert C. Martin写到:

Theratio of time spent reading [code] versus writing is well over 10 to 1[therefore] making it easy to read makes it easier to write.

     官网这样写到:当我们在进行开发Android程序的时候,我们常常在想:为什么我们总是需要一遍又一遍的写重复的代码?为什么我们的应用项目越来越难维护?Context,Activity和对象Object,复杂的线程,难以调用的API,加载的匿名listener,大量不需要的casts….难道我们不能改善这些?

      基于如下项目开发中遇到的各种各样的问题,我们可以使用今天我们要讲得东西。使用java annotations,开发者可以更加专注业务功能开发。让AndroidAnnotations在编译的时候来生成运行的代码。

.框架特点(Features):

1、使用依赖注入(Dependency Injection)可以注入views,extras,system service,resource等等

2、简化的线程模型(Simplified  threadingmodel)  ,可以进行annotate方法,让他们在UI线程上执行或在一个后台线程。

3、事件绑定(Event binding),annotate方法来处理views的事件,这样我们就不用再写很多丑陋的匿名监听器类

4REST Client  创建一个客户端接口,AndroidAnnotations生成实现。

5No Magic  AndroidAnnotations在编译的时候会产生一个子类(接下来你会明白),你查看这个子类,可以看到它是如何工作的]

AndroidAnnotations提供了这样的超强功能,但是整个项目都不超过159KB并且对运行时的性能没有任何影响。

.官方代码示例(CodeSample):

      朋友你写得Android代码容易写,阅读和维护吗?来看一下下面的例子:


@EActivity(R.layout.translate) // Sets content view toR.layout.translate
public class TranslateActivity extends Activity{
@ViewById // Injects R.id.textInput
    EditText textInput;
@ViewById(R.id.myTextView) // Injects R.id.myTextView
    TextView result;
@AnimationRes // Injects android.R.anim.fade_in
    Animation fadeIn;
@Click //When R.id.doTranslate button is clicked 
    void doTranslate() {
         translateInBackground(textInput.getText().toString());
    }
@Background // Executed in a background thread
    void translateInBackground(String textToTranslate) {
         String translatedText = callGoogleTranslate(textToTranslate);
        showResult(translatedText);
    }
@UiThread // Executed in the ui thread
    void showResult(String translatedText) {
         result.setText(translatedText);
         result.startAnimation(fadeIn);
    }
// [...]
}

看了以上的例子,对于控件初始化,资源获取,点击事件处理,后台任务处理,线程处理都全部有相关的Annotations,有没有感觉要实现同样的功能,以前写代码的方式是不是非常的蛋疼,来吧一起跟我来学习Android Annotations的使用。

.项目配置(Android Studio为例Configuration):

       我们这边采用Android Studio进行项目开发所以这边讲解Grade配置build方法

配置Android-apt

4.1.在项目全局build.grade进行如下配置

【FastDev4Android框架开发】AndroidAnnnotations注入框架介绍和Android Studios基本配置(七)

4.2.moudle内部build.grade中进行如下配置


apply plugin: 'com.android.application'
apply plugin: 'android-apt'
defAAVersion = 'XXX'  这边填写版本号,现在AndroidAnnotations的发布版本已经到了3.3.2
dependencies {
    apt "org.androidannotations:androidannotations:$AAVersion"
    compile "org.androidannotations:androidannotations-api:$AAVersion"
}
apt {
    arguments {
        androidManifestFile variant.outputs[0].processResources.manifestFile
        // if you have multiple outputs (whenusing splits), you may want to have other index than 0
// you should set your package namehere if you are using different application IDs
        // resourcePackageName"your.package.name"
// You can set optional annotationprocessing options here, like these commented options:
        // logLevel 'INFO'
        // logFile '/var/log/aa.log'
    }
}

     完成以上的步骤操作,那我们项目的AndroidAnnotations环境就已经配置搭建好了,下一篇我们着重进行将注入框架的基本使用。

本注入框架使用例子会加入到正在开发的框架项目中,可以可以去github站点clone下载

https://github.com/jiangqqlmj/FastDev4Android 

同时欢迎大家star和fork整个开源快速开发框架项目~如果有什么意见和反馈,欢迎留言,必定第一时间回复。也欢迎有同样兴趣的童鞋加入到该项目中来,一起维护该项目。