組件化開發的主要步驟: 一、新建Modules 1、新建Project,作為應用的主Module。 2、新建Module:"Common",類型選擇"Android Library",作為所有其它Module的基礎依賴庫。 3、新建Module:"Home",類型選擇"Android Library ...
組件化開發的主要步驟:
一、新建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目錄下新建debug和release目錄,在新建的兩個目錄下,分別新建AndroidManifest.xml文件。以Home模塊為例:
Debug模式下的AndroidManifest.xml
Release模式下的AndroidManifest.mxl
在Home下的build.gradle文件中配置AndroidManifest.xml
sourceSets {
main {
if (isDebug.toBoolean()) {
manifest.srcFile 'src/debug/AndroidManifest.xml'
} else {
manifest.srcFile 'src/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