一般而言,我们的工程都是单一工程模型,如下:
1、主业务包:业务1、业务2、业务3
2、依赖库:网络库、日志库、工具库等等
项目结构:
项目不复杂时没什么问题,但当需求越来越多,项目越来越复杂时,我们就要考虑更多了:
1、业务功能模块如何更为清晰,如何保持模块间的松散耦合
2、不能灵活对模块进行配置和封装,因为耦合严重,牵一发而动全身
3、工程很大,每次编译都浪费很多时间,单独编译某个模块
所以,组建化开发应运而生,用以解决上述问题,组件化工程下主要包含几个模块:app壳工程、业务组件、功能组件、SDK或者JAR基础支持库
模块 | 含义 |
---|---|
app壳工程 | 负责管理各个业务组件,没有具体的业务逻辑 |
业务组件 | 负责基本业务逻辑,比如聊天、新闻、直播、个人中心等这种不同的业务 |
功能组件 | 负责一些基础功能,比如Base库、拦截器、动画、日志、播放器界面,可能在业务组件中重复用 |
支持库 | okhttp、gson、butterkife等 |
项目结构:
如上,主要有三个模块先了解:app主工程,test1module模块,test2module模块,包上有小黄点的是可以单独编译的组件,有棱柱条的是集成编译的组件,还有蓝色小方块的是封装的功能组件包,
arouter-compiler中有核心的类
AutowiredProcessor:注解
InterceptorProcessor:拦截
RouteProcessor:路由
两个测试模块用于区分不同的业务,还有几个包是路由框架Arouter的,在这里算是功能模块,主要作用是支持组件框架的模块通信,页面跳转、数据传输等任务,是阿里的组件路由开源解决方案:(https://github.com/alibaba/ARouter),网上有不少组件解决方案,有的路由是自己写的,有的是j借这个路由引擎改写的,我这里也是引入这个引擎到自己的demo项目然后添加相关配置代码搭建一个自己的组件解决方案,这样我们可以更好去理解组件化开发中的各方面需要处理的问题,接下来说一下具体步骤:
1、新建module1和module2,点击主项目右键新建module即可,选择android library
2、引入Arouter涉及的包,方法一根据git提示引进,方法二是我的先clone Arouter demo源码,然后通过import module 引入demo里面的库
3、主项目引用Arouter以及业务模块,在build.gradle文件中
apply plugin: 'com.alibaba.arouter'
javaCompileOptions {
annotationProcessorOptions {
arguments = [moduleName: project.getName()]
}
}
dependencies {
annotationProcessor project(':arouter-compiler')
compile project(':arouter-api')
compile project(':arouter-annotation')
if (isNeedTest1Module.toBoolean())
compile project(':test1module')
if (isNeedTest2Module.toBoolean())
compile project(':test2module')
}
isNeedTest2Module是声明的静态变量,用来方便切换组件模式还是集成模式的,即模块是单独编译还是集成到主项目进行编译
4、初始化Arouter,
ARouter.openDebug();
ARouter.init(getApplication());
5、配置module模块的build.gradle文件
if (!isNeedTest1Module.toBoolean()) {
apply plugin: 'com.android.application'
} else {
apply plugin: 'com.android.library'
}
android {
compileSdkVersion 26
defaultConfig {
if (!isNeedTest1Module.toBoolean()) {
applicationId "com.example.yy.test1module"
}
minSdkVersion 19
targetSdkVersion 26
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
javaCompileOptions {
annotationProcessorOptions {
arguments = [moduleName: project.getName()]
}
}
}
sourceSets {
main {
if (!isNeedTest1Module.toBoolean()) {
manifest.srcFile 'src/main/AndroidManifest.xml'
} else {
manifest.srcFile 'src/main/module/AndroidManifest.xml'
}
}
}
buildTypes {
release {
debuggable false
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
lintOptions { abortOnError false }
}
}
dependencies {
compile project(':arouter-api')
compile "com.android.support:appcompat-v7:${SUPPORT_LIB_VERSION}"
annotationProcessor project(':arouter-compiler')
testImplementation 'junit:junit:4.12'
}
里面的if else都是动态确定单独编译还是集成编译的,这里manifest.srcFile 'src/main/AndroidManifest.xml'
比较特殊,因为我们在集成编译的模式下我们的AndroidManifest.xml和普通的不太一样,如下:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.yy.test1module">
<application android:theme="@style/AppTheme">
<activity
android:name=".Test1Activity"
android:screenOrientation="portrait" />
</application>
</manifest>
提供两个AndroidManifest.xml让其选择编译即可解决<intent-filter>带来的影响
6、模块中声明路由地址、添加注解:
@Route(path = "/test2/Test2Activity")
public class Test2Activity extends AppCompatActivity {
@Autowired
int age;
TextView ageText;
@Override
protected void onCreate(Bundle savedInstanceState) {
ARouter.getInstance().inject(this);
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_test2);
ageText = findViewById(R.id.age);
ageText.append("" + age);
}
}
7、在主工程开启跳转,并携带参数:
public void onClickModule1(View v) {
ARouter.getInstance()
.build("/test1/Test1Activity")
.withString("name", "yangyong")
.navigation();
}
public void onClickModule2(View v) {
ARouter.getInstance()
.build("/test2/Test2Activity")
.withInt("age", 25)
.navigation();
}
public void onClickIntercpt(View v) {
ARouter.getInstance()
.build("/test2/Test2Activity")
.withInt("age", 25)
.navigation(this, new NavCallback() {
@Override
public void onArrival(Postcard postcard) {
Toast.makeText(MainActivity.this, "到达了", Toast.LENGTH_SHORT).show();
}
@Override
public void onInterrupt(Postcard postctestinterceptorard) {
Toast.makeText(MainActivity.this, "被拦截了", Toast.LENGTH_SHORT).show();
}
});
}
上面特别注意!!/test2/Test2Activity 这个路劲第一个test2是代表组,后面一个为具体地址,组在不同模块中是不能相同的,不然无法编译通过。看一下最后的GIF效果图:
因为第一个组件是单独编译模式,所以找不到路由;第二个组件可以正常跳转过去,我们也进行了跳转是否成功的测试。
至此,一个初步的组件项目就搭建起来了,Arouter路由原理是根据url 的scheme来的,当然除了上面的,还支持很多功能,如下:
一下子看不太懂没有关系,下载个demo来玩一玩,实际开发中多使用就能理解。
本项目demo的地址(MvpArouter分支):
https://github.com/yangyong915/MvpManager-yy/tree/MvpArouter
参考文献
Android组件化方案
开源最佳实践:Android平台页面路由框架ARouter
总结一波安卓组件化开源方案
ARouter源码:https://github.com/alibaba/ARouter