半小时入门Qigsaw，你信不？

首先你要对AAB有一定了解，然后这就够了！看完下面的介绍，再运行下Demo差不多就入门了！

输出ApkMd5稳定，未修改的插件打包基本固定不变。可以做到Base独立升级，插件不变。要做到稳定请参考稳定混淆App
稍作修改，可以实现上传AAB给后台打包发更新（当前不支持）。

root build.gradle

ext.qigsawBundle = {
    apply plugin: 'qigsaw-bundle'
    qigsawBundleOption {
        log = true//是否打印日志
        debugType = '0'
        releaseType = '1'
        apkFileHost = getApkHost()//可以写死
        publishTool = rootProject.file('publish/build/libs/publish-all.jar')//PUBLISH_TOOL's JAR
//      publishTool = 'com.donald.publish.Main'//PUBLISH_TOOL's CLASS
        fileNameFormat = "{appId}-{split}-{abi}-t{type}-v{version}-{md5}"
        options = [
                '--ks=' + file("../keystore/debug.jks"),
//              "--connected-device",//fixme 启用这个，打测试包更快。正式包必须注释这个。
                "--ks-pass=pass:qigsawtest",
                '--ks-key-alias=qigsawtest',
                "--key-pass=pass:qigsawtest"
        ]
    }
    android {
        defaultConfig {
            buildConfigField "String", 'apkFileHost', qigsawBundleOption.apkFileHost.quote()
        }
        buildTypes {
            debug {
                buildConfigField "String", 'VERSION_TYPE', qigsawBundleOption.debugType.quote()
            }
            release {
                buildConfigField "String", 'VERSION_TYPE', qigsawBundleOption.releaseType.quote()
            }
        }
    }
}

qigsawBundleOption.publishTool

QigsawBundle调用时，会传入两个参数。

release：正式或测试

dir：文件夹路径

解析所有文件，实现上传即可。具体使用参考demo模块publish/main 方法。

用来指定发布开发者自己应用的工具，可以是JAR路径，也可以是类名。如果是类名的话，需要在root中引用依赖。具体依赖由用户而定，以下是Demo中publish模块发布到本地的依赖项。

classpath "com.gitee.DonaldDu:QigsawPublish:1.0"//PUBLISH_TOOL'S CLASS

qigsawBundleOption.fileNameFormat

用来格式化打包输出的文件名（包括APK和JSON），不能带后缀，可以用部分占位符。

{appId}： applicationId
{split}： SplitName
{abi}: master/x86/arm64-v8a ...
{type}: debugType/releaseType
{version}：versionName@versionCode -> 1.0@1
{md5}： APK为ApkMd5，其它为文件MD5

qigsawBundleOption.apkFileHost

打包输出APK链接地址的前缀，如果能确定上传后文件的URL，可以写上准确值。不能确定的可以随意写个占位就行。

qigsawBundleOption.options

这设置项是Google bundletool 标准命令，详情参考官方文档。

==特别说明== 请把 bundletool.jar 下载并保存到‘.gradle’目录中，并在‘init.gradle’中增加如下定义。也可以保存在其它路径，但定义的路径一定要对。

allprojects {
    ext.BUNDLE_TOOL_PATH = new File(gradle.gradleUserHomeDir, "bundletool.jar").absolutePath
}

qigsawBundleOption.debugType/releaseType

用来区分打包输出文件版本类型，方便上传。String类型，值由用户指定。

base build.gradle

android {}
with(qigsawBundle)//after android inited
dependencies {
    implementation "com.gitee.DonaldDu:QigsawSplitDownloader:1.0.1"//下载器可以自己实现，这是个简单实现。
    implementation "com.gitee.DonaldDu.QigsawBundle:Compat:$qigsawBundleV"
    api "com.gitee.DonaldDu.Qigsaw:splitcore:2.0.2"
}

QigsawSplitDownloader

QigsawSplitDownloader 项目地址

支持缓存的下载器，相同ApkMd5的文件只会下载一次。

CompatBundle

需要用户继承BaseCompatBundle实现自己的CompatBundle。

因为这个类是用ServiceLoader加载的，所以需要把类名写在以下文件中

app/src/main/resources/META-INF/services/com.iqiyi.android.qigsaw.core.common.ICompatBundle

/**
 * ServiceLoader for ICompatBundle
 * */
class CompatBundle : BaseCompatBundle() {
    override fun qigsawConfigClass(): Class<*> = QigsawConfig::class.java
}

存在的问题

所有特性和标准AAB一样
下载的资源类插件时，需要手动注入后才能在当前页面访问，否则会找不到而报错。
暂不支持内置插件。
==不支持插件内Application==（Qigsaw支持）
==需要处理不同Base版本的插件列表文件不能分发错乱。== DEMO项目中未处理此问题，默认兼容所有版本了。

经验之谈

一定要在应用启动时，默认加载所有已安装的插件，不然新进程的代码会找不到类。
个人觉得没必要开签名验证（verifySignature），因为已经有MD5验证了。
建议用最新的ActivityResultLauncher来启动插件，非常方便。
启动模块页面建议用URI来实现，不建议用DEMO中的枚举，这里只是方便而已，但不够灵活，不能适应业务变动。

local.properties

DEMO项目local.properties定义了apkFileHost，用户可以修改为自己的IP

apkFileHost=http://192.168.31.15/

proguard

发布正式更新后，可以把mapping.txt复制到base目录以替换旧的。然后在以下文件中启用mapping。测试中不需要用旧mapping文件时，可以注释掉。

base-proguard-rules

-applymapping mapping.txt

其它说明

只需要在base中引用 'qigsaw-bundle' Plugin 就行了，dynamic-feature 不需要任何额外的操作，和标准AAB一样。
每个 dynamic-feature 都可以设置自己的“proguard-rules”，不用都在base中设置，公共的可以写在base中。
运行项目下的‘StartWebServer.bat’可以启动一个服务，demo中的发布代码就能上传应用，运行的Base也可以下载插件。
为了保证Base能下载插件，请确保apkFileHost地址是对的。
因为这个工具应该主要是国人用，国外都用标准AAB，所以这个项目代码放在gitee上的。但用jitpack打包时常出问题，所以又弄到github上了。
更多详细信息，请参考 Demo，打包工具项目地址 QigsawBundle，
最新依赖-jitpack
QigsawBundle技术细节
安装Base时，可以根据需要在设置中选择是否一起安装插件

image