【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