全部產品
Search
文件中心

Mobile Platform as a Service:接入 mPaaS 核心

更新時間:Dec 19, 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、外掛程式等。