使用阿里百川HotFix

前言:首先要弄懂HotFix是干嘛的,不然就别向下看了。这里仅仅根据官方文档的代码书写,亲测可用,不做理论指导。

Android Studio集成:

添加maven仓库地址:

  1. repositories {
  2. maven {
  3. url "http://repo.baichuan-android.taobao.com/content/groups/BaichuanRepositories"
  4. }
  5. }

添加gradle坐标版本依赖:

  1. dependencies {
  2. compile 'com.taobao.android:alisdk-hotfix:2.0.9'
  3. }

权限说明:

  1. <! -- 网络权限 -->
  2. <uses-permission android:name="android.permission.INTERNET" />
  3. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  4. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
  5. <! -- 外部存储读权限 -->
  6. <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

配置AndroidManifest文件:

  1. <meta-data
  2. android:name="com.taobao.android.hotfix.IDSECRET"
  3. android:value="App ID" />
  4. <meta-data
  5. android:name="com.taobao.android.hotfix.APPSECRET"
  6. android:value="App Secret" />
  7. <meta-data
  8. android:name="com.taobao.android.hotfix.RSASECRET"
  9. android:value="RSA密钥" />

混淆配置:

  1. #基线包使用,生成mapping.txt
  2. -printmapping mapping.txt
  3. #生成的mapping.txt在app/buidl/outputs/mapping/release路径下,移动到/app路径下
  4. #修复后的项目使用,保证混淆结果一致
  5. #-applymapping mapping.txt
  6. #hotfix
  7. -keep class com.taobao.sophix.**{*;}
  8. -keep class com.ta.utdid2.device.**{*;}

SDK接口配置:

  1. package xin.ceet.com.tencentdemo;
  2. import android.app.Application;
  3. import com.taobao.sophix.PatchStatus;
  4. import com.taobao.sophix.SophixManager;
  5. import com.taobao.sophix.listener.PatchLoadStatusListener;
  6. /**
  7. * Created by asus on 2017/7/5.
  8. */
  9. public class MyApplication extends Application {
  10. private String appVersion = "1.0.0";
  11. @Override
  12. public void onCreate() {
  13. super.onCreate();
  14. SophixManager.getInstance().setContext(this)
  15. .setAppVersion(appVersion)
  16. .setAesKey(null)
  17. .setEnableDebug(true)
  18. .setPatchLoadStatusStub(new PatchLoadStatusListener() {
  19. @Override
  20. public void onLoad(final int mode, final int code, final String info, final int handlePatchVersion) {
  21. // 补丁加载回调通知
  22. if (code == PatchStatus.CODE_LOAD_SUCCESS) {
  23. // 表明补丁加载成功
  24. } else if (code == PatchStatus.CODE_LOAD_RELAUNCH) {
  25. // 表明新补丁生效需要重启. 开发者可提示用户或者强制重启;
  26. // 建议: 用户可以监听进入后台事件, 然后应用自杀
  27. } else if (code == PatchStatus.CODE_LOAD_FAIL) {
  28. // 内部引擎异常, 推荐此时清空本地补丁, 防止失败补丁重复加载
  29. // SophixManager.getInstance().cleanPatches();
  30. } else {
  31. // 其它错误信息, 查看PatchStatus类说明
  32. }
  33. }
  34. }).initialize();
  35. SophixManager.getInstance().queryAndLoadNewPatch();
  36. }
  37. }

版本说明:

  1. 说明一:patch是针对客户端具体某个版本的,patch和具体版本绑定
  2. eg. 应用当前版本号是1.1.0, 那么只能在后台查询到1.1.0版本对应发布的补丁, 而查询不到之前1.0.0旧版本发布的补丁.
  3. 说明二:针对某个具体版本发布的新补丁, 必须包含所有的bugfix, 而不能依赖补丁递增修复的方式, 因为应用仅可能加载一个补丁
  4. eg. 针对1.0.0版本在后台发布了一个补丁版本号为1的补丁修复了bug1, 然后发现此时针对这个版本补丁1修复的不完全, 代码还有bug2, 在后台重新发布一个补丁版本号为2的补丁, 那么此时补丁2就必须同时包含bug1和bug2的修复才行, 而不是只包含bug2的修复(bug1就没被修复了)
上一篇:各大HotFix热补丁方案分析和比较


下一篇:Android HotFix动态加载框架介绍