Tinker API概览
来源:互联网 发布:fastdfs nginx 404 编辑:程序博客网 时间:2024/06/05 23:41
Tinker API概览
我们需要使用的API大约几种在以下几个类中:
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 libraryTinkerInstaller.loadArmLibrary(getApplicationContext(), "libstlport_shared");//load lib/armeabi-v7a libraryTinkerInstaller.loadArmV7Library(getApplicationContext(), "libstlport_shared");
若存在Tinker还没install之前调用加载补丁中的Library库,可使用TinkerApplicationHelper.java的接口
//load lib/armeabi libraryTinkerApplicationHelper.loadArmLibrary(tinkerApplicationLike, "libstlport_shared");//load lib/armeabi-v7a libraryTinkerApplicationHelper.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模式。
//获得基准包的tinkerIdString oldTinkerId = Tinker.with(context).getTinkerLoadResultIfPresent().getTinkerID();//获得补丁包的tinkerIdString newTinkerId = Tinker.with(context).getTinkerLoadResultIfPresent().getNewTinkerID();
更多接口请参考TinkerLoadResult.java。
TinkeApplicationHelp相关接口
在有些时候,你可能想在更后的时机才去installTinker
,甚至在某些进程永远也不会去做这个动作。那样你可以通过TinkerApplicationHelper.java来获得一些当前加载的信息。
基本所有的信息都可以在这里获得,但是由于这里是直接读取结果intent
还有其他问题?请参考Tinker 常见问题!
- Tinker API概览
- Tinker -- 微信Android热补丁方案 API概览
- SDO API 概览
- pMock API概览
- Phonegap API 概览
- Web API 安全概览
- Trident API 概览
- Tinker
- VC网络通信API概览
- ArcGIS API for Flex 概览
- Android 5.0 主要API概览
- VC网络通信API概览
- Android N for Developers(API概览)
- V8世界探险 (1) - v8 API概览
- Android API官方文档 UI概览
- [Storm中文文档]Trident API概览
- Android音视频API(android.media):概览
- Android网络API(android.net):概览
- Tinker 自定义扩展
- Android 让控件在5s之后消失
- java io 相关常用操作详解
- 结论: blocking_query 是当前堵塞其他会话正在运行的SQL.而不是原始堵塞SQL
- Android 开源优秀 Library 推荐
- Tinker API概览
- VBScript基础:RegExp对象
- Golang简单的对象池
- Linux 下进程间的通信方式选择
- JSP九大内置对象及四个作用域???????
- 获取iOS设备键盘高度
- adb 命令
- 微信内测“话题”、付费阅读功能改代码即可“实现
- 算法(第四版)学习笔记1--第一章--union-find算法