Mengintegrasikan kontainer miniapp ke dalam aplikasi asli - SuperApp

Enterprise Mobile Application Studio (EMAS) memungkinkan Anda mengintegrasikan kontainer miniapp WindVane atau uni-app ke dalam aplikasi asli. Topik ini menjelaskan cara mengintegrasikan kontainer miniapp ke dalam aplikasi Android.

Prasyarat

AccessKey, SecretKey, dan App Code dari aplikasi asli telah diperoleh. Untuk informasi lebih lanjut, lihat topik Konfigurasi Aplikasi di bab Application Open Platform (untuk operator platform) dari Panduan Pengguna.
ID sebuah miniapp telah diperoleh. Untuk informasi lebih lanjut, lihat Buat Miniapp.
Nama domain dari Application Open Platform telah diperoleh. Nama domain lingkungan demo adalah emas-publish-intl.emas-poc.com.

Langkah 1: Tambahkan repositori Maven

Dalam file build.gradle yang terletak di direktori root proyek, tambahkan repositori Maven.

Catatan

SDK untuk kontainer miniapp tersedia di repositori Maven yang diterapkan di Apsara Stack. Untuk informasi tentang URL repositori sebenarnya, akun, dan kata sandi, hubungi insinyur O&M.

allprojects {
    repositories {
        google()
        mavenCentral()
        jcenter() // Peringatan: repositori ini akan segera ditutup
        maven {
            url 'http://nexus-ce.xxx.com/repository/maven-public/'
            credentials {
                username = '${username}'
                password = '${password}'
            }
        }
    }
}

Langkah 2: Tambahkan dependensi

Dalam file build.gradle dari proyek app, tambahkan dependensi untuk kontainer miniapp.

dependencies{
  // SDK dasar untuk kontainer miniapp. Dependensi ini diperlukan baik untuk WindVane maupun uni-app.
  implementation 'com.aliyun.emas.suite.core:servicebus:1.0.0'
  api "com.aliyun.emas.suite.foundation:mini-app-adapter:1.3.0"
  // SDK untuk kontainer miniapp WindVane. Jika Anda ingin mengintegrasikan kontainer miniapp WindVane ke dalam aplikasi, sertakan dependensi ini. 
  implementation "com.aliyun.emas.suite.foundation:windvane-mini-app:1.3.2"
  // SDK untuk kontainer miniapp uni-app. Jika Anda ingin mengintegrasikan kontainer miniapp uni-app ke dalam aplikasi, sertakan dependensi ini. 
  implementation "com.aliyun.emas.suite.foundation:uniapp-mini-app:1.3.0"
}

Penting

Jika proyek menggunakan dependensi AndroidX, pastikan bahwa file gradle.properties di direktori root proyek berisi konfigurasi berikut:

android.useAndroidX=true
android.enableJetifier=true

Langkah 3: Inisialisasi kontainer

Anda harus menginisialisasi kontainer miniapp sebelum dapat menggunakannya.

MiniAppInitConfig config = new MiniAppInitConfig.Builder()
  .setUseWindVane(true) // Konfigurasikan metode ini untuk miniapp WindVane.
  .setUseUniApp(true)  // Konfigurasikan metode ini untuk miniapp uni-app.
  .setAccessKey("ZXZ****")  // Dapatkan AccessKey dari Application Open Platform.
  .setSecretKey("3PNJxKtf7/eqUohlG3bI****")  // Dapatkan SecretKey dari Application Open Platform.
  .setHost("emas.example.com")// Tentukan nama domain dari Application Open Platform. Nilai dalam kode contoh ini hanya untuk referensi. Nama domain lingkungan demo adalah emas-publish-intl.emas-poc.com. 
  .setAppCode("161160300555671164****")  // Dapatkan App Code dari Application Open Platform.
  .build();
IMiniAppService miniAppService = new MiniAppService();
miniAppService.initialize(application, config);
ServiceManager.getInstance().registerService(IMiniAppService.class.getName(), miniAppService);

// Kode berikut memberikan contoh konfigurasi inisialisasi untuk kontainer miniapp WindVane. Jika Anda ingin mengintegrasikan kontainer miniapp WindVane ke dalam aplikasi, sertakan konfigurasi tersebut. 
WVCamera.registerUploadService(CustomWVUploadService.class);

Catatan

API JavaScript dari WVCamera perlu mengunggah gambar lokal ke server untuk mendapatkan URL gambar, lalu mengembalikan URL gambar ke miniapp. Saat Anda mengintegrasikan kontainer ke dalam aplikasi, Anda harus mendaftarkan implementasi unggah gambar.

Pengaturan Lingkungan Pengembangan

Versi Gradle: 6.7.1

Versi Plugin Android Gradle: 4.2.2

Versi JDK: 8

MinSdkVersion: 16

TargetSdkVersion: 30

Catatan

Konfigurasi yang disebutkan di atas merupakan pengaturan lingkungan yang direkomendasikan, yang mungkin memerlukan pembaruan untuk kompatibilitas dengan versi yang berbeda.

Referensi API

Untuk informasi lebih lanjut, lihat Referensi API.