接入 mPaaS 内核

Android mPaaS 基于 Chromium 105 版本实现内核全面升级,解决老版本的遗留问题并提升用户体验,目前处于免费试用阶段。

内核功能说明

  • 基于统一内核,能解决 Android 碎片化带来的 H5 页面适配问题,并收敛低版本的系统内核导致的 Crash。

  • 小程序场景下,针对 Video、Map 等组件通过同层渲染模式支持将 Native 组件渲染到同一层级上,使得这些高级组件具有原生体验。

接入

说明

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

  1. 增加新的 mvn 配置。

    maven {
        credentials {
            username '617696fc6970513e6e677c83'
            password '2qAa=hHdfLOp'
        }
        url 'https://packages.aliyun.com/63dc774a9dee9309492b993a/maven/repo-jpkdy'
    }
  2. 在 app 的 build.gradle 中增加如下配置。

    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:mpaasmyweb:10.2.3.00001151@aar'
      api 'com.mpaas.myweb:mpaasmywebapi-build:10.2.3.00001151@aar'
      
      // 小程序容器必须添加,没使用小程序不用添加
      api 'com.mpaas.mriver:mrivermyweb-build:10.2.3.1029@aar'
      
      // h5容器必须添加
      api 'com.mpaas.nebula:nebulamyweb-build:10.2.3.00001144@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、插件等。