1.下载打包工具

patch补丁包生成需要使用到打补丁工具SophixPatchTool:

该工具提供了Windows和macOS和Linux版本,Windows下运行SophixPatchTool.exe,macOS下运行SophixPatchTool.app,Linux下(Ubuntu 16.04 64bit最佳)运行SophixPatchTool。并且需要安装Java环境且在JDK7或以上才能正常使用。

2.生成Patch

2.1主对话框

旧包: 选择基线包路径(有问题的APK)。

新包: 选择新包路径(修复过该问题APK)。

日志:打开日志输出窗口。

高级:展开高级选项,见2.2.3。

设置:配置其他信息。

GO!:开始生成补丁。

2.2主对话框 - 高级选项

强制冷启动:勾选的话强制生成补丁包为需要冷启动才能修复的格式。默认不选的话,工具会根据代码变更情况自动选择即时热替换或者冷启动修复。

不比较资源:打补丁时不比较资源的变化。

不比较SO库:打补丁时不比较SO库的变化。

2.2.3 设置对话框

补丁输出路径: 指定生成补丁之后补丁的存放位置,必须是已存在的目录。

Key Store Path:本地的签名文件的路径,不输入则不做签名。

Key Store Password:证书文件的密码。

Key Alias:Key的别名。

Key Passwrod:Key的密码。

AES Key:自定义aes秘钥, 必须是16位数字或字母的组合。必须与setAesKey中设置的秘钥一致。

Filter Class File:本地的白名单类列表文件的路径,放进去的类不会再计算patch,文件格式: 一行一个类名。

2.3命令行方式

采用命令行方式前,需要准备以下json格式的配置文件:

{

"AesKey": "",

"ClassFilterFilePath": "",

"KeyAlias": "",

"KeyPassword": "",

"KeyStorePassword": "",

"KeyStorePath": "",

"NewApkPath": "/path/to/new.apk",

"OldApkPath": "/path/to/old.apk",

"OutputDirPath": "/path/to/output/dir/",

"isForceColdFix": false,

"isIgnoreRes": false,

"isIgnoreSo": false

}

其中,必填的项目是NewApkPath、OldApkPath、OutputDirPath。其他的配置与图形界面所对应项一致。然后把它存为profiles.json文件即可。

接下来,可以用下面的命令进行打包:

SophixPatchTool在windows平台下为SophixPatchTool.exe,mac平台下为SophixPatchTool.app/Contents/MacOS/SophixPatchTool。          执行完毕后就可以在OutputDirPath下输出补丁文件了。

2.4注意事项

支持多渠道包仅选用某个渠道包的补丁,只需要保证变化相同即可,不过对于不同的基线包最好进行全面的测试。

发布前请严格按照:扫码内测 => 灰度发布 => 全量发布的流程进行,以保证补丁包能够正常在所有Android版本的机型上生效。

mac下的补丁工具若出现一打开就崩溃的情况,请将补丁工具移到“应用程序”目录下即可。

2.5补丁使用

补丁需要上传到阿里控制台。控制台地址