複数の AAR を 1 つの AAR にパッケージ化

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,提供给外部手动依赖:

  1. 先定义内部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"))
}
  1. 定义三个集合:
//所有的内部库依赖
Map<String, String> allInnerDeps = new HashMap<>()
//所有的非内部依赖:公共平台库
Map<String, String> allCommonDeps = new HashMap<>()
//库的类型,jar 或者 aar,依赖方式不同
Map<String, String> depType = new HashMap<>()
  1. 分析依赖,放到不同集合打印、合并:

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. 参考资料

使用fat-aar编译打包多个aar库 - 简书

fat-aar实践及原理分享 - 简书

github.com/kezong/fat-…

GitHub - adwiv/android-fat-aar: Gradle script that allows you to merge and embed dependencies in generted aar file

5. 总结

本文介绍了Android对外输出AAR和不依赖maven,通过合并多个AAR的方式减少依赖方成本,并介绍了实际使用过程中遇到的问题和解决方案。

おすすめ

転載: juejin.im/post/7250377976134615097