1. 背景の紹介
同社の日々の開発は、一般には公開されていない自社構築の Maven サーバーに基づいて行われています。社内で開発された SDK はプライベート サーバーに渡されます。何年もの繰り返しを経て、数百のパッケージが存在します。以前は、他の企業は内部 SDK に依存する必要があり、この SDK は企業の多くの SDK に依存していますが、企業のイントラネット権限を外部に公開できないため、Maven を使用して外部依存関係を提供することはできません。 AAR メソッドに基づくと、十数個の AAR を外部に提供するのは不親切であるだけでなく、内部での保守と反復も困難です。
2. 解決策と解決策
市場には AAR をマージするためのオープンソース ソリューションがあり、AAR をマージする主な手順は次のとおりです。
- Androidマニフェストのマージ
- クラスが統合されました
- Jarマージ
- 解像度のマージ
- アセットのマージ
- JNIが合併しました
- R.txt がマージされました
- R.クラスのマージ
- データバインディングマージ
- プロガードが統合されました
- Kotlin モジュールのマージ
これらには対応する Gradle タスクがあり、特定の解決策は対応するソース コードで見つけることができます: adwiv /android-fat-aarは維持されなくなり、gradle は上位バージョンをサポートしません。 、AGP 3.0 ~ 7.1.0、Gradle 4.9 ~ 7.3 に適応されています。
3. 問題がある
3.1 リソースの競合
ライブラリとモジュールに同じ名前のリソース (例: string/app_name
) が含まれている場合、コンパイルでduplication resources
関連エラーが報告されます。この問題を解決するには、次の 2 つの方法があります。
- リソースの競合を避けるために、ライブラリとモジュールのリソースにプレフィックスを追加します (SDK のすべての過去のバージョンがこの仕様に従っているわけではありません)。
- のリソース競合を無視できるコンパイル エラー
gradle.properties
を追加するandroid.disableResourceValidation=true
と、プログラムは実際のリソースと同じ名前で最初に見つかったリソースを使用します (リソースの上書きによりエラーが発生する可能性があります)。
3.2 動的ライブラリの競合
アプリケーション内の動的ライブラリの競合では、pickFirst を使用して最初のライブラリを指定できますが、これをライブラリに適用することはできません。
关于packagingOptions常见的设置项有exclude、pickFirst、doNotStrip、merge。
1. exclude,过滤掉某些文件或者目录不添加到APK中,作用于APK,不能过滤aar和jar中的内容。
比如:
packagingOptions {
exclude 'META-INF/**'
exclude 'lib/arm64-v8a/libopus.so'
}
2. pickFirst,匹配到多个相同文件,只提取第一个。只作用于APK,不能过滤aar和jar中的文件。
比如:
packagingOptions {
pickFirst "lib/armeabi-v7a/libopus.so"
pickFirst "lib/armeabi-v7a/libopus.so"
}
3. doNotStrip,可以设置某些动态库不被优化压缩。
比如:
packagingOptions{
doNotStrip "*/armeabi/*.so"
doNotStrip "*/armeabi-v7a/*.so"
}
4. merge,将匹配的文件都添加到APK中,和pickFirst有些相反,会合并所有文件。
比如:
packagingOptions {
merge '**/LICENSE.txt'
merge '**/NOTICE.txt'
}
最后针对包含冲突动态库的SDK,单独对外依赖,在application中pickfirst,暂时没有特别好的方法。
3.3 外部依赖库
SDK中有些依赖的是外部公共仓库,比如OKHTTP等,如果都合并到同一的AAR,会导致外部依赖不够灵活,我们的思路是合并的时候不合并外部SDK,只打包公司内部SDK,并打印外部依赖的SDK,提供给外部手动依赖:
- 先定义内部SDK规则方法:
static boolean isInnerDep(RenderableDependency dep) {
return (dep.name.contains("com.xxx")
|| dep.name.contains("com.xxxxx")
|| dep.name.contains("com.xxxxxxx")
|| dep.name.contains("com.xxxxxxxx"))
}
- 定义三个集合:
//所有的内部库依赖
Map<String, String> allInnerDeps = new HashMap<>()
//所有的非内部依赖:公共平台库
Map<String, String> allCommonDeps = new HashMap<>()
//库的类型,jar 或者 aar,依赖方式不同
Map<String, String> depType = new HashMap<>()
- 分析依赖,放到不同集合打印、合并:
void collectDependencies(Map<String, String> commonDependencies, Map<String, String> innerDependencies, RenderableDependency result) {
String depName = result.name.substring(0, result.name.lastIndexOf(":"))
// println "denName = " + depName
String version = result.name.substring(result.name.lastIndexOf(":") + 1, result.name.length())
if (result.getChildren() != null && result.getChildren().size() > 0) {
if (isInnerDep(result) && !isExcludeDep(result)) {
tryToAdd(innerDependencies, depName, version)
result.getChildren().each {
res ->
collectDependencies(commonDependencies, innerDependencies, res)
}
} else {
tryToAdd(commonDependencies, depName, version)
}
} else {
if (isInnerDep(result) && !isExcludeDep(result)) {
tryToAdd(innerDependencies, depName, version)
} else {
tryToAdd(commonDependencies, depName, version)
}
}
}
configurations.findAll { conf ->
return conf.name == "implementation" || conf.name == "api"
}.each {
conf ->
// println "--------------"+conf.name
def copyConf = conf.copy()
copyConf.setCanBeResolved(true)
copyConf.each {
file ->
String s = file.name.substring(0, file.name.lastIndexOf("."))
String key
if (s.contains("-SNAPSHOT")) {
String t = (s.substring(0, s.lastIndexOf("-SNAPSHOT")))
key = t.substring(0, t.lastIndexOf("-"))
} else {
key = s.substring(0, s.lastIndexOf("-"))
}
String value = file.name.substring(file.name.lastIndexOf("."), file.name.length())
depType.put(key, value)
}
ResolutionResult result = copyConf.getIncoming().getResolutionResult()
RenderableDependency depRoot = new RenderableModuleResult(result.getRoot())
depRoot.getChildren().each {
d ->
collectDependencies(allCommonDeps, allInnerDeps, d)
}
}
println("==================内部依赖====================")
allInnerDeps.each {
dep ->
println dep.key + ":" + dep.value
dependencies {
String key = dep.key.substring(dep.key.lastIndexOf(":") + 1, dep.key.length())
String type = depType.get(key)
if (type == ".aar") {
embed(dep.key + ":" + dep.value + "@aar")
} else {
embed(dep.key + ":" + dep.value)
}
}
}
println "=====================正确使用 sdk,需要添加如下依赖========================"
allCommonDeps.each {
dep ->
println "api " + """ + dep.key + ":" + dep.value + """
}
3.4 对外提供多个业务SDK
我们提供一个同一AAR后,另一个业务也要对外提供SDK,这样有公共依赖的就会有冲突问题,如果都合并成一个,某一方改动,势必会引起另一方回归测试,最后抽取公共的sdk合并成一个aar,各自业务合并各自的AAR。
4. 参考资料
5. 总结
本文介绍了Android对外输出AAR和不依赖maven,通过合并多个AAR的方式减少依赖方成本,并介绍了实际使用过程中遇到的问题和解决方案。