基于 MVP 的 Android 组件化开发框架实践

1、背景

当咱们的项目变得愈来愈大,代码变得愈来愈臃肿,耦合会愈来愈多,编译速度愈来愈慢,开发效率也会变得愈来愈低,怎么办?这个时候咱们就须要对旧项目进行重构,便是模块的拆分,官方的说法就是组件化。java

2、简介

那什么是组件化呢?其基本理念是:把经常使用的功能、控件、基础类、第三方库、权限等公共部分抽离封装,咱们称之为基础组件(baselibs);把业务分红 N 个模块进行独立的管理,每个模块咱们称之为业务组件;而全部的业务组件都须要依赖于封装的基础组件,业务组件之间不作依赖,这样的目的是为了让每个业务模块都能单独运行。而在 APP 层对整个项目的模块进行封装。react

业务模块之间的跳转能够经过路由(Arouter)实现;业务模块之间的通讯能够经过消息(EventBus)来实现。android

3、基础搭建

一、组件框架图

二、根据组件框架图搭建的项目结构图

项目结构图

三、接下来介绍每一个模块

项目中总共有五个 module ,包括 3 个业务模块、一个基础模块和一个 APP 壳模块。git

在建好项目以后咱们须要给 3 个 module 配置 “集成开发模式” 和 “组件开发模式” 的切换开关,能够在 gradle.properties 文件中定义变量 isModelisModel=false 表明是 “集成开发模式” , isModel=true 表明是 “组件开发模式” (注:每次修改isModel的值后必定要Sysn才会生效)。github

1)APP 壳模块api

主要就是集成每个模块,最终打包成一个完整的 apk ,其中 gradle 作了以下配置,根据配置文件中的 isModel 字段来依赖不一样的业务组件;bash

2)baselibs 模块网络

主要负责封装公共部分,如 MVP 架构、 BaseView 的封装、网络请求库、图片加载库、工具类以及自定义控件等;架构

为了防止重复依赖,全部的第三方库都放在这个模块,业务模块不作任何第三方依赖,只依赖于 baselibs 模块。app

baselibs 模块的结构以下:

baselibs 模块的 gradle 中引入的库

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    configurations {
        all*.exclude group: 'com.android.support', module: 'support-v13'
    }
    testImplementation rootProject.ext.testDeps["junit"]
    androidTestImplementation rootProject.ext.testDeps["runner"]
    androidTestImplementation rootProject.ext.testDeps["espresso-core"]
    //leakCanary
    debugApi rootProject.ext.testDeps["leakcanary-debug"]
    releaseApi rootProject.ext.testDeps["leakcanary-release"]
    // Support库
    api rootProject.ext.supportLibs
    // 网络请求库
    api rootProject.ext.networkLibs
    // RxJava2
    api rootProject.ext.rxJavaLibs
    // commonLibs
    api rootProject.ext.commonLibs
    kapt rootProject.ext.otherDeps["arouter-compiler"]
}
复制代码

3)业务模块(module_news、module_video、module_me)

每个业务模块在 “集成开发模式” 下以 library 的形式存在;在 “组件开发模式” 下以 application 的形式存在,能够单独运行。

因为每一个业务模块的配置文件都差很少,下面就以 module_news 模块为例;

如下是 module_news 模块的 gradle 配置文件:

if (isModule.toBoolean()) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}
android {
    if (isModule.toBoolean()) {
        applicationId "com.cxz.module.me"
    }
    compileSdkVersion rootProject.ext.android.compileSdkVersion
    defaultConfig {
        minSdkVersion rootProject.ext.android.minSdkVersion
        targetSdkVersion rootProject.ext.android.targetSdkVersion
        versionCode 1
        versionName "1.0"
    }
}
dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    testImplementation rootProject.ext.testDeps["junit"]
    androidTestImplementation rootProject.ext.testDeps["runner"]
    androidTestImplementation rootProject.ext.testDeps["espresso-core"]
    implementation project(':baselibs')
    kapt rootProject.ext.otherDeps["arouter-compiler"]
}
复制代码

4)配置文件 config.gradle ,对项目中的第三库、 app 的版本等配置

