笔者从事智能家具行业的开发工作,也是从公司创业团队工作到现在,对于公司的项目从1.0版本开始接手一直到现在,虽说项目不是很大但麻雀虽小五脏俱全,在项目和团队的不断扩大、暴露出的问题也不段增多,组件化势在必行,本文就根据整个项目的发展,总结下组件化的实践流程;
在最初的1.0版本中只是针对一个智能设备的操控和数据交互,项目本身就很简单此时也基本单人开发,所以所有的功能代码都直接在app中开发,但随着业务的增长和对未来的规划,项目进入2.0阶段
2.0阶段的业务比1.0增加了电商、社区、内容等业务模块,同时智能设备也由原来的单一设备变成多个设备,此时如果只在app中开发,会导致单个Module中代码急剧膨胀,代码耦合度高,而且业务增多后团队面临扩张,此时业务模块之间的耦合,在多人协作开发时也暴露出来,而且由于行业的需求有时会有临时的Demo和定制化的应用,在原来的项目上很难实现这些需求,此时必须对原来的项目代码进行组件化操作;
在进行组件化操作之前,先区分两个概念:模块化和组件化
由上面的介绍知道,组件化针对更细更单一的业务,功能模块粒度较大,针对某个方面的整体业务,当然业务当中可能使用很多的独立组件,按照组件化的需求项目的架构进入3.0
上面已智能、内容两个模块为例,在项目组件化操作后的架构图,架构从下向上依次为:
由上面的3.0版本架构知道,项目中包含多个功能组件和业务模块,在开发中要保证组件间不能耦合,业务木块依赖于组件,但业务模块之间也不能相互引用,否则违背了组件化的原则;
在我们实际开发中app 构建形式为application,最终编译成APK文件,其余所依赖的Module编译形式为library,最终已arr形式寻在提供API调用,换句话说只要修改组件的编译形式即可实现单独编译的功能,所以在组件下创建gradle.properties文件用于控制构建形式
isRunAlone = false
在build.gradle中根据isRunAlone的变量修改构建形式
if (isRunAlone.toBoolean()) {
apply plugin: 'com.android.application'
} else {
apply plugin: 'com.android.library'
}
if (isRunAlone.toBoolean()) {
applicationId "com.alex.kotlin.content"
}
在组件化单独编译和整体编译时,注册清单中所需要的内容不同,如单独编译需要额外的启动页,且单独编译时也休要配置不同的Application,此时在main文件加下创建manifest/AndroidMenifest.xml文件,根据单独编译的需要设置内容。
sourceSets {
main {
if (isRunAlone.toBoolean()) {
manifest.srcFile 'src/main/manifest/AndroidManifest.xml'
} else {
manifest.srcFile 'src/main/AndroidManifest.xml'
}
}
}
到此编译配置完成,在需要单独编译时只需要修改isRunAlone为true即可;
由上面配置的两个注册清单文件中可见,在App整体编译时组件使用的是全局的Application,在单独编译时使用的是AutoApplication,大家都知道一个程序中只有一个Application类,那组件中需要初始化的代码都配置在自己的AutoApplication中,那整体编译时如何初始化呢?可能有同学说整体编译时个组件和模块是可见的,直接调用AutoApplication类完成初始化,但此种情况主项目就无法实现模块的自由增减,而且当代码隔离时AutoApplication就不可见了,这里采用一种配置+反射的方式舒适化各组件的Application,具体实现如下:
abstract class BaseApp : Application(){
/** * 初始化Module中的Application */
abstract fun initModuleApp(application: Application)
}
class AutoApplication : BaseApp() {
override fun onCreate() { //单独编译时初始化
super.onCreate()
MultiDex.install(this)
AppUtils.setContext(this)
initModuleApp(this)
ServiceFactory.getServiceFactory().loginToService = AutoLoginService()
}
override fun initModuleApp(application: Application) { //整体编译
ServiceFactory.getServiceFactory().serviceIntelligence = AutoIntelligenceService()
}
}
object AppConfig {
private const val BASE_APPLICATION = "com.pomelos.base.BaseApplication"
private const val CONTENT_APPLICATION = "com.alex.kotlin.content.ContentApplication"
private const val AUTO_APPLICATION = "com.alex.kotlin.intelligence.AutoApplication"
val APPLICATION_ARRAY = arrayListOf(BASE_APPLICATION, CONTENT_APPLICATION, AUTO_APPLICATION)
}
public class GlobalApplication extends BaseApp {
@SuppressLint("StaticFieldLeak")
private static GlobalApplication instance;
public GlobalApplication() {}
@SuppressWarnings("AlibabaAvoidManuallyCreateThread")
@Override
public void onCreate() {
super.onCreate();
MultiDex.install(this);
AppUtils.setContext(this);
if (BuildConfig.DEBUG) {
//开启Debug
ARouter.openDebug();
//开启打印日志
ARouter.openLog();
}
//初始化ARouter
ARouter.init(this);
ServiceFactory.Companion.getServiceFactory().setLoginToService(new AppLoginService());
//初始化组件的Application
initModuleApp(this);
}
@Override
public void initModuleApp(@NotNull Application application) {
for (String applicationName : AppConfig.INSTANCE.getAPPLICATION_ARRAY()) { //遍历所有配置的Application
try {
Class clazz = Class.forName(applicationName); //反射执行
BaseApp baseApp = (BaseApp) clazz.newInstance(); //创建实例
baseApp.initModuleApp(application); // 执行初始化
} catch (ClassNotFoundException e) {
e.printStackTrace();
}
}
}
}
以上通过在AppConfig中配置所有的Application的路径,在主Application执行时反射创建每个实例,调用对应的initModuleApp()完成所有的配置,不知有没有注意到在AutoApplication中同样在onCreate()中初始化了内容,此处是为了在单独编译时调用;
在项目中因为有时需要打包不同需求的APK,所以我将login单独分离出成组件同一登录行为,那么在特务模块依赖Login之后即可实现登录功能,但每个单独的业务独立编译时会产生多个APK,这些APK都需要获取登录状态及跳转相应的首界面,那么在保证程序解耦的情况下如何实现呢?答案及时使用注册接口实现;
interface LoginToService {
/** * 实现登录后的去向 */
fun goToSuccess()
}
class ServiceFactory private constructor() {
companion object {
fun getServiceFactory(): ServiceFactory {
return Inner.serviceFactory
}
}
private object Inner {
val serviceFactory = ServiceFactory()
}
}
var loginToService: LoginToService? = null
get() {
if (field == null) {
field = EmptyLoginService()
}
return field
}
class AppLoginService : LoginToService { //App模块
override fun goToSuccess() {
val intent = Intent(AppUtils.getContext(), MainActivity::class.java)
intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
AppUtils.getContext().startActivity(intent)
}
}
class AutoLoginService : LoginToService { // 智能模块
override fun goToSuccess() {
val intent = Intent(AppUtils.getContext(), AutoMainActivity::class.java)
intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
AppUtils.getContext().startActivity(intent)
}
}
ServiceFactory.getServiceFactory().serviceIntelligence = AutoIntelligenceService()
override fun loadSuccess(loginBean: LoginEntity) {
ServiceFactory.getServiceFactory().loginToService?.goToSuccess()
}
各组件通过向base组件中的ServiceFactory注册的方式,对外提供执行的功能,因为ServiceFactory单例调用,所以在其他组件中通过ServiceFactory获取注册的实例后即可执行方法,为了在减去组件或模块时防止报错,在base中同样提供了服务的空实现;
关于页面跳转推荐使用阿里的ARoute框架,详情见另一篇文章:Android框架源码分析——以Arouter为例谈谈学习开源框架的最佳姿势
在一般项目中,主app的首界面都来自不同的业务模块组成,最常见的就是使用不同组件的Fragment和ViewPager组合,但此时主App需要获取组件中的Fragment实例,按照组件化的思想不能直接使用,否则主APP和组件、模块间又会耦合在一起,此处也是采用接口模式处理,过程和数据交互大致相同;
interface ContentService {
/** * 返回实例化的Fragment */
fun newInstanceFragment(): BaseCompatFragment?
}
// 内容模块实现
class ContentServiceImpl : ContentService {
override fun newInstanceFragment(): BaseCompatFragment? {
return ContentBaseFragment.newInstance() //提供Fragment对象
}
}
ServiceFactory.getServiceFactory().serviceContent = ContentServiceImpl()
mFragments[SECOND] = ServiceFactory.getServiceFactory().serviceContent?.newInstanceFragment()
虽然经历组件化将代码解耦,但在开发中如果依赖的组件或模块中的方法总是可见,万一在开发中使用了其中的代码,那程序程序又会耦合在一起,如何能让组件和模块中的方法不可见呢?答案就在runtimeOnly依赖,他可以在开发过程中隔离代码,在编译时代码可见
runtimeOnly project(':content')
runtimeOnly project(':intelligence')
runtimeOnly依赖实现了代码隔离,但对资源并没有效果,使用中还是可能会直接引用资源,为了防止这种现象,为每个组件的资源加上特有的前缀
resourcePrefix "auto_"
此时该Module下的资源都必须以auto_开头否则会警告;
由于项目中使用到了ContentProvider,(不了解的点击Android进阶知识树——ContentProvider使用和工作过程详解)在整体编译安装在手机后可以正常运行,此时要单独编译时总是提示安装失败,最终原因就是两个Apk中的ContentProvider和权限一致导致,那如何保证单独编译和整体编译时权限不同,从而安装成功呢?我们首先在上面的连个Menifest文件中配置Provider
<provider
android:name=".database.MyContentProvider"
android:authorities="com.alex.kotlin.intelligence.database.MyContentProvider"
android:exported="false" />
<provider
android:name=".database.MyContentProvider"
android:authorities="com.findtech.threePomelos.database.MyContentProvider"
android:exported="false" />
这样两个权限不同的Provider即可安装成功,在使用时需要根据权限执行ContentProvider,那么如何在代码中根据不同编译类型,拼接对应的执行权限呢?此处使用在build.gradle中配置BuildConfig来处理,将权限直接配置在BuildConfig中,在使用时直接获取即可
if (isRunAlone.toBoolean()) {
buildConfigField 'String','AUTHORITY','"com.alex.kotlin.intelligence.database.MyContentProvider"'
}else {
buildConfigField 'String','AUTHORITY','"com.findtech.threePomelos.database.MyContentProvider"'
}
const val AUTHORITY = BuildConfig.AUTHORITY //使用
解决上面的所有问题后,项目的组件化基本可以实现,但具体的划分粒度和细节,需要自身结合业务和经验去处理,可能有些需要直接分离组件,也可能小的功能需要放在base组件中共享,而且每个人针对每个项目的处理方式也不同,只要理解组件化的思想和方式实现最终的需求即可;