全部产品
Search
文档中心

移动开发平台mPaaS:接入 mPaaS 内核

更新时间:Dec 18, 2024

接入说明

说明

接入 mPaaS 内核要求基线版本大于等于 10.2.3.55。

  1. 增加新的 mvn 配置,详情请参考 手动配置 Maven 仓库

  2. 在 app 的build.gradle中增加如下配置。具体 SDK 版本号参考 mPaaS 内核版本发布说明

    android {
      ...
       configurations {
            all*.exclude group: 'com.mpaas.mriver', module: 'mriveruc-build'
            all*.exclude module: 'nebulaucsdk-build'
            all*.exclude module: 'nebulauc-build'
       }
    }
    
    dependencies {
      ...
      api 'com.mpaas.myweb:mpaasmywebapi-build:xxx@aar'
      api 'com.mpaas.myweb:mpaasmyweb:xxx@aar'
      
      // 小程序容器必须添加,没使用小程序不用添加
      api 'com.mpaas.mriver:mrivermyweb-build:xxx@aar'
      
      // H5 容器必须添加
      api 'com.mpaas.nebula:nebulamyweb-build:xxx@aar'
    }
  3. 增加混淆配置。

    -keep class com.alipay.mywebview.** {*;}
  4. 申请授权码 并在AndroidManifest.xml中按照如下格式进行配置。

    <meta-data
                android:name="MPKernelAuthKey"
                android:value="xxx" />
    重要

    申请需要提供的信息包括 Apk 的包名和签名摘要 SHA256。

如何获取签名摘要

方法一:通过 Android SDK 中自带的apksigner命令进行获取。

apksigner verify -v --print-certs test.apk | grep 'certificate SHA-256'

// 输出示例
Signer #1 certificate SHA-256 digest: 389b49f7832f53e9017923220aa85e14dfaa4886ecd7428818bf339543cf498a

方法二:通过keytool获取。

keytool -printcert -jarfile test.apk | grep SHA256

// 输出示例 
 SHA256: A0:02:3F:10:D8:B9:8F:FF:E2:57:4B:47:A6:46:30:0C:67:98:5E:BF:5A:98:BB:D5:25:32:DE:E6:F8:91:27:07

验证内核应用是否成功

过滤日志 webview version,如果版本号为0.11.xxx则证明内核应用成功。

image.png

针对老客户

如果是之前接入 UC 内核的 mPaaS App,需要确认以下几点:

  • 是否做过内核的特定逻辑定制,如果做过内核的特定逻辑定制需要按照新的接口重新实现,具体可以通过检索代码中是否包含import com.uc.xxxxx来判断。

  • 新版本内核不再支持 Nebula 小程序,如果使用了 Nebula 小程序,请升级到小程序新容器。

  • 回归相关功能,主要包括:

    • 针对 H5 容器组件,包括小程序的内嵌 H5,需要回归内核相关的功能。包括 H5 页面的所有功能以及动态切换系统内核场景。

    • 针对小程序组件,回归小程序功能。包括渲染、组件、API、插件等。