最近公司在做一款新的車機(jī) Launcher琼富，需要將一個(gè)類似QQ音樂(lè)凛虽、喜馬拉雅的音頻模塊放入其中，整體作為一個(gè) Launcher偿短，雖然產(chǎn)品一再確定欣孤，后面不會(huì)進(jìn)行拆分，但是小心為上昔逗，將 Launcher 和 音頻軟件分為兩個(gè) App 開發(fā)降传，兩個(gè)團(tuán)隊(duì)開發(fā)互不影響，最后通過(guò)組件化勾怒，作為 module 引入到空殼App中婆排。
整體思路
這里寫個(gè)組件化二維碼掃描的 Demo 声旺，①空殼 App，②公共 Library段只，③第一個(gè) App 類似于上面說(shuō)的 Launcher腮猖，④第二個(gè) App 類似于上面說(shuō)的音頻 App。
其中③赞枕、④均是可單獨(dú)運(yùn)行的 module澈缺，都依賴于②，當(dāng)運(yùn)行①時(shí)炕婶，需要將③姐赡、④轉(zhuǎn)換為 library 去依賴。
那么需要解決的第一個(gè)問(wèn)題就是古话，如何在 app 和 library 直接切換雏吭。
切換 application 和 library 屬性
切換 module 的 application 和 library，需要在 gradle.properties 里面進(jìn)行配置陪踩，因?yàn)檫@里面的變量都是全局的杖们，全部 gradle 都可以取到。
在最后一行增加一個(gè)標(biāo)記變量 isModule=true肩狂，我這里用 true 表示 application摘完，false 表示 library。
# Project-wide Gradle settings.
# IDE (e.g. Android Studio) users:
# Gradle settings configured through the IDE *will override*
# any settings specified in this file.
# For more details on how to configure your build environment visit
# http://www.gradle.org/docs/current/userguide/build_environment.html
# Specifies the JVM arguments used for the daemon process.
# The setting is particularly useful for tweaking memory settings.
org.gradle.jvmargs=-Xmx1536m
# When configured, Gradle will run in incubating parallel mode.
# This option should only be used with decoupled projects. More details, visit
# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
# org.gradle.parallel=true
isModule=false
下面就可以修改 module 的 build.gradle 判斷操作了傻谁。
if (isModule.toBoolean()) {// ① 切換
apply plugin: 'com.android.application'
} else {
apply plugin: 'com.android.library'
}
apply plugin: 'com.jakewharton.butterknife'
def config = rootProject.ext// 定義變量
android {
compileSdkVersion config.android.compileSdkVersion
defaultConfig {
if (isModule.toBoolean()) {// ② library沒(méi)有applicationId
applicationId "com.ff.modulea"
}
minSdkVersion config.android.minSdkVersion
targetSdkVersion config.android.targetSdkVersion
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
sourceSets {
main {
// ③ 加載不同位置的AndroidManifest
if (isModule.toBoolean()) {
manifest.srcFile 'src/main/module/AndroidManifest.xml'
} else {
manifest.srcFile 'src/main/AndroidManifest.xml'
}
}
}
compileOptions {
// ButterKnife 需要Java 8
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
lintOptions {
// 禁用Google Search
disable 'GoogleAppIndexingWarning'
}
}
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
annotationProcessor "com.jakewharton:butterknife-compiler:$config.dependencies.butterknife"
api project(':baselib')
}
主要看上面①孝治、②、③ 處代碼审磁，主要說(shuō)下③谈飒，可以通過(guò)修改 SourceSets 中的屬性，修改 AndroidManifest 默認(rèn)的加載路徑态蒂，更多SourceSets介紹與使用杭措。
先看下作為 library 時(shí)的 AndroidManifest，上圖①處钾恢。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.ff.moduleb">
<application>
<activity
android:name="com.ff.moduleb.CaptureActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:screenOrientation="portrait" />
</application>
</manifest>
再對(duì)比下作為 application 的 AndroidManifest手素，上圖②處。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.ff.moduleb">
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".CaptureActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
為什么需要加載不同的 AndroidManifest 瘩蚪？
一是泉懦，因?yàn)?library 清單文件不需要指明 application 內(nèi)容；二是疹瘦，并不是每個(gè) Activity 都是 App 第一個(gè)啟動(dòng)的 Activity崩哩。
還需要注意一點(diǎn)，由于組件化拱礁，可能會(huì)導(dǎo)致每個(gè) module 之間依賴的遠(yuǎn)程倉(cāng)庫(kù)版本不一致琢锋，出現(xiàn)異常情況辕漂，所以這里使用 config.gradle 統(tǒng)一配置版本呢灶。
ext {
android = [
compileSdkVersion: 28,
minSdkVersion : 19,
targetSdkVersion : 28
]
dependencies = [
arouter_api : "1.4.1",
arouter_compiler: "1.2.2",
butterknife : "9.0.0",
zxing : "3.3.3"
]
supportVersion = "28.0.0"
}
只需要在項(xiàng)目的 build.gradle 中引入即可使用吴超，更多詳細(xì)介紹。
// Top-level build file where you can add configuration options common to all sub-projects/modules.
apply from: "config.gradle"http:// 引入config.gradle
buildscript {
repositories {
google()
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.3.2'
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
}
}
allprojects {
repositories {
google()
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
空殼 App
里面沒(méi)有任何 java 代碼鸯乃。
只有一個(gè) AndroidManifest鲸阻，指明 application，我們會(huì)把 BaseApplication 放在 baselib 中缨睡。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.ff.module">
<application
android:name="com.ff.baselib.base.BaseApplication"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme" />
</manifest>
唯一依賴是 baselib 庫(kù)中的 BaseApplication鸟悴。
apply plugin: 'com.android.application'
def config = rootProject.ext
android {
compileSdkVersion config.android.compileSdkVersion
defaultConfig {
applicationId "com.ff.ui"
minSdkVersion config.android.minSdkVersion
targetSdkVersion config.android.targetSdkVersion
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
compileOptions {
// ButterKnife 需要Java 8
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
lintOptions {
// 禁用Google Search
disable 'GoogleAppIndexingWarning'
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
if (isModule.toBoolean()) {
// 依賴baselib中的BaseApplication
implementation project(':baselib')
} else {
// modulea和moduleb中依賴了baselib
implementation project(':modulea')
implementation project(':moduleb')
}
}
公用的 Library
這里面可以放基類、工具類奖年、常量细诸、權(quán)限聲明、圖片網(wǎng)絡(luò)框架等等陋守。
我這里放入了一些常量震贵，BaseApplication，BaseActivity水评，二維碼掃描的 jar 包猩系。
至于 ButterKnife 需要如何引入，可以看下 ButterKnife最新版本使用的深坑中燥。
apply plugin: 'com.android.library'
// 雖然在library中使用butterknife寇甸，但僅在BaseActivity中bind，
// 不需要尋找控件疗涉，也就不需要生成R2拿霉，所以無(wú)需添加plugin
// apply plugin: 'com.jakewharton.butterknife'
def config = rootProject.ext// 定義變量
android {
compileSdkVersion config.android.compileSdkVersion
defaultConfig {
minSdkVersion config.android.minSdkVersion
targetSdkVersion config.android.targetSdkVersion
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
api "com.android.support:appcompat-v7:$config.supportVersion"
api "com.jakewharton:butterknife:$config.dependencies.butterknife"
// 僅在BaseActivity中bind，不需要尋找控件咱扣，也就不需要生成java文件绽淘，無(wú)需使用annotationProcessor
// annotationProcessor "com.alibaba:arouter-compiler:$config.dependencies.arouter_compiler"
api files('libs/zxing.jar')
}
權(quán)限聲明，可以都放在這個(gè) AndroidManifest 中偏窝。
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.ff.baselib">
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
</manifest>
組件 module
上面已經(jīng)設(shè)置好收恢，切換 module 的 application 和 library 屬性，這里就沒(méi)有什么其他工作了祭往。
注意不同 module 間的 layout 文件不要重名伦意，不然會(huì)出現(xiàn)找不到的現(xiàn)象，類名可以重復(fù)硼补，因?yàn)槊總€(gè) module 的包名是不一樣的驮肉，要是每個(gè) module 的包名都一樣我就無(wú)語(yǔ)了。
組件間跳轉(zhuǎn)
比如我們這里需要 modulea 中的 MainActivity 需要跳轉(zhuǎn)到 moduleb 中到 CaptureActivity 這個(gè)就需要使用路由框架了已骇，這里推薦阿里開源的路由框架 ARouter离钝，使用很便捷票编。
添加依賴和配置
官方示例代碼：
android {
defaultConfig {
...
javaCompileOptions {
annotationProcessorOptions {// ①
arguments = [AROUTER_MODULE_NAME: project.getName()]
}
}
}
}
dependencies {
// 替換成最新版本, 需要注意的是api
// 要與compiler匹配使用，均使用最新版可以保證兼容
compile 'com.alibaba:arouter-api:x.x.x'// ②
annotationProcessor 'com.alibaba:arouter-compiler:x.x.x'// ②
...
}
- 首先卵渴，要注意的是①慧域、③處代碼，需要同時(shí)出現(xiàn)浪读，不然會(huì)報(bào)錯(cuò)：
ARouter::Compiler >>> No module name, for more information, look at gradle log.
- 在新版本中需要使用 api 代替 compiler：
dependencies {
api 'com.alibaba:arouter-api:x.x.x'
...
}
- com.alibaba:arouter-api 中的 v4 包是 25 的昔榴，與我引入的 v7 包沖突（一般 v7 都包含 v4），所以需要使用 exclude 移除 com.alibaba:arouter-api 里面的 v4 包：
dependencies {
implementation fileTree(include: ['*.jar'], dir: 'libs')
api "com.android.support:appcompat-v7:$config.supportVersion"
// arouter-api中包含了v4包碘橘，與上面v7包中的v4沖突了
api("com.alibaba:arouter-api:$config.dependencies.arouter_api") {
// 默認(rèn)情況下v7中是包含V4包的互订，exclude的意思是去除v4包，這樣就可以解決沖突了
exclude module: 'support-v4'// 根據(jù)組件名排除
exclude group: 'com.android.support'// 根據(jù)包名排除
}
}
關(guān)于 exclude 可以看 com.android.support版本沖突的解決辦法痘拆。
添加注解
官方示例代碼：
// 在支持路由的頁(yè)面上添加注解(必選)
// 這里的路徑需要注意的是至少需要有兩級(jí)仰禽，/xx/xx
@Route(path = "/test/activity")
public class YourActivity extend Activity {
...
}
初始化SDK
官方示例代碼：
if (isDebug()) { // 這兩行必須寫在init之前，否則這些配置在init過(guò)程中將無(wú)效
ARouter.openLog(); // 打印日志
ARouter.openDebug(); // 開啟調(diào)試模式(如果在InstantRun模式下運(yùn)行纺蛆，必須開啟調(diào)試模式吐葵！線上版本需要關(guān)閉,否則有安全風(fēng)險(xiǎn))
}
ARouter.init(mApplication); // 盡可能早，推薦在Application中初始化
發(fā)起路由操作
官方示例代碼：
// 1. 應(yīng)用內(nèi)簡(jiǎn)單的跳轉(zhuǎn)(通過(guò)URL跳轉(zhuǎn)在'進(jìn)階用法'中)
ARouter.getInstance().build("/test/activity").navigation();
// 2. 跳轉(zhuǎn)并攜帶參數(shù)
ARouter.getInstance().build("/test/1")
.withLong("key1", 666L)
.withString("key3", "888")
.withObject("key4", new Test("Jack", "Rose"))
.navigation();
具體的使用犹撒，包括 startActivityForResult 的實(shí)現(xiàn)折联，就不在這里粘出來(lái)了，可以下載demo看下识颊。
github項(xiàng)目地址
其他注意點(diǎn)
組件化開發(fā)中诚镰，資源文件不要重名，建議使用組建名作為前綴祥款。
參考資料
Android組件化方案
Android組件化初探
解決v4,v7包沖突問(wèn)題
探索Android路由框架-ARouter之基本使用
