Mobile Platform as a Service:Integrar o kernel do mPaaS

Substitua o kernel UC pelo kernel MyWeb do mPaaS no seu aplicativo Android. Para isso, configure o Maven, adicione as dependências do Gradle, obtenha um código de autorização e valide o resultado.

Pré-requisitos

Antes de começar, verifique se o aplicativo atende ao seguinte requisito:

Etapas de integração

1. Adicione uma nova configuração de repositório Maven. Para mais detalhes, consulte Configurar manualmente um repositório Maven.

2. No arquivo build.gradle do aplicativo, adicione a configuração abaixo. Para os números de versão do SDK, consulte Notas de lançamento do kernel do mPaaS.

   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. Inclua a seguinte regra de ofuscação do ProGuard:

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

4. Solicite um código de autorização e adicione-o ao arquivo AndroidManifest.xml:

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

   Importante

   A solicitação exige o nome do pacote APK e o resumo da assinatura SHA-256.

Obter o resumo da assinatura SHA-256

Utilize um dos métodos a seguir:

Método 1: apksigner

Use a ferramenta apksigner do SDK do Android:

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

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

Método 2: keytool

Execute o comando keytool do JDK:

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

Verifique a integração

Filtre os logs pela versão do WebView. Se o número da versão for 0.11.xxx, a integração do kernel foi bem-sucedida.

Para clientes existentes

Se o aplicativo usava anteriormente o kernel UC, confirme os pontos abaixo antes de entrar em produção:

• Verifique se há lógica personalizada do kernel. Pesquise no código por import com.uc.xxxxx. Se houver correspondências, reimplemente essa lógica com as novas interfaces.

• O novo kernel não oferece mais suporte aos Mini Programas Nebula. Caso utilize Mini Programas Nebula, atualize primeiro para o novo contêiner de Mini Programas.

• Execute testes de regressão nas seguintes áreas:

  • Contêiner H5: Teste todas as funções das páginas H5, incluindo páginas incorporadas em Mini Programas e cenários de alternância dinâmica para o kernel do sistema.

  • Contêiner de Mini Programas: Valide a renderização, os componentes, as APIs e os plugins.