移动开发平台mPaaS：使用 mPaaS 插件

mPaaS 插件的功能主要包括 原生 AAR 方式、组件化接入、基础工具、帮助 和 构建。

• 原生 AAR 接入、组件化接入 分别提供了接入面板，在接入面板中的接入向导会协助您将 mPaaS 以不同的接入方式接入到您的工程中。在完成接入后，您还可以在接入面板进行 基线升级 和 组件管理。

• 在 基础工具 中，mPaaS 提供了 生成加密图片（专有云配置文件）、 生成 UC Key 签名信息 和 生成蓝盾图片 的功能，方便快速完成使用 mPaaS 功能前的信息准备。

• 在 帮助 中，mPaaS 提供了 日志诊断工具、常见问题、和 查看文档 的功能，方便在使用 mPaaS 过程中遇到问题时快速获得支持。

• 构建，完成接入 mPaaS 后构建工程。

AAR 接入

操作步骤

1. 在 Android Studio 中打开已有工程，单击 mPaaS > 原生 AAR 接入。

2. 导入 App 配置。在接入面板中，单击 开始导入，使用 手动导入 的方式完成配置文件的添加。

后续步骤

1. 接入/升级基线

2. 配置/更新组件

组件化接入

操作步骤

1. 在 Android Studio 中打开已有工程，单击 mPaaS > 组件化接入。

2. 导入 App 配置。在接入面板中，单击 开始导入，使用 手动导入 的方式完成配置文件的添加。

3. 转换工程。如果您的工程是原生 Android 工程，还需要对工程进行转换。在接入面板中，单击 安装 mPaaS Portal。在安装 mPaaS Portal 窗口中，分别选择原始工程的位置和配置文件，单击 OK。

后续步骤

1. 接入/升级基线

2. 配置/更新组件

接入/升级基线

升级到常规基线

操作步骤

1. 单击 mPaaS > 原生 AAR 接入 或 组件化接入，在弹出的接入面板中，单击接入/升级基线下的 开始配置。

2. 选择需要升级的基线版本，单击 OK。 升级成功后，您将看到 基线升级成功 的提示。

后续步骤

单击接入面板中的升级基线，在选择基线窗口中将会看到您的基线版本号。

升级到自定义基线

通常情况下，我们提供的基线面向所有客户，如 10.1.32、10.1.60、10.1.68。当您需要定制 mPaaS 的功能时，您可以向和您对接的 mPaaS 的工作人员提出需求，我们会按照您的需求为您定制基线。在交付时，mPaaS 的工作人员会向您提供定制基线的 ID，您只需要在 mPaaS 插件中填写该 ID，即可获得此定制基线。

前提条件

确认您的 Android Studio mPaaS 版本为 V2.19111217 或以上。您可以参考 更新 mPaaS 插件 以了解当前的 mPaaS 插件版本和如何升级 mPaaS 插件。

操作步骤

1. 删除您 Android Studio 工程里已经存在的 mpaas_package.json 文件。

2. 单击 mPaaS > 原生 AAR 接入 或 组件化接入，在弹出的接入面板中，单击接入/升级基线下的 开始配置。

3. 在基线升级对话框中勾选 自定义基线 并输入您得到的定制基线 ID。

4. 单击 OK，即完成自定义基线的引入。

配置/更新组件

mPaaS组件管理（AAR）

前提条件

您已完成基线升级。

操作步骤

1. 单击 mPaaS > 原生 AAR 接入，在弹出的接入面板中，单击配置/更新组件下的 开始配置。

2. 在弹出的管理窗口中，单击 mPaaS 组件管理，选择要进行管理的 module，勾选要添加的组件，单击 OK。如果您的工程中有多个 module，您可以在选择不同的 module 后，分别为其添加组件。

3. 组件添加完成后，单击 OK。

组件管理

操作步骤

1. 单击 mPaaS > 组件化接入，在弹出的接入面板中，单击配置/更新组件下的 开始配置。

2. 在弹出的组件管理窗口中，单击按钮安装需要的组件。

生成加密图片（专有云配置文件）

为了安全，mPaaS 某些组件访问网络时需要对内容进行加密。

• 具有特殊名称 yw_1222.jpg 的图片为加解密提供密钥信息。mPaaS 组件自动使用该图片进行加解密，无需额外操作。

• 由于公有云环境已弃用该加密图片，故公有云用户可忽略本节内容。

生成并使用加密图片 yw_1222.jpg 的详情如下。

准备

加密图片与 APK 的签名文件有绑定关系。因此，需要准备 Portal 工程签名之后的 APK。具体的签名步骤，请参考 Android 官方网站：对应用进行签名。

生成

您可以通过 mPaaS 插件 生成加密图片。

1. 在 Android Studio 中，单击 mPaaS > 基础工具 > 生成加密图片（专有云配置文件）。

2. 在 Release Apk， 选择 Portal 工程签名之后的 APK 文件， RSA 会自动填充。

3. 在 mPaaS Config File， 选择 Portal 工程的 .config 文件， workSpaceId、appId 和 packageName 会自动填充。如果没有，可以根据工程的 .config 文件中的配置填写到对应输入框中。

4. 填写 appsecret 。

   注意：作为服务端管理人员，您可以从控制台中查询 appid 所对应的 appsecret。

5. 在 jpg Version 栏，填写对应的无线保镖图片版本号。

   说明

   查看 Portal 工程主 module 下 build.gradle 文件中 securityguard 版本，低于 5.4 的填 4（例如基线中给出的 securityguard-build:5.1.38.180402194514），其余填 5 。

6. 在 outPath， 选择无线保镖图片 yw_1222.jpg 的输出路径，即加密图片生成的本地路径。

7. 单击 OK 生成加密图片。

使用

加密图片的使用步骤如下：

1. 将加密图片 yw_1222.jpg 存放到 Portal 工程的 res/drawable 文件夹中。

2. 如使用 ProGuard，需避免加密图片被混淆。

   1. 检查 build.gradle 中是否配置了如下内容：

      minifyEnabled true
      shrinkResources true

   2. 若有如上配置，为了避免加密图片被混淆，需要在 res/raw 下创建 keep.xml 文件。文件内容如下：

      <?xml version="1.0" encoding="utf-8"?>
      <resources xmlns:tools="http://schemas.android.com/tools"
      tools:keep="@drawable/yw_1222*" /><!--tools:discard="@layout/unused2"-->

生成蓝盾图片

如果您从 mPaaS 控制台下载的 .config 文件中的 absBase64Code 值为空，则需进行下面 生成蓝盾图片 的操作（适用于私有云场景）。

单击 mPaaS > 基础工具 > 生成蓝盾加密图片，输入相关信息，即可生成蓝盾图片。

重点输入项说明：

• Release Apk : 接入 mPaaS 的工程打包出的 release apk 包，需要进行签名。

• MD5: release apk 包上传之后会自动获取填入，即 apk 包的 public md5 key。

• mPaaS config File: mPaaS 控制台点击下载配置即可下 .config 文件并传入。

• appSecret：mPaaS 控制台查看。

• 其他项 appId、packageName、outPath 传入以上信息后会自动识别填入。

最后将生成的图片添加到工程的 assets 目录下。

生成控制台用签名 APK

在 mPaaS 控制台中获取配置文件时，需要上传签名后的 APK 文件。但在未创建工程或未编译出签名后的 APK 时，获取配置文件的过程就会受阻而无法进行。为解决此问题，mPaaS 已将此过程简化为 Android Studio mPaaS 插件的 生成控制台用签名 APK 功能。该功能可在只需输入签名相关的参数的前提下，生成签名后的 APK。

生成

1. 单击 mPaaS > 基础工具 > 生成控制台用签名 APK，进入 构造签名 APK 页面。

2. 在 构造签名 APK 页面，填写相关配置信息。

3. 单击 OK 即可生成签名后的 APK 文件。

4. 单击 Reveal in Finder 即可找到上述步骤生成的 APK 文件，文件名为 mpaas-signed.apk。至此，签名后的 APK 生成成功。

   打开该 APK 文件查看，会发现该文件很小，且已经被签名。

生成 UC Key 签名信息

在 Android 应用中接入 UC SDK 能够有效解决各种厂商浏览器的兼容性问题。为添加 UC SDK，您需要先申请 UC SDK 的授权。该功能能够帮助您快速获得授权，下文介绍了申请 UC SDK 授权的全流程操作。

操作步骤

1. 在工程中，添加 UC 内核（UCCORE） 依赖。

2. 提供应用的 Android native package 名称（package name）。

3. 单击 mPaaS > 基础工具 > 生成 UC Key 签名信息，进入 查询签名信息 页面。

4. 在 查询签名信息 页面，填写相关配置信息。单击 Next。

5. 复制获得的 SHA1 信息。

6. 填写 UC key 申请表 并提交。

   说明

   由于产品策略变更，UC 不再全面开放申请，从2022.12.01起不支持公开申请 UC Key。需要填写表单相关信息，工作人员会进行审核并反馈申请结果。

7. 将获取的 Key 填入 Portal 项目的 AndroidManifest.xml 文件中：<meta-data android:name="UCSDKAppKey" android:value="您申请获得的 key"/>。

   说明

   UC SDK 的授权信息与 APK 的 包名 以及 签名 绑定。因此，如果 UCWebView 没有生效，请检查签名和包名与申请时使用的信息是否一致。

帮助

日志诊断工具

1. 单击 mPaaS > 帮助 > 日志诊断工具。

2. 将您需要分析的日志信息 copy 到输入框，单击 Next。

3. 等待分析结果。

4. 查看分析结果。 分析结果中包含定位原因和解决方案 的信息，您可以根据具体的定位信息和解决方案来修改您的代码。

5. 修改完成后单击 Finish 关闭弹窗。

常见问题

单击 mPaaS > 帮助 > 常见问题，即可跳转至 接入 Android 常见问题，查看接入过程中的常见问题。

查看文档

单击 mPaaS > 帮助 > 查看文档，即可跳转至 mPaaS 文档中心，查看各组件的使用文档。

构建

在 Android Studio 中选择 mPaaS > 构建。即可构造工程。