接入 mPaaS 内核

接入说明

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.00001160@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则证明内核应用成功。

针对老客户

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

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

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

• 回归相关功能，主要包括：

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

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