Mobile Platform as a Service:Integrate the mPaaS kernel

Integration instructions

1. Add a new Maven configuration. For more information, see Manually configure a Maven repository.

2. In the app's build.gradle file, add the following configuration. For specific SDK version numbers, see mPaaS kernel release notes.

   android {
     ...
      configurations {
           // Remove UC
           all*.exclude group: 'com.mpaas.mriver', module: 'mriveruc-build'
           all*.exclude module: 'nebulauc-build'
      }
   
      packagingOptions {
         exclude '**/libWebViewCore_**.so'  // Remove unnecessary .so files to reduce the package size
      }
   }
   
   dependencies {
     ...
     api 'com.mpaas.myweb:mpaasmywebapi-build:xxx@aar'
     api 'com.mpaas.myweb:mpaasmyweb:xxx@aar'
     
     // Required for Mini Program containers. Do not add if you are not using Mini Programs.
     api 'com.mpaas.mriver:mrivermyweb-build:xxx@aar'
     
     // Required for H5 containers.
     api 'com.mpaas.nebula:nebulamyweb-build:xxx@aar'
   }

3. Add an obfuscation configuration.

   -keep class com.alipay.mywebview.** {*;}

4. Request an authorization code and configure it in the AndroidManifest.xml file in the following format.

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

   Important

   The request requires the APK package name and the SHA-256 signature digest.

How to get the signature digest

Method 1: Use the apksigner command included in the Android SDK.

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

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

Method 2: Use keytool.

keytool -printcert -jarfile test.apk | grep SHA256

// Sample 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

Kernel application validation

Filter the logs for the webview version. If the version number is 0.11.xxx, the kernel is successfully integrated.

For existing customers

If your mPaaS app previously integrated the UC kernel, confirm the following points:

• Check if you have customized any specific kernel logic. If so, you must reimplement it using the new interfaces. To check, search your code for import com.uc.xxxxx.

• The new kernel version no longer supports Nebula Mini Programs. If you use Nebula Mini Programs, upgrade to the new Mini Program container.

• The regression feature includes the following:

  • For the H5 container component, including embedded H5 pages in Mini Programs, perform regression testing on kernel-related features. This includes all H5 page functions and scenarios where you dynamically switch to the system kernel.

  • For the Mini Program component, perform regression testing on Mini Program features. This includes rendering, components, APIs, and plugins.