全部产品
Search
文档中心

Mobile Platform as a Service:Integrasikan kernel mPaaS

更新时间:Jan 23, 2026

Petunjuk integrasi

Catatan

Untuk mengintegrasikan kernel mPaaS, versi garis dasar harus 10.2.3.55 atau lebih baru.

  1. Tambahkan konfigurasi Maven baru. Untuk informasi selengkapnya, lihat Konfigurasi repositori Maven secara manual.

  2. Di file build.gradle aplikasi, tambahkan konfigurasi berikut. Untuk nomor versi SDK spesifik, lihat catatan rilis kernel mPaaS.

    android {
      ...
       configurations {
            // Hapus UC
            all*.exclude group: 'com.mpaas.mriver', module: 'mriveruc-build'
            all*.exclude module: 'nebulauc-build'
       }
    
       packagingOptions {
          exclude '**/libWebViewCore_**.so'  // Hapus file .so yang tidak diperlukan untuk mengurangi ukuran paket
       }
    }
    
    dependencies {
      ...
      api 'com.mpaas.myweb:mpaasmywebapi-build:xxx@aar'
      api 'com.mpaas.myweb:mpaasmyweb:xxx@aar'
      
      // Diperlukan untuk kontainer Mini Program. Jangan tambahkan jika Anda tidak menggunakan Mini Program.
      api 'com.mpaas.mriver:mrivermyweb-build:xxx@aar'
      
      // Diperlukan untuk kontainer H5.
      api 'com.mpaas.nebula:nebulamyweb-build:xxx@aar'
    }
  3. Tambahkan konfigurasi obfuscation.

    -keep class com.alipay.mywebview.** {*;}
  4. Minta kode otorisasi dan konfigurasikan dalam file AndroidManifest.xml dengan format berikut.

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

    Permintaan memerlukan nama paket APK dan digest signature SHA-256.

Cara mendapatkan digest signature

Metode 1: Gunakan perintah apksigner yang termasuk dalam Android SDK.

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

// Contoh output
Signer #1 certificate SHA-256 digest: 389b49f7832f53e9017923220aa85e14dfaa4886ecd7428818bf339543cf498a

Metode 2: Gunakan keytool.

keytool -printcert -jarfile test.apk | grep SHA256

// Contoh output 
 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

Validasi aplikasi kernel

Filter log untuk melihat versi webview. Jika nomor versinya adalah 0.11.xxx, berarti kernel berhasil diintegrasikan.

image.png

Untuk pelanggan yang sudah ada

Jika aplikasi mPaaS Anda sebelumnya telah mengintegrasikan kernel UC, pastikan poin-poin berikut:

  • Periksa apakah Anda telah menyesuaikan logika kernel tertentu. Jika iya, Anda harus mengimplementasikannya ulang menggunakan antarmuka baru. Untuk memeriksanya, cari di kode Anda import com.uc.xxxxx.

  • Versi kernel baru tidak lagi mendukung Mini Program Nebula. Jika Anda menggunakan Mini Program Nebula, lakukan upgrade ke kontainer Mini Program yang baru.

  • Fitur regresi mencakup hal-hal berikut:

    • Untuk komponen kontainer H5, termasuk halaman H5 yang disematkan dalam Mini Program, lakukan pengujian regresi pada fitur-fitur terkait kernel. Ini mencakup semua fungsi halaman H5 dan skenario di mana Anda beralih secara dinamis ke kernel sistem.

    • Untuk komponen Mini Program, lakukan pengujian regresi pada fitur-fitur Mini Program. Ini mencakup rendering, komponen, API, dan plugin.