【Android】组件化开发的简单应用

组件化开发的主要步骤：

1、新建Modules

一、新建Project,做为应用的主Module。

二、新建Module:"Common"，类型选择"Android Library",做为全部其它Module的基础依赖库。

三、新建Module:"Home"，类型选择"Android Library",依赖"Common"。

四、新建Module:"Project"，类型选择"Android Library",依赖"Common"。

五、新建Module:"User"，类型选择"Android Library",依赖"Common"。

具体新建怎样的Module，能够根据实际业务来调整。这里选择新建"Home"、"Project"、"User"来模拟业务。

2、增长Flag以便在release和debug模式下切换

一、在gradle.properties文件中增长一个变量

isDebug = false

当isDebug为true时，为Debug模式，其它的Module能够做为单独的App运行。当isDebug为false时，为Release模式，其它的Module为Library模式，不能单独运行,此时只有主App能够运行。

二、修改app的build.gradle文件

implementation project(':common')
if (!isDebug.toBoolean()) {
    implementation project(':home')
    implementation project(':project')
    implementation project(':user')
}

三、修改home的build.gradle文件

if (isDebug.toBoolean()) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}

四、修改project的build.gradle文件

if (isDebug.toBoolean()) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}

五、修改user的build.gradle文件

if (isDebug.toBoolean()) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}

为便于各Module单独调试开发，能够在各Module下根据isDebug的变量区分模式。

切换工程到Project模式下，将原来的AndroidManifest.xml文件移除，在Module的src/main目录下新建debug和release目录，在新建的两个目录下，分别新建AndroidManifest.xml文件。以Home模块为例：

Debug模式下的AndroidManifest.xml

Release模式下的AndroidManifest.mxl

在Home下的build.gradle文件中配置AndroidManifest.xml

sourceSets {
    main {
        if (isDebug.toBoolean()) {
            manifest.srcFile 'src/main/debug/AndroidManifest.xml'
        } else {
            manifest.srcFile 'src/main/release/AndroidManifest.xml'
            java { exclude 'debug/**' }
        }
    }
}

其它Module也是类似的处理。

3、统一管理Module版本号

一、为便于统一管理版本号，在项目的根目录下的build.gradle文件中增长统一的版本号:

ext {
    compileSdkVersion = 28

    minSdkVersion = 21
    targetSdkVersion = 28
    versionCode = 1
    versionName = "1.0"
}

二、在其它Module下相应修改

App模块:

Common模块:

Home模块:

Project模块:

User模块:

4、各Module间通讯

为解决各Module间通讯的问题，引入ARouter框架。GitHub地址：ARouter

为避免各Module重复引用，在Common中引用一次，其它Module复用便可。

注意：因为其它依赖Common的Module也须要使用Arouter，所以在引入时，须要把implementation改成api。若是使用implementation,其它Module会没法使用Arouter。

其它Module中使用:

不须要再次implementation,可是仍是须要在dependencies增长

annotationProcessor 'com.alibaba:arouter-compiler:1.2.2'

以及在android-defaultConfig中增长：

javaCompileOptions {
        annotationProcessorOptions {
            arguments = [AROUTER_MODULE_NAME: project.getName()]
        }
    }

注意："AROUTER_MODULE_NAME"这个名称，不能够改成其它字符串，不然会编译报错。

在Common模块下增长BaseApplication,对ARouter进行初始化。

public class BaseApplication extends Application {

    private boolean isDebugARouter = true;

    @Override
    public void onCreate() {
        super.onCreate();

        if (isDebugARouter) {
            ARouter.openLog();
            ARouter.openDebug();
        }
        ARouter.init(this);
    }
}

在主Module:App中增长App,继承自BaseApplication,而后在AndroidManifefst.xml中引用。

public class App extends BaseApplication {}

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.wangyz.modules">

    <application
        android:name=".App"
        android:allowBackup="true"
        android:appComponentFactory="whateverString"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        tools:replace="android:appComponentFactory">

        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
</manifest>

对于须要被调用的Activity或者Fragment增长注解：

能够新建一个常量类，用来保存这些路由地址。这里出于简化，没有再定义这个常量类。

调用方使用ARouter：

Fragment fragment = (Fragment) ARouter.getInstance().build("/home/fragment").navigation();
mFragmentManager.beginTransaction().replace(R.id.container, fragment).commit();

5、ButterKnife的引入

ButterKnife在单Module中使用时，比较简单，当在多Module下使用时，仍是有些须要注意的事项。具体引用步骤以下:

一、在项目根目录的build.gradle中引入依赖:

dependencies {
        classpath 'com.android.tools.build:gradle:3.1.4'
        classpath 'com.jakewharton:butterknife-gradle-plugin:9.0.0'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }

在common中引入依赖:

api 'com.jakewharton:butterknife:9.0.0'
annotationProcessor 'com.jakewharton:butterknife-compiler:9.0.0'

在具体使用ButterKnife的Module中引入依赖:

apply plugin: 'com.jakewharton.butterknife'

annotationProcessor 'com.jakewharton:butterknife-compiler:9.0.0'

和ARouter同样，使用ButterKnife的Module虽然不用重复引用butterknife自己这个库，可是注解相关的库仍是须要引用。

具体使用：

@BindView(R2.id.click)
TextView mText;

BindView的时候，须要使用R2.id.xx

@OnClick(R2.id.click)
public void click() {
    Toast.makeText(getActivity().getApplicationContext(), "click", Toast.LENGTH_SHORT).show();
}

对应的点击事件等，若是是单个使用，也是使用R2.id.xx。若是是多个id一块儿使用，内部经过id来判断，则须要使用if...else if...，不能使用switch...case，而且if判断的id须要使用R.id.xx

默认是会报错，找不到R2相关的class，须要手动build一次才会生成。

注意：ButterKnife.9.0之后，须要jdk版本1.8以上，不然编译会报错。

源码地址：https://github.com/milovetingting/Samples/tree/master/Modules