开发者社区 问答 正文

原生android接入mpaas运行小程序必须要 申请 UC 内核吗?

原生android接入mpaas运行小程序必须要 申请 UC 内核吗?

展开
收起
嘟嘟嘟嘟嘟嘟 2024-05-14 23:52:25 46 分享 版权
阿里云 AI 助理回答

在原生 Android 接入 mPaaS 运行小程序时,申请 UC 内核是必须的。以下是详细说明和原因:

1. UC 内核的作用

UC 内核是 mPaaS 小程序运行的核心组件之一,提供了以下关键能力: - 支持同层渲染能力(如嵌入 WebView、地图等)。 - 提供更好的性能和稳定性,优化小程序的渲染体验。 - 在 Android 13 系统中,如果不启用 UC 内核,H5 容器和小程序将默认使用系统 WebView,可能导致部分页面白屏或 API 异常等问题。

2. UC 内核的必要性

根据官方文档说明: - mPaaS 小程序依赖 UC 内核,没有 UC 内核将无法正常接入和运行 Android 小程序。 - 在 Android 13 系统上,必须使用特定版本的 UC 内核,并通过配置开启 UC 内核功能。否则,H5 容器和小程序将回退到系统 WebView,可能引发兼容性问题。

3. 申请 UC 内核的步骤

由于 UC 内核需要授权使用,以下是申请和配置 UC 内核的关键步骤: 1. 添加 UC 内核依赖
在项目的 build.gradle 文件中添加以下依赖:

implementation('com.alipay.android.phone.wallet:nebulaucsdk-build:999.3.22.2.51.220908200129@aar') {
    force = true
}

如果使用 Portal&Bundle 接入方式,还需移除 SDK 中原本的 UC 内核依赖:

mpaascomponents {
    excludeDependencies = [
        "com.alipay.android.phone.wallet:nebulaucsdk-build"
    ]
}

  1. 生成 UC Key 签名信息

    • 在工程中添加 UC 内核(UCCORE) 依赖。
    • 提供应用的 Android native package 名称(package name)。
    • 使用 mPaaS 插件生成 UC Key 签名信息,并提交申请表单。
  2. 配置 UC Key
    将获取的 UC Key 填入 Portal 项目的 AndroidManifest.xml 文件中:

    <meta-data android:name="UCSDKAppKey" android:value="您申请获得的 key"/>
    

    注意:UC SDK 的授权信息与 APK 的 包名签名 绑定。如果 UCWebView 没有生效,请检查签名和包名是否与申请时一致。

4. 重要提醒

  • UC 内核申请限制:由于产品策略变更,从 2022 年 12 月 1 日起,UC Key 不再支持公开申请。需要填写表单并由工作人员审核后反馈申请结果。
  • Android 13 适配:在 Android 13 系统上,必须升级到 mPaaS 10.1.68.52 或以上版本基线,并完成 UC 内核的相关配置。

5. 总结

综上所述,原生 Android 接入 mPaaS 运行小程序时,申请和配置 UC 内核是强制要求。缺少 UC 内核将导致小程序无法正常运行,并可能出现兼容性问题。因此,请务必按照官方文档完成 UC 内核的申请和配置工作。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答