Mobile Platform as a Service：Memulai dengan cepat

Mriver Tiny App hanya tersedia di versi dasar mobile PaaS (mPaaS) 10.2.3 dan mendukung integrasi AAR asli mPaaS. Untuk informasi lebih lanjut, lihat Tentang Integrasi AAR Asli.

Prasyarat

Sebelum mengintegrasikan Mriver Tiny App ke Android, pastikan Anda telah mengaktifkan mPaaS dan mengintegrasikan mPaaS menggunakan integrasi AAR asli. Lihat Prasyarat.

Prosedur

Berikut adalah langkah-langkah untuk mengintegrasikan Mriver Tiny App:

1. Pilih Baseline.

   1. Tambahkan Baseline 10.2.3.

   2. Tambahkan Komponen Mini Program.

2. Inisialisasi Konfigurasi.

   1. Inisialisasi mPaaS.

   2. Konfigurasikan Verifikasi Tanda Tangan Mini Program.

   3. Gunakan Kernel mPaaS.

3. Rilis Mini Program.

   1. Masuk ke Backend Mini Program.

   2. Konfigurasikan Nama Domain Virtual.

   3. Buat Mini Program.

   4. Rilis Mini Program.

4. Mulai Mini Program.

Berikut ini menjelaskan setiap langkah secara rinci.

Pilih baseline

1. Tambahkan Baseline 10.2.3.

   Klik mPaaS > Native AAR Integration. Pada jendela popup, klik Mulai Konfigurasi di bawah bagian Integrate/Upgrade Baseline dan tambahkan baseline 10.2.3.

2. Tambahkan Komponen Mini Program.

   Instal komponen Mriver Tiny App melalui Manajemen Komponen (AAR) di proyek.

Inisialisasi konfigurasi

Inisialisasi mPaaS

Inisialisasi mPaaS menggunakan kerangka kerja mPaaS (disarankan)

1. Tambahkan kode inisialisasi berikut ke Application.

   public class MyApplication extends Application {
       
       @Override
       public void onCreate() {
           super.onCreate();
           // Inisialisasi mPaaS
           MP.init(this);    
       }
   }

   Untuk detail lebih lanjut, lihat Inisialisasi mPaaS.

2. Tambahkan konfigurasi meta ke AndroidManifest.xml.

   <meta-data
       android:name="mpaas.init.param"
       android:value="com.xxx.xxx.MriverInitImpl" />

3. Tambahkan com.xxx.xxx.MriverInitImpl untuk mengimplementasikan MPInitParamManifest.

   import android.content.Context;
   
   import com.mpaas.core.MPInitParam;
   import com.mpaas.mriver.api.init.MriverInitParam;
   
   public class MriverInitImpl implements com.mpaas.MPInitParamManifest {
       @Override
       public MPInitParam initParam(Context context) {
           MriverInitParam mriverInitParam = MriverInitParam.getDefault();
           mriverInitParam.setMriverInitCallback(new MriverInitParam.MriverInitCallback() {
               @Override
               public void onInit() {
                   if (com.alibaba.ariver.kernel.common.utils.ProcessUtils.isMainProcess()) {
                       // Konfigurasi terkait mini program, seperti jsapi kustom, titlebar, dll.
   
                   }
               }
   
               @Override
               public void onError(Exception e) {
   
               }
           });
           return MPInitParam.obtain().addComponentInitParam(mriverInitParam);
       }
   }

Inisialisasi mPaaS menggunakan MPInit

Inisialisasi mPaaS dengan menambahkan kode berikut ke Application.

public class MyApplication extends Application implements MPInitParam.MPCallback {
    @Override
    public void onCreate() {
        super.onCreate();
        // Menginisialisasi mPaaS.
        MriverInitParam mriverInitParam = MriverInitParam.getDefault();
        mriverInitParam.setMriverInitCallback(new MriverInitCallback() {
            @Override
            public void onInit() {
                if (com.alibaba.ariver.kernel.common.utils.ProcessUtils.isMainProcess()) {
                    // Konfigurasikan Mriver Tiny App, seperti menyesuaikan jsapi dan titlebar.

                }
            }

            @Override
            public void onError(Exception e) {

            }
        });
        MP.init(this, MPInitParam.obtain().setCallback(this).addComponentInitParam(mriverInitParam));
    }
    
    @Override
    public void onInit() {
        // inisialisasi berhasil
    }
}

Konfigurasikan verifikasi tanda tangan mini program

Mriver Tiny App menyediakan fitur verifikasi tanda tangan paket. Secara default, verifikasi tanda tangan paket debug dinonaktifkan, sedangkan verifikasi tanda tangan paket rilis diaktifkan. Verifikasi tanda tangan dapat dikontrol oleh API.

// Nonaktifkan verifikasi tanda tangan.
MriverResource.disableVerify();

// Aktifkan verifikasi tanda tangan, di mana xx adalah kunci publik yang sesuai dengan kunci pribadi yang dikonfigurasi di backend.
MriverResource.enableVerify(MriverResource.VERIFY_TYPE_YES,"xx");

Konfigurasikan interval untuk meminta paket mini program

mPaaS mendukung pengaturan interval untuk meminta paket mini program, yang dapat dikontrol oleh API.

Mriver.setConfig("h5_nbmngconfig", "{\"config\":{\"al\":\"3\",\"pr\":{\"4\":\"86400\","
    + "\"common\":\"864000\"},\"ur\":\"1800\",\"fpr\":{\"common\":\"3888000\"}},"
    + "\"switch\":\"yes\"}");

Di sini, \"ur\":\"1800\" menentukan interval pembaruan global, di mana 1800 adalah nilai default dalam detik. Ubah nilainya untuk mengatur interval permintaan paket mini program global. Nilai berkisar antara 0 hingga 86400 detik, yaitu 0 hingga 24 jam. 0 menunjukkan bahwa interval tidak dibatasi.

Gunakan kernel mPaaS

Kemampuan rendering lapisan yang sama dari kernel mPaaS berbasis mini program dapat meningkatkan pengalaman penyematan WebView, peta, video, dan komponen lainnya. Untuk integrasi dan aplikasi kernel mPaaS, lihat Integrasi Kernel mPaaS.

Rilis mini program

Sebelum memulai mini program, Anda harus merilis mini program di konsol mPaaS. Lakukan langkah-langkah berikut:

1. Masuk ke backend mini program. Masuk ke konsol mPaaS, dan pilih aplikasi target. Di panel navigasi di sebelah kiri, pilih Mini Program > Mini Program Release.

2. Konfigurasikan nama domain virtual. Untuk mengonfigurasi nama domain virtual untuk pertama kalinya, pilih Mini Program > Mini Program Release > Manage configuration. Nama domain virtual dapat berupa salah satu nama domain Anda. Kami sarankan Anda menggunakan nama domain perusahaan Anda, seperti example.com.

3. Buat mini program. Masuk ke konsol mPaaS dan lakukan langkah-langkah berikut:

   1. Di panel navigasi di sebelah kiri, pilih Mini Program > Mini Program Release.

   2. Di halaman daftar mini program, klik Create.

   3. Di jendela Create Mini Program, masukkan ID dan nama mini program, lalu klik OK. ID mini program adalah nomor 16 digit, misalnya 2018080616290001.

   4. Di daftar mini program, temukan mini program baru, dan klik Add.

   5. Di bagian Informasi Dasar, atur parameter berikut:

      • Versi: Masukkan nomor versi paket mini program, misalnya 1.0.0.0.

      • Rentang versi klien: Pilih rentang versi klien Android yang berlaku untuk mini program. Hanya aplikasi klien dalam rentang tersebut yang dapat memulai mini program. Versi minimum bisa 0.0.0 sedangkan versi maksimum bisa dibiarkan kosong, yang menunjukkan bahwa mini program dapat dimulai tanpa memandang versi klien.

        Catatan

        Masukkan versi klien Android, bukan versi mini program.

      • Ikon: Klik Select file untuk mengunggah ikon paket mini program. Ikon diperlukan saat Anda membuat paket mini program untuk pertama kali. Contoh ikon:

      • File: Unggah file sumber paket mini program, yang harus berupa file .zipklik di sini untuk mengunduh. Berikut adalah demo mini program mPaaS (), dan Anda dapat langsung mengunggahnya.

        Catatan

        Sebelum mengunggahnya, ubah nama file zip dan foldernya menjadi ID 16 digit mini program Anda.

   6. Di bagian Informasi Konfigurasi, atur parameter berikut:

      • URL Entri: Wajib. Ini adalah halaman utama mini program. Formatnya adalah /index.html#xxx/xxx/xxx/xxx, di mana xxx/xxx/xxx/xxx setelah # adalah nilai pertama di bawah pages di app.json. Entri demo mini program mPaaS adalah /index.html#page/tabBar/component/index.

      • Untuk parameter lainnya, pertahankan nilai default.

   7. Centang kotak I confirm that the information provided is true and correct.

   8. Klik Submit.

4. Rilis mini program. Masuk ke konsol mPaaS dan lakukan langkah-langkah berikut:

   1. Di panel navigasi di sebelah kiri, pilih Mini Program > Mini Program Release > Mini Program Official Package Management.

   2. Di halaman daftar mini program, pilih mini program target dan versi, dan klik Create release task.

   3. Di bagian Buat tugas rilis, atur parameter berikut:

      • Jenis rilis: Pilih Official.

      • Deskripsi rilis: Opsional.

      Klik OK untuk membuat tugas rilis.

Mulai mini program

Setelah langkah-langkah di atas, Anda dapat menjalankan kode berikut di proyek Android Anda untuk memulai demo mini program.

Mriver.startApp("2018080616290001");