(一):基本介绍(Overview)
AndroidAnnotations使用很简单的方式进行工作,它会使用Java标准的APT(Annotation Processing Tool)自动添加额外的编译步骤在来生源代码。
那么什么是源代码呢?对于每一个增强(注入)的Class.例如每一个使用@EActivity注入过的Activity,它都会生成一个使用该相同Activity的名称后边加上一个下划线结尾的子类Activity。
例如:下面的类:
packagecom.some.company; @EActivity publicclassMyActivityextendsActivity { // ... }
会在相同的包但另外一个源代码文件夹中生成如下的子类
package com.some.company; public final class MyActivity_extendsMyActivity { // ... }
这个子类会通过覆盖一些方法(例如:onCreate())给你的Activity来添加相应的行为方法,然后进行委托给父类进行调用。
这就是我们真正使用的类
<activity android:name=".MyListActivity_" />
(二):打开一个被注入过的Activity
在Android中,我们平时会通过以下这种方式来打来Activity
startActivity(this, MyListActivity.class);
然而,如果我们使用AndroidAnnotations,那么真正需要被启动的Activity就变成了MyListActivity_
startActivity(this, MyListActivity_.class);
(三):意图构建(Intent Builder)
3.1.AndroidAnnotations已经提供一些静态的方法来让我们生成打开Activity
//打开Activity MyListActivity_.intent(context).start(); //通过Activity来获取Intent Intent intent = MyListActivity_.intent(context).get(); //可以设置flags MyListActivity_.intent(context).flags(FLAG_ACTIVITY_CLEAR_TOP).start(); //可以设置额外的数据 MyListActivity_.intent(context).myDateExtra(someDate).start();
3.2.可以使用等效的startActivityForResult()方法
MyListActivity_.intent(context).startForResult(REQUEST_CODE);
请注意如下:你可以使用@OnActivityResult注解来进行获取返回值和额外的参数值数据
@OnActivityResult(REQUEST_CODE) voidonResult(int resultCode) { }
3.3.可以使用意图构建器来传递可选的bundle参数数据
MyListActivity_.intent(context).withOptions(bundle).start();
3.4.使用意图构建起可以进行添加Activity打开的过渡动画
MyListActivity_.intent(context).start().withAnimation(enterAnimRes, exitAnimRes));
3.5.框架已经提供静态放来而让我们进行打开serice
// Starting the service MyService_.intent(context).start(); // Building an intent from theactivity Intent intent = MyService_.intent(context).build(); // You can provide flags MyService_.intent(context).flags(Intent.FLAG_GRANT_READ_URI_PERMISSION).start();
(四):打开一个被注入过的Service
在Android中我们通常会通过如下的方法来开启一个service
startService(this, MyService.class);
然而使用AndroidAnnotations框架之后,真正被启动的Service必须为MyService_。
startService(this, MyService_.class);
以上就是完成对AndroidAnnotations框架的工作的基本原理,深入源代码的讲解后面会进行相应更新。
FastDev4Android项目已经添加配置了AndroidAnnotations框架,同时相应的AndroidManifest.xml文件已经做了相应的修改.欢迎大家去Github站点进行clone或者下载浏览.
Https://github.com/jiangqqlmj/FastDev4Android
同时欢迎大家star和fork整个开源快速开发框架项目~如果有什么意见和反馈,欢迎留言,必定第一时间回复。也欢迎有同样兴趣的童鞋加入到该项目中来,一起维护该项目。