Tinker API概览
我们需要使用的API大约几种在以下几个类中:
函数 | 描述 |
---|---|
TinkerInstaller.java | TinkerInstaller.java封装了一些常用的函数,例如Tinker对象的构建,发起补丁请求以及lib库的加载。 |
Tinker.java | Tinker.java是Tinker库的Manager类,tinker所有的状态、信息都存放在这里。 |
TinkerLoadResult.java | TinkerLoadResult.java是用来存放加载补丁包时的相关结果,它本身也是Tinker.java的一个成员变量。 |
TinkerApplicationHelper.java | TinkerApplicationHelper.java封装了一些无需构建Tinker都可调用的函数,一般我们更推荐使用上面的三个类。 |
TinkerInstaller相关接口
TinkerInstaller封装了一些比较重要的函数,现作简单的说明:
Tinker实例的构建
Tinker类是整个框架的核心,我们需要构建它的单例。其中intentResult存放是我们加载补丁时的数据,它在install之后才将数据赋值给Tinker与TinkerLoadResult类。
全部使用默认定义类的构造方法:
public static void install(ApplicationLike applicationLike) {
Tinker.with(tinkerApplication).install(applicationLike.getTinkerResultIntent());
}
若使用了自定义类,可选择多参数的install方法,具体用法可参考SampleApplicationLike。
你一定要先install Tinker之后,才能使用Tinker相关的API。不然你只能使用TinkerApplicationHelper.java中的API。
发起补丁修复请求
正如之前所说的,补丁请求分为修复当前版本以及升级当前版本两种。修复当前版本一般是在当前版本的补丁文件出现缺失或不一致的情况,所有请求都将会交给PatchListener去处理。
发起修复补丁请求:
public static void onReceiveRepairPatch(Context context, String patchLocation) {
Tinker.with(context).getPatchListener().onPatchReceived(patchLocation, false);
}
事实上,大家其实可以忽略onReceiveRepairPatch这个接口。使用者无需手动调用,在DefaultLoadReporter中的onLoadFileNotFound会自动调用。它的作用是自动恢复已经加载补丁的缺失文件。
发起升级补丁请求,即收到一个新的补丁包,多次补丁也是调用下面这个接口:
public static void onReceiveUpgradePatch(Context context, String patchLocation) {
Tinker.with(context).getPatchListener().onPatchReceived(patchLocation, true);
}
Library库的加载
更新的Library库文件我们帮你保存在tinker下面的子目录下,但是我们并没有为你区分abi(部分手机判断不准确)。所以若想加载最新的库,你有两种方法,第一个是直接尝试去Tinker更新的库文件中加载,第二个参数是库文件相对安装包的路径。
TinkerInstaller.loadLibraryFromTinker(getApplicationContext(), "assets/x86", "libstlport_shared");
但是我们更推荐的是,使用TinkerInstaller.loadLibrary接管你所有的库加载,它会自动先尝试去Tinker中的库文件中加载,但是需要注意的是当前这种方法只支持lib/armeabi目录下的库文件
!
//load lib/armeabi library
TinkerInstaller.loadArmLibrary(getApplicationContext(), "libstlport_shared");
//load lib/armeabi-v7a library
TinkerInstaller.loadArmV7Library(getApplicationContext(), "libstlport_shared");
若存在Tinker还没install之前调用加载补丁中的Library库,可使用TinkerApplicationHelper.java的接口
//load lib/armeabi library
TinkerApplicationHelper.loadArmLibrary(tinkerApplicationLike, "libstlport_shared");
//load lib/armeabi-v7a library
TinkerApplicationHelper.loadArmV7Library(tinkerApplicationLike, "libstlport_shared");
若想对第三方代码的库文件更新,可先使用TinkerInstaller.load*Library对第三方库做提前的加载!更多使用方法可参考MainActivity.java。
当前使用方式似乎并不能做到开发者透明,这是因为我们想尽量少的去hook系统框架减少兼容性的问题。这边欢迎大家一起讨论是否可以采用更加激进的策略,大家在正式发布前都应该测试补丁的Library是否真正的生效。
设置LogIml实现
你可以设置自己的Log输出实现:
public static void setLogIml(TinkerLog.LogImp imp) {
TinkerLog.setLogImp(imp);
}
Tinker类相关接口
Tinker类是整个库的核心,基本所有的补丁相关的信息我们都可以在这里获取到。TinkerApplication也有一些获取tinkerFlag的相关API,它们可以在Tinker未被初始化前使用。
获取单例的方法
获取单例的方法非常简单:
Tinker manager = Tinker.with(context);
获取加载状态
loaded
成员变量是标记是否有补丁加载成功的标记,只有它为true时,才能保证TinkerLoadResult的各个变量非空。
boolean isLoaded = Tinker.with(context).isTinkerLoaded();
boolean isInstalled = Tinker.with(context).isTinkerInstalled();
获得加载的结果,也就是TinkerLoadResult的实例。它是有可能为空的,使用它请先确保loaded
为true:
TinkerLoadResult loadResult = Tinker.with(context).getTinkerLoadResultIfPresent();
清除补丁
当补丁出现异常或者某些情况,我们可能希望清空全部补丁,调用方法为:
Tinker.with(context).cleanPatch();
当然我们也可以选择卸载某个版本的补丁文件:
Tinker.with(context).cleanPatchByVersion();
在升级版本时我们也无须手动去清除补丁,框架已经为我们做了这件事情。需要注意的是,在补丁已经加载的前提下清除补丁,可能会引起crash。这个时候更好重启一下所有的进程。
其他API这里不再一一概述,请大家自行翻阅Tinker.java。
TinkerLoadResult相关接口
因为加载补丁是在Tinker的Install之前的,我们将加载的结果保存在intent中,然后在Tinker的install方法中恢复这些结果。这里包括补丁的所有信息,例如加载的dex,library,我们定义的package config以及各个文件的目录等。但是需要注意的是,这里面的变量大多数是nullable。若Tinker的loaded为true,除了dexes与libs
(要看补丁包里面是否真的有),其他变量可以确保非空。
获取packageConfig:
public String getPackageConfigByName(String name) {
if (packageConfig != null) {
return packageConfig.get(name);
}
return null;
}
这里需要注意的是,检查dex的Md5值需要使用SharePatchFileUtil.verifyDexFileMd5方法,这是由于dex有可能是被我们重新打包成jar模式。
//获得基准包的tinkerId
String oldTinkerId = Tinker.with(context).getTinkerLoadResultIfPresent().getTinkerID();
//获得补丁包的tinkerId
String newTinkerId = Tinker.with(context).getTinkerLoadResultIfPresent().getNewTinkerID();
更多接口请参考TinkerLoadResult.java。
TinkeApplicationHelp相关接口
在有些时候,你可能想在更后的时机才去installTinker
,甚至在某些进程永远也不会去做这个动作。那样你可以通过TinkerApplicationHelper.java来获得一些当前加载的信息。
基本所有的信息都可以在这里获得,但是由于这里是直接读取结果intent
还有其他问题?请参考Tinker 常见问题!