ext {
    android = [
            compileSdkVersion: 28,
            buildToolsVersion: "28.0.3",
            minSdkVersion    : 16,
            targetSdkVersion : 27,
            versionCode      : 1,
            versionName      : "1.0.0"
    ]
    dependVersion = [
            androidSupportSdkVersion: "28.0.0",
            espressoSdkVersion      : "3.0.2",
            retrofitSdkVersion      : "2.4.0",
            glideSdkVersion         : "4.8.0",
            rxJava                  : "2.2.2",
            rxAndroid               : "2.1.0",
            rxKotlin                : "2.3.0",
            anko                    : "0.10.7"
    ]
    supportDeps = [
            "supportv4"        : "com.android.support:support-v4:${dependVersion.androidSupportSdkVersion}",
            "appcompatv7"      : "com.android.support:appcompat-v7:${dependVersion.androidSupportSdkVersion}",
            "cardview"         : "com.android.support:cardview-v7:${dependVersion.androidSupportSdkVersion}",
            "design"           : "com.android.support:design:${dependVersion.androidSupportSdkVersion}",
            "constraint-layout": "com.android.support.constraint:constraint-layout:1.1.3",
            "annotations"      : "com.android.support:support-annotations:${dependVersion.androidSupportSdkVersion}"
    ]
    retrofit = [
            "retrofit"                : "com.squareup.retrofit2:retrofit:${dependVersion.retrofitSdkVersion}",
            "retrofitConverterGson"   : "com.squareup.retrofit2:converter-gson:${dependVersion.retrofitSdkVersion}",
            "retrofitAdapterRxjava2"  : "com.squareup.retrofit2:adapter-rxjava2:${dependVersion.retrofitSdkVersion}",
            "okhttp3LoggerInterceptor": 'com.squareup.okhttp3:logging-interceptor:3.11.0',
            "retrofitConverterMoshi"  : 'com.squareup.retrofit2:converter-moshi:2.4.0',
            "retrofitKotlinMoshi"     : "com.squareup.moshi:moshi-kotlin:1.7.0"
    ]
    rxJava = [
            "rxJava"   : "io.reactivex.rxjava2:rxjava:${dependVersion.rxJava}",
            "rxAndroid": "io.reactivex.rxjava2:rxandroid:${dependVersion.rxAndroid}",
            "rxKotlin" : "io.reactivex.rxjava2:rxkotlin:${dependVersion.rxKotlin}",
            "anko"     : "org.jetbrains.anko:anko:${dependVersion.anko}"
    ]
    testDeps = [
            "junit"                    : 'junit:junit:4.12',
            "runner"                   : 'com.android.support.test:runner:1.0.2',
            "espresso-core"            : "com.android.support.test.espresso:espresso-core:${dependVersion.espressoSdkVersion}",
            "espresso-contrib"         : "com.android.support.test.espresso:espresso-contrib:${dependVersion.espressoSdkVersion}",
            "espresso-intents"         : "com.android.support.test.espresso:espresso-intents:${dependVersion.espressoSdkVersion}",
            "leakcanary-debug"         : 'com.squareup.leakcanary:leakcanary-android:1.6.1',
            "leakcanary-release"       : 'com.squareup.leakcanary:leakcanary-android-no-op:1.6.1',
            "leakcanary-debug-fragment": 'com.squareup.leakcanary:leakcanary-support-fragment:1.6.1',
            "debug-db"                 : 'com.amitshekhar.android:debug-db:1.0.4'
    ]
    commonDeps = [
            "multidex": 'com.android.support:multidex:1.0.3',
            "logger"  : 'com.orhanobut:logger:2.2.0',
            "glide"   : 'com.github.bumptech.glide:glide:4.8.0',
            "eventbus": 'org.greenrobot:eventbus:3.1.1',
            "spinkit" : 'com.github.ybq:Android-SpinKit:1.2.0',
            "arouter" : 'com.alibaba:arouter-api:1.4.0'
    ]
    otherDeps = [
            "arouter-compiler": 'com.alibaba:arouter-compiler:1.2.1'
    ]
    supportLibs = supportDeps.values()
    networkLibs = retrofit.values()
    rxJavaLibs = rxJava.values()
    commonLibs = commonDeps.values()
}

复制代码

最后别忘记在工程的中 build.gradle 引入该配置文件

apply from: "config.gradle"
复制代码

4、业务模块之间交互

业务模块之间的跳转能够经过路由(Arouter)实现;业务模块之间的通讯能够经过消息(EventBus)来实现。

一、Arouter 实现业务模块之间的跳转

咱们在以前已经依赖了 Arouter (详细用法参照:github.com/alibaba/ARo…),用它来实现跳转只须要如下两步:

第一步

  • gradle 配置
kapt {
    arguments {
        arg("AROUTER_MODULE_NAME", project.getName())
    }
    generateStubs = true
}
dependencies {
...
    kapt rootProject.ext.otherDeps["arouter-compiler"]
}
复制代码

第二步

  • 须要指明目标页面以及要带的参数,而后在调用 navigation() 方法;

第三步

  • 首先在 onCreate 方法调用 ARouter.getInstance().inject(this) 注入;
  • 而后要用 @Route 注解标注页面,并在 path 变量中给页面定义一个路径;
  • 最后对于传送过来的变量咱们直接定义一个同名的字段用 @Autowired 变量标注,Arouter 会对该字段自动赋值

二、EventBus 实现业务模块之间的通信

利用第三方如 EventBus 对消息进行管理。在 baselibs 组件中的 BaseActivityBaseFragment 类作了对消息的简单封装,子类只须要重写 useEventBus() 返回 true 便可对事件的注册。

5、搭建过程当中遇到的问题

一、AndroidManifest

咱们知道 APP 在打包的时候最后会把全部的 AndroidManifest 进行合并,因此每一个业务组件的 Activity 只须要在各自的模块中注册便可。

若是业务组件要单独运行,则须要单独的一个 AndroidManifest ,在 gradlesourceSets 加载不一样的 AndroidManifest 便可。

gradle 配置

android {
...
    sourceSets {
        main {
            if (isModule.toBoolean()) {
                manifest.srcFile 'src/main/module/AndroidManifest.xml'
            } else {
                manifest.srcFile 'src/main/AndroidManifest.xml'
                //集成开发模式下排除debug文件夹中的全部Java文件
                java {
                    exclude 'debug/**'
                }
                kotlin {
                    exclude 'debug/**'
                }
            }
        }
    }
...
}
复制代码

注意:集成模式下的 AndroidManifest 不须要配置 Application ,组件模式下的 AndroidManifest 须要单独配置 Application ,而且必须继承 BaseApp 。

二、资源文件冲突的问题

不一样业务组件里的资源文件的名称可能相同,因此就可能出现资源文件冲突的问题,咱们能够经过设置资源的前缀来防止资源文件的冲突。

gradle 配置,以 module_news 模块为例

android {
...
    resourcePrefix "news_"
...
}
复制代码

这样配置之后,若是咱们在命名资源文件没有加前缀的时候,编译器就会提示咱们没加前缀。

至此, Android 基本组件化框架已经搭建完成,若有错误之处还请指正。

5、最后

完整的项目地址:github.com/iceCola7/An…

相关文章
相关标签/搜索