全部产品
云市场
云游戏

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

更新时间:2020-06-12 12:04:16

背景

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

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

操作步骤

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

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

准备必要的信息

  1. 获取 Android 应用的 Applicaion ID(点击这里 查看 Applicaion 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
    • 机密信息 中填写上一步中获取的 Application ID签名证书的 SHA1 指纹值,例如:
      info
  4. 工作人员收到请求后会进行人工审核。审核通过后,将通过工单系统提供 UC SDK App Key。

使用和验证

在项目中使用

  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