目录
背景
在 mPaaS Android 项目接入 H5 容器组件时,开发者需要在 AndroidManifest.xml
中配置 UCSDKAppKey
才能正常启用基于 UC 内核的 H5 容器组件。
UC SDK App Key 由阿里云提供,开发者需要通过工单系统提交工单来申请该 Key。申请时需要开发者提供 应用 ID 及 应用签名证书的 SHA1 指纹值。
操作步骤
获取 UC SDK App Key 的步骤如下:
-
准备必要的信息
-
提交申请工单
-
使用和验证
准备必要的信息
-
获取 Android 应用的 Application ID(点击这里 查看 Application ID 的定义)。
-
获取签名证书的 SHA1 指纹值:
-
准备好用于 Android 应用签名的 Keystore 或 JKS 文件。
-
利用JDK自带的 keytool 工具,执行如下命令获取:
keytool -list -v -keystore <example.keystore>
-
从输出结果中获取证书指纹 SHA1 值,如:
-
提交申请工单
-
登录 工单系统。
-
产品选择 移动开发平台 mPaaS。
-
根据提示填写必要信息,工作人员收到请求后会进行人工审核。审核通过后,将通过工单系统提供 UC SDK App Key。其中:
-
优先级 中根据您的实际情况选择 重要 或 普通。
-
问题描述 中填写 申请 UC SDK App Key,以及在上一步中获取的 Application ID 和 签名证书的 SHA1 指纹值,例如:
-
使用和验证
在项目中使用
-
在目标 mPaaS Android 工程中,找到
AndroidManifest.xml
,编辑UCSDKAppKey
值,填写上一步中获取的 SDK Key:<meta-data android:name="UCSDKAppKey" android:value="您申请获得的 key"/>
说明
UC SDK App Key 是和 Application ID 及 应用签名证书的 SHA1 指纹值 一一对应的。不同 App 需要申请不同的 Key,不可混用,否则会导致 UC 内核无法启用。
-
在工程中,通过代码使用 H5 容器打开任意一个页面(参见 使用 SDK),重新编译打包。
验证
运行测试项目,并在 logcat 日志中搜索 create uc web view
:
-
如果日志显示
[main] create uc web view
,则说明 UC 内核启用成功,例如: -
如果日志显示
[main] create uc web view exception
,则说明 UC 内核启用失败,例如: