前言
希望通过本文能够帮助之前没有接触过 Tinker 的同学,快速了解利用 Tinker 生成及使用补丁包的过程。
Tinker 版本:1.8.1
Tinker 官方文档:https://github.com/Tencent/tinker/wiki
gradle 接入
我没有 clone 官方的例子,也没有在现有项目上直接接入,而是创建了一个新的项目。
在项目的 build.gradle 中,添加tinker-patch-gradle-plugin
依赖:
buildscript {
dependencies {
classpath ('com.tencent.tinker:tinker-patch-gradle-plugin:1.8.1')
}
}
然后在 app 的 gradle 文件 app/build.gradle,添加 tinker 的库依赖以及 apply tinker 的 gradle 插件:
dependencies {
provided('com.tencent.tinker:tinker-android-anno:1.8.1')
compile('com.tencent.tinker:tinker-android-lib:1.8.1')
}
...
apply plugin: 'com.tencent.tinker.patch'
在这一步不用着急编译,下面还有 gradle 的详细配置。
生成 Application
tinker 建议编写一个 DefaultApplicationLike 的子类,并使用@DefaultLifeCycle
注解生成 Application.
@DefaultLifeCycle(application = ".MyApplication", //要生成的application名称
flags = ShareConstants.TINKER_ENABLE_ALL)
public class MyApplicationLike extends DefaultApplicationLike {
public MyApplicationLike(Application application, int tinkerFlags, boolean tinkerLoadVerifyFlag,
long applicationStartElapsedTime, long applicationStartMillisTime, Intent tinkerResultIntent) {
super(application, tinkerFlags, tinkerLoadVerifyFlag,
applicationStartElapsedTime, applicationStartMillisTime, tinkerResultIntent);
}
@Override
public void onBaseContextAttached(Context base) {
super.onBaseContextAttached(base);
TinkerInstaller.install(this);
}
}
注意 application 名称为.MyApplication
,我创建的 MyApplicationLike 所在的包为tech.gujin.tinkersample.application
,生成的 MyApplication 也在这个包下。或者将包名写全:application = "tech.gujin.tinkersample.application.MyApplication"
,生成的文件都是一样的。
之后注册 Application 到 AndroidManifest 中:
如果报错现在不用处理,编译后会自动生成的。
gradle 配置
我直接拷贝了官方例子,修改了其中获取 tinkerId 的方法,bakPath 的路径,移除了多渠道部分。
def bakPath = file("./tinker-old/") //可自行定义文件路径
ext {
tinkerId = "tinker_id_" + android.defaultConfig.versionName + "_" + android.defaultConfig.versionCode
tinkerEnabled = true
tinkerOldApkPath = "${bakPath}/app-release-1.0-1.apk" //可自行修改文件名
tinkerApplyMappingPath = "${bakPath}/app-release-1.0-1-mapping.txt"
tinkerApplyResourcePath = "${bakPath}/app-release-1.0-1-R.txt"
}
因为要生成补丁,tinker 需要上一个版本的安装包用来比较差异。
我创建了tinker-old
文件夹,放入上一个版本名为app-release-1.0-1.apk
的安装包,并将路径设置给 tinkerOldApkPath.
为了减少补丁包的大小,还可以继续设置 tinkerApplyMappingPath 和 tinkerApplyResourcePath.
其余地方并无太大变化,更多可以看修改后的gradle。
首次接入没有旧的安装包也不用担心,如果指定文件不存在 tinker 会自动忽略。
使用前的准备
创建一个很简单的 Activity:
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
((TextView) findViewById(R.id.tv_msg)).setText("此版本存在BUG");
File file = new File(getExternalCacheDir(), "/patch_signed_7zip.apk");
if (file.exists()) {
TinkerInstaller.onReceiveUpgradePatch(getApplicationContext(), file.getAbsolutePath());
}
}
}
这里省去了访问服务器判断有没有补丁包和下载的逻辑,简化为如果/storage/emulated/0/Android/data/tech.gujin.tinkersample/cache
目录下有patch_signed_7zip.apk
补丁包就进行更新。
然后编译一个 release 包,安装到手机上:
制作补丁包
修改 TextView 的文字,然后升级下 versionCode 和 versionName,就当是 1.1 版本修复了 1.0 版本的 Bug.
刚才的打包过程会自动将 apk,mapping 和 R 文件复制到tinker-old
文件夹中,根据文件名配置下 tinkerOldApkPath、tinkerApplyMappingPath 和 tinkerApplyResourcePath.
然后在 Terminal 输入 gradlew tinkerPatchRelease
,或者在 Gradle projects 中找到相应的 project 运行即可。
等运行结束后,补丁包生成在/build/outputs/tinkerPatch
目录下,使用patch_signed_7zip.apk
,它是签名后并使用 7zip 压缩的补丁包。
到此为止,补丁包就制作好了。
使用补丁
本例中简化了流程,我直接将补丁放到 /storage/emulated/0/Android/data/tech.gujin.tinkersample/cache
目录。
杀死进程重新打开应用,可以看到打印出 log:
I/Tinker.DefaultTinkerResultService: DefaultTinkerResultService received a result:
PatchResult:
isSuccess:true
rawPatchFilePath:/storage/emulated/0/Android/data/tech.gujin.tinkersample/cache/patch_signed_7zip.apk
costTime:530
patchVersion:a5c8417e691fd9cffe83c11cd0d37eff
然后应用直接退出了,这是因为 tinker 提供的 DefaultTinkerResultService 中,补丁升级成功后会杀死当前进程,可以继承 DefaultTinkerResultService 实现自己的回调。
再次打开应用可以看到补丁已经生效了:
至此,tinker 生成及更新补丁包的过程就已经介绍完毕了。
代码已托管至 Github:GuJin/TinkerSample
谢谢大家。