全部产品
云市场

公有云、基于 mPaaS Android 框架

更新时间:2020-05-20 00:51:53

本文将引导您从零开始创建 基于 mPaaS 框架 的 Android 工程,并使用热修复功能。

说明
  • 本文只适用于 公有云
  • 热修复功能支持 基于 mPaaS 框架基于原生框架 2 种接入方式。关于接入方式的更多说明,请参见 接入方式简介

本文将分为两部分向您完整的介绍并演示热修复的使用流程:

接入热修复

接入热修复流程如下:

  1. 配置开发环境
  2. 在控制台创建应用
  3. 在客户端创建新工程
  4. 签名
  5. 配置加密信息
  6. 编写代码
  7. 发布带有热修复功能的客户端版本

配置开发环境

参考文档 配置开发环境

在控制台创建应用

参考文档 在控制台创建应用。此时,本地还没有带签名的 APK,因此在下载配置文件时,可以暂不上传 APK。

下载的配置文件的文件名示例:Ant-mpaas-4111111111005-default-Android.config

在客户端创建新工程

参考 文档 在客户端创建 基于 mPaaS 框架 的新工程,并确保使用 mPaaS > Build 成功 构建工程

说明:在添加 SDK 时,需要确保勾选了下图中的 HOTFIXRPC

签名

签名是为了下一步配置加密信息做准备。

在 Android Studio 中打开 Portal 工程,然后参考 Android 官网文档 给应用签名,并生成带签名的 APK。

签名步骤如下:

  1. 生成密钥和密钥库。若已有秘钥库,则可忽略此步骤。
    1. 在 Android Studio 中打开 Portal 工程,点击 Build > Generate Signed APK,然后点击 Create new
      new_keystoe_entry
    2. 完善相关信息,然后点击 OK
      重要:您需要记住此处填写的信息,以便在后续操作中使用。
      new_keystore
  2. 生成带签名的 APK
    1. 选择秘钥库,填写相关信息,然后点击 Next
      gen_signed_apk_ok
    2. 如下图完善相关信息,然后点击 Finish;等待片刻,即可生成带签名的 APK。
      说明
      • Signature Versions 中 V1(Jar Signature) 必须勾选,V2(Full APK Signature) 可按需勾选。
      • 带签名的 APK 将保存在 {APK Destination Folder}/{Build Type} 目录下。在下图的示例中,保存目录为 /Users/archer.zb/AndroidStudioProjects/Tutorials/Hotpatch/app/debug/
      gen_signed_apk_f
  3. 参考 Android 官网文档,在代码中增加签名配置。配置完成后,build.gradle 示例如下:
    1. signingConfigs {
    2. release {
    3. keyAlias 'keyAlias'
    4. keyPassword 'keyPassword'
    5. storeFile file('/Users/archer.zb/Desktop/hotpatch/keystore.jks')
    6. storePassword 'storePassword'
    7. }
    8. debug {
    9. keyAlias 'keyAlias'
    10. keyPassword 'keyPassword'
    11. storeFile file('/Users/archer.zb/Desktop/hotpatch/keystore.jks')
    12. storePassword 'storePassword'
    13. }
    14. }

配置加密信息

为了保证客户端获取热修复包过程的安全,需要对网络内容进行加密。配置加密信息的步骤如下:

  1. 到控制台重新下载配置文件。

    进入 mPaas 控制台 代码管理 > 代码配置 > Android 页面,上传 上一步 生成的带签名 APK,并再次下载配置文件。此时,将下载到 .zip 压缩包。

  2. 解压 .zip 包,用其中的 Ant-mpaas-xxx-xxx-Android.config 文件替换 Portal 工程主 module 中的同名文件。
    重要:替换后的 base64Code 的值一定非空。
    config_base64
  3. 删除 Portal 工程主 module src/main/res/drawable 中的 yw_1222.jpg 图片:
  4. 分别重新构建 Bundle、Portal 工程。

编写代码

至此,热修复就已经接入,您可以根据业务需求编写代码。

示例按钮

说明:下方示例为体验热修复功能的示例代码,以便您在发布前体验热修复功能。

为了体验热修复,您可以在 Bundle 工程的界面中增加两个按钮:

add_buttons

  • Toast:该按钮对应的代码存在 Bug,点击会造成应用崩溃。
  • Hotfix:在控制台发布热修复包后,点击该按钮,触发热修复;重启应用后,Toast 按钮对应的代码 Bug 将被修复。

示例代码

对应的布局代码如下:

  1. <Button
  2. android:id="@+id/toast"
  3. android:layout_width="match_parent"
  4. android:layout_height="wrap_content"
  5. android:text="Toast" />
  6. <Button
  7. android:id="@+id/hotfix"
  8. android:layout_width="match_parent"
  9. android:layout_height="wrap_content"
  10. android:text="Hotfix" />

对应的 Java 代码如下:

  1. findViewById(R.id.toast).setOnClickListener(new View.OnClickListener() {
  2. @Override
  3. public void onClick(View view) {
  4. // 按钮点击时,先做除法运算,再通过弹出框显示计算结果
  5. int result = 1/0; // 除数为 0,是个 bug,会导致应用崩溃
  6. Toast.makeText(getApplicationContext(), "result = " + result, Toast.LENGTH_SHORT).show();
  7. }
  8. });
  9. findViewById(R.id.hotfix).setOnClickListener(new View.OnClickListener() {
  10. @Override
  11. public void onClick(View view) {
  12. // 按钮点击时,触发热修复
  13. // SDK 版本 ≥ 10.1.32 时,调用如下接口:
  14. MPHotpatch.init();
  15. }
  16. });

MainActivity.java

加入示例代码后,重新构建 Bundle 与 Portal 生成的 APK 即可。体验热修复过程详见下方的 热修复 Bug 演示

发布带有热修复功能的客户端版本

在编写完客户端代码后,即可将生成的 APK 发布至应用平台,以便 App 用户可下载更新。详情参见 Android 发布管理iOS 发布管理

热修复 Bug 演示

热修复 Bug 的示例流程如下:

  1. 备份 Bug 版本构建生成的 .jar 包
  2. 修改 Bug 代码,生成热修复包
  3. 在控制台添加并发布热修复包
  4. 客户端调用触发热修复的接口,进而获取热修复包
  5. 应用重启后,触发热修复,Bug 被修复

备份 Bug 版本构建生成的 .jar 包

生成热修复包时,需要新老版本(即 Bug 版本和修复后的版本)的构建结果。因此,首先需要备份 Bug 版本构建生成的 .jar 包。

.jar 包路径:

  • 若构建 debug 包,则为 Bundle 主 module 下的 build/intermediates/bundle/xxxx-raw.jar
  • 若构建 release 包,则 .jar 包名称没有 -raw 后缀。

    示例:
    bundle_build_result

修改 Bug 代码

修改 Bug 代码,并重新构建工程。对应上文示例,可将除数改成 1:

fix_code

生成热修复包

在 Android Studio 中,使用 mPaaS > Generate Hotpatch 功能生成热修复包:

gen_hotpatch_file

  • Old Bundle:备份的 Bug 版本构建生成的 .jar 包。详见上文 备份 Bug 版本构建生成的 .jar 包
  • New Bundle:修改代码 Bug 后,重新构建生成的 .jar 包。
  • Patch file dir:热修复包的保存路径。该路径下将会生成很多文件,后续有用的是 .jar 文件:
  • DexPatch:建议勾选。

更多信息,参见 热修复包功能

在控制台添加并发布热修复包

添加热修复包

  1. 进入 mPaas 控制台 实时发布 > 热修复管理 页面:

  2. 点击 添加热修复包,然后完善相关信息,并点击 确定

创建发布

  1. 如下图,点击 创建发布

    pub_hotpatch

  2. 选择发布类型等,然后点击 确定 即可完成发布。更多信息,参见 热修复管理

App 触发热修复

  1. 打开 Android Studio Logcat,关键词填写 DynamicRelease,过滤器选择 No Filters

    logcat_settings

  2. 确保手机连接 Android Studio,然后打开手机上安装的 Bug 版 App,点击 Hotfix 按钮,可以看到如下日志:

    hotpatch_log

  3. 杀掉应用进程、重启应用后,点击 Toast 按钮,可以正常看到弹出框,说明 Bug 已被修复。
说明:若热修复未生效,且日志中出现 RPCException [7001] 异常,则说明签名错误。重复 签名 步骤,并重点检查确保:
  • Portal 工程主 module Ant-mpaas-xxx-xxx-Android.config 文件中的 base64Code 的值非空。
  • Portal 工程主 module build.gradle 文件中 signingConfigs 配置正确。

相关链接