【Android】組件化開發的簡單應用

個人博客:
http://www.milovetingting.cn

組件化開發的主要步驟：

一、新建Modules

1、新建Project,作為應用的主Module。

2、新建Module:"Common"，類型選擇"Android Library",作為所有其它Module的基礎依賴庫。

3、新建Module:"Home"，類型選擇"Android Library",依賴"Common"。

4、新建Module:"Project"，類型選擇"Android Library",依賴"Common"。

5、新建Module:"User"，類型選擇"Android Library",依賴"Common"。

具體新建怎樣的Module，可以根據實際業務來調整。這里選擇新建"Home"、"Project"、"User"來模擬業務。

二、增加Flag以便在release和debug模式下切換

1、在gradle.properties文件中增加一個變量

isDebug = false

當isDebug為true時，為Debug模式，其它的Module可以作為單獨的App運行。當isDebug為false時，為Release模式，其它的Module為Library模式，不能單獨運行,此時只有主App可以運行。

2、修改app的build.gradle文件

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

3、修改home的build.gradle文件

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

4、修改project的build.gradle文件

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

5、修改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也是相似的處理。

三、統一管理Module版本號

1、為便於統一管理版本號，在項目的根目錄下的build.gradle文件中增加統一的版本號:

ext {
    compileSdkVersion = 28

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

2、在其它Module下相應修改

App模塊:

Common模塊:

Home模塊:

Project模塊:

User模塊:

四、各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();

五、ButterKnife的引入

ButterKnife在單Module中使用時，比較簡單，當在多Module下使用時，還是有些需要注意的事項。具體引用步驟如下:

1、在項目根目錄的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