Android 客户端开发，如何获取 UC SDK App Key

背景

在 mPaaS Android 项目接入 H5 容器组件时，开发者需要在 AndroidManifest.xml 中配置 UCSDKAppKey 才能正常启用基于 UC 内核的 H5 容器组件。

UC SDK App Key 由阿里云提供，开发者需要通过工单系统提交工单来申请该 Key。申请时需要开发者提供 应用 ID 及 应用签名证书的 SHA1 指纹值。

操作步骤

获取 UC SDK App Key 的步骤如下：

  1. 准备必要的信息
  2. 提交申请工单
  3. 使用和验证

准备必要的信息

  1. 获取 Android 应用的 Application ID（点击这里 查看 Application ID 的定义）。
  2. 获取签名证书的 SHA1 指纹值：
    • 准备好用于 Android 应用签名的 Keystore 或 JKS 文件。
    • 利用JDK自带的 keytool 工具，执行如下命令获取：
      1. keytool -list -v -keystore <example.keystore>
    • 从输出结果中获取证书指纹 SHA1 值，如：
      SHA1

提交申请工单

  1. 登录 工单系统。
  2. 产品选择 移动开发平台 mPaaS。
  3. 根据提示填写必要信息，工作人员收到请求后会进行人工审核。审核通过后，将通过工单系统提供 UC SDK App Key。其中：
    • 优先级 中根据您的实际情况选择 重要 或 普通。
    • 问题描述 中填写 申请 UC SDK App Key，以及在上一步中获取的 Application ID 和 签名证书的 SHA1 指纹值，例如：
      ticket

使用和验证

在项目中使用

  1. 在目标 mPaaS Android 工程中，找到 AndroidManifest.xml，编辑 UCSDKAppKey 值，填写上一步中获取的 SDK Key：
    1. <meta-data android:name="UCSDKAppKey" android:value="您申请获得的 key"/>
    AndroidManifest
    说明：UC SDK App Key 是和 Application ID 及 应用签名证书的 SHA1 指纹值 一一对应的。不同 App 需要申请不同的 Key，不可混用，否则会导致 UC 内核无法启用。
  2. 在工程中，通过代码使用 H5 容器打开任意一个页面（参见 使用 SDK），重新编译打包。

验证

运行测试项目，并在 logcat 日志中搜索 create uc web view：

  • 如果日志显示 [main] create uc web view，则说明 UC 内核启用成功，例如：
    success
  • 如果日志显示 [main] create uc web view exception，则说明 UC 内核启用失败，例如：
    fail