半小时入门Qigsaw,你信不?

时间:2021-7-21 作者:qvyue

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

QigsawBundle 打包的特点

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

root build.gradle

dependencies {
    classpath "com.gitee.DonaldDu.QigsawBundle:Plugin:$qigsawBundleV"
}

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()
            buildConfigField "String", 'dynamicFeatures', dynamicFeatures.join(',').quote()//必需的
        }
        buildTypes {
            debug {
                buildConfigField "String", 'VERSION_TYPE', qigsawBundleOption.debugType.quote()
            }
            release {
                buildConfigField "String", 'VERSION_TYPE', qigsawBundleOption.releaseType.quote()
            }
        }
    }
}
qigsawBundleOption.publishTool

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

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
}

存在的问题

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

经验之谈

  1. 一定要在应用启动时,默认加载所有已安装的插件,不然新进程的代码会找不到类。
  2. 个人觉得没必要开签名验证(verifySignature),因为已经有MD5验证了。
  3. 建议用最新的ActivityResultLauncher来启动插件,非常方便。
  4. 启动模块页面建议用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上的。

  • 更多详细信息,请参考 Demo,打包工具项目地址 QigsawBundle, 最新依赖-jitpack

  • QigsawBundle技术细节

  • 安装Base时,可以根据需要在设置中选择是否一起安装插件,测试时可以选择一起安装,不用下载插件就能直接运行。

    半小时入门Qigsaw,你信不?
    QQ图片20210401002626.png

最后

如果本文帮助到了你,也帮我点个赞吧!

如果你愿意,还可以赞赏一杯咖啡或一瓶水,非常感觉你的慷慨!

声明:本文内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:qvyue@qq.com 进行举报,并提供相关证据,工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。