转载请标明出处:
http://blog.csdn.net/developer_jiangqq/article/details/49468923
本文出自:【江清清的博客】
一.简介(Introduction):
【好消息】个人网站已经上线运行,后面博客以及技术干货等精彩文章会同步更新,请大家关注收藏:http://www.lcode.org
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的事件,这样我们就不用再写很多丑陋的匿名监听器类
4、REST Client 创建一个客户端接口,AndroidAnnotations生成实现。
5、No 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进行如下配置
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整个开源快速开发框架项目~如果有什么意见和反馈,欢迎留言,必定第一时间回复。也欢迎有同样兴趣的童鞋加入到该项目中来,一起维护该项目。