Mobile Platform as a Service：Gunakan Plugin mPaaS

Plugin mPaaS menyediakan fungsi-fungsi berikut: Akses AAR Asli, Akses Berkomponen, Alat Dasar, Bantuan, dan Build.

• Panel akses tersedia untuk fungsi Akses AAR Asli dan Akses Berkomponen. Wisaya akses pada panel akses dapat membimbing Anda menambahkan mPaaS ke proyek melalui mode akses tertentu. Setelah akses selesai, Anda juga dapat memperbarui baseline dan mengelola komponen pada panel akses.

• Plugin mPaaS menyediakan Alat Dasar berikut: Hasilkan Gambar Enkripsi (File Konfigurasi Apsara Stack), Hasilkan APK Bertanda Tangan, dan Hasilkan Info Penandatanganan Kunci UC. Alat-alat ini membantu Anda menyiapkan informasi yang diperlukan untuk penggunaan fungsi mPaaS dengan mudah.

• Plugin mPaaS menyediakan fungsi Bantuan berikut: Alat Diagnostik Log, Masalah Umum, dan Lihat Dokumentasi, untuk mendukung Anda menyelesaikan masalah umum.

• Build memungkinkan Anda membangun proyek setelah Anda mendapatkan akses ke mPaaS.

Tambahkan file konfigurasi

Langkah utama dalam proses akses adalah menambahkan file konfigurasi ke proyek. Plugin mPaaS mendukung impor manual untuk menambahkan file konfigurasi. Untuk impor manual, Anda perlu mengunduh file konfigurasi di konsol, lalu secara manual menambahkannya ke proyek melalui plugin mPaaS.

Akses AAR

Prosedur

1. Buka proyek yang ada di Android Studio, klik mPaaS > Akses AAR Asli.

2. Impor Konfigurasi App. Pada panel akses, klik Mulai Impor, ikuti impor manual untuk menambahkan file konfigurasi.

Langkah Lanjutan

1. Tambahkan dan perbarui baseline

2. Konfigurasikan dan perbarui komponen

Akses Berkomponen

Prosedur

1. Buka proyek yang ada di Android Studio dan klik mPaaS > Akses Berkomponen.

2. Impor Konfigurasi App.

   Pada panel akses, klik Mulai Impor, ikuti Tambahkan file konfigurasi untuk menambahkan file konfigurasi.

3. Konversi proyek. Jika proyek adalah proyek Android asli, Anda perlu mengonversi proyek.

   Pada panel akses, klik Instal mPaaS Portal. Di jendela Instal mPaaS Portal, pilih lokasi dan file konfigurasi proyek asli lalu klik OK.

Langkah Lanjutan

1. Tambahkan dan perbarui baseline

2. Konfigurasikan dan perbarui komponen

Tambahkan dan perbarui baseline

Perbarui ke baseline umum

Prosedur

1. Klik mPaaS > Akses AAR Asli atau Akses Berkomponen untuk membuka panel akses. Lalu klik Mulai Konfigurasi di bawah Akses/Perbarui Baseline.

2. Pilih versi baseline yang akan diperbarui dan klik OK. Setelah pembaruan selesai, pesan sukses akan ditampilkan.

Langkah Lanjutan

Klik baseline yang diperbarui pada panel akses. Anda akan melihat versi baseline di jendela pemilihan baseline.

Perbarui ke baseline kustom

Kami menyediakan baseline spesifik untuk semua pelanggan, seperti 10.1.32, 10.1.60, dan 10.1.68. Jika Anda memerlukan fungsi mPaaS kustom, Anda dapat menghubungi staf kami dan mengajukan permintaan. Kami akan menyesuaikan baseline sesuai permintaan Anda. Staf mPaaS akan memberikan ID baseline kustom Anda. Anda dapat memperoleh baseline kustom setelah memasukkan ID ini di Plugin mPaaS.

Prasyarat

Versi mPaaS V2.19111217 atau lebih baru diperlukan di Android Studio. Lihat Perbarui Plugin mPaaS untuk memeriksa versi Plugin mPaaS saat ini dan mempelajari cara memperbarui Plugin mPaaS.

Prosedur

1. Hapus file mpaas_package.json proyek di Android Studio.

2. Klik mPaaS > Akses AAR Asli atau Akses Berbasis Komponen untuk membuka panel akses. Lalu klik Mulai Konfigurasi di bawah Tambahkan dan Perbarui Baseline.

3. Di dialog pembaruan baseline, pilih Baseline Kustom dan masukkan ID baseline kustom.

4. Klik OK. Baseline kustom ditambahkan.

Konfigurasikan dan perbarui komponen

Pengelolaan komponen mPaaS (AAR)

Prasyarat

Anda telah memperbarui baseline.

Prosedur

1. Klik mPaaS > Akses AAR Asli untuk membuka panel akses. Lalu klik Start configuration di bawah Konfigurasikan dan Perbarui Komponen.

2. Di jendela manajemen yang ditampilkan, klik Pengelolaan Komponen mPaaS. Lalu pilih modul dan komponen yang akan dikelola dan klik OK. Jika proyek Anda berisi beberapa modul, Anda dapat memilih modul individual dan memilih komponen untuk setiap modul secara terpisah.

3. Setelah komponen ditambahkan, klik OK.

Pengelolaan Komponen

Prosedur

1. Klik mPaaS > Akses Berbasis Komponen untuk membuka panel akses. Lalu klik Mulai Konfigurasi di bawah Konfigurasikan dan Perbarui Komponen.

2. Di jendela manajemen komponen yang ditampilkan, klik tombol yang sesuai untuk menginstal komponen yang diperlukan.

Hasilkan gambar enkripsi (File konfigurasi Apsara Stack)

Saat beberapa komponen Plugin mPaaS mengakses jaringan, kontennya harus dienkripsi untuk memastikan keamanan.

• Gambar bernama yw_1222.jpg menyediakan kunci rahasia untuk enkripsi dan dekripsi. Komponen Plugin mPaaS secara otomatis menggunakan gambar ini untuk enkripsi dan dekripsi.

• Karena gambar terenkripsi ini telah ditinggalkan di lingkungan cloud publik, pengguna cloud publik dapat mengabaikan bagian ini.

Berikut ini menjelaskan cara menghasilkan dan menggunakan gambar enkripsi yw_1222.jpg.

Persiapan

Gambar terenkripsi terikat dengan file tanda tangan APK. Oleh karena itu, Anda perlu menyiapkan APK bertanda tangan dari proyek Portal Anda. Untuk instruksi penandatanganan terperinci, lihat Situs Resmi Android: Tandatangani aplikasi Anda.

null

APK ini menggunakan file tanda tangan yang sama dengan APK Release Version.

Gambar terenkripsi yang dihasilkan hanya dapat digunakan dalam proyek APK ini.

Pembuatan

Anda dapat menggunakan Plugin mPaaS untuk menghasilkan gambar enkripsi.

1. Di Android Studio, klik mPaaS > Alat Dasar > Hasilkan Gambar Enkripsi (File Konfigurasi Apsara Stack).

2. Di Release Apk, pilih APK bertanda tangan dari proyek Portal. Bidang RSA diisi secara otomatis.

3. Di File Konfigurasi mPaaS, pilih file .config dari proyek Portal. Bidang workSpaceId, appId dan packageName diisi secara otomatis. Jika bidang ini tidak diisi secara otomatis, masukkan konfigurasi yang sesuai sesuai dengan isi file .config proyek.

4. Isi bidang appsecret.

   null

   Sebagai administrator server, Anda dapat memeriksa appsecret yang sesuai dengan appid di konsol.

5. Di bidang jpg Version, masukkan nomor versi gambar penjaga keamanan.

   null

   Periksa versi securityguard di file build.gradle di bawah modul utama proyek Portal. Masukkan 4 jika versinya lebih rendah dari 5.4 (seperti securityguard-build:5.1.38.180402194514 di baseline). Jika tidak, masukkan 5.

6. Di outPath, pilih jalur keluaran untuk gambar penjaga keamanan yw_1222.jpg. Gambar terenkripsi yang dihasilkan akan disimpan di bawah jalur lokal ini.

7. Klik OK untuk menghasilkan gambar enkripsi.

Penggunaan

Berikut ini menjelaskan cara menggunakan gambar enkripsi:

1. Simpan gambar enkripsi yw_1222.jpg di folder res/drawable proyek Portal.

2. Jika ProGuard digunakan, Anda perlu menghindari kebingungan gambar enkripsi.

   1. Periksa apakah build.gradle berisi konfigurasi berikut:

      minifyEnabled true
      shrinkResources true

   2. Jika ya, Anda perlu membuat file keep.xml di bawah res/raw untuk menghindari kebingungan gambar enkripsi. Isi file adalah sebagai berikut:

      <?xml version="1.0" encoding="utf-8"?>
      <resources xmlns:tools="http://schemas.android.com/tools"
      tools:keep="@drawable/yw_1222*" /><!--tools:discard="@layout/unused2"-->

Hasilkan gambar perisai biru

Jika nilai absBase64Code dalam file .config yang Anda unduh dari konsol mPaaS kosong, lakukan langkah-langkah berikut untuk hasilkan gambar Perisai Biru.

Klik mPaaS > Alat dasar > Hasilkan gambar terenkripsi perisai biru, Masukkan informasi terkait untuk menghasilkan gambar perisai biru.

Deskripsi item input kunci pada gambar di atas:

• Release Apk : Paket apk rilis yang dikemas oleh proyek mPaaS, Anda harus menandatangani paket tersebut.

• MD5: Setelah paket apk rilis diunggah, akan diisi secara otomatis, yaitu public md5 key dari paket apk.

• File Konfigurasi mPaaS: Klik Unduh Konfigurasi di konsol mPaaS untuk mengunduh file .config dan mengimpornya.

• appSecret: Lihat di konsol mPaaS.

• Item lainnya appId, packageName, outPath akan diidentifikasi dan diisi secara otomatis setelah informasi di atas dimasukkan.

Akhirnya, tambahkan gambar yang dihasilkan ke direktori assets proyek.

Hasilkan APK Bertanda Tangan

Saat Anda mencoba mendapatkan file konfigurasi di konsol mPaaS, Anda perlu mengunggah file APK bertanda tangan. Prosedur akan ditangguhkan jika Anda belum membuat proyek atau mengompilasi APK bertanda tangan. Plugin mPaaS menyediakan fungsi Hasilkan APK Bertanda Tangan untuk menyederhanakan prosedur ini di Android Studio. Fungsi ini dapat menghasilkan APK bertanda tangan setelah Anda memasukkan parameter yang diperlukan untuk penandatanganan APK.

Pembuatan

1. Klik mPaaS > Alat Dasar > Hasilkan APK Bertanda Tangan yang Digunakan di Konsol untuk membuka halaman Bangun APK Bertanda Tangan.

2. Di halaman Bangun APK Bertanda Tangan, masukkan informasi konfigurasi yang diperlukan.

3. Klik OK. APK bertanda tangan dihasilkan.

4. Klik Tampilkan di Finder. Anda dapat menemukan file APK yang dihasilkan. Nama file adalah mpaas-signed.apk. Pembuatan APK bertanda tangan selesai.

   Buka file APK. Anda dapat melihat bahwa file tersebut kecil dan telah ditandatangani.

Bantuan

Alat Diagnostik Log

1. Klik mPaaS > Bantuan > Alat Diagnostik Log.

2. Salin dan tempel log yang akan dianalisis di kotak teks dan klik Selanjutnya.

3. Tunggu hingga analisis selesai.

4. Lihat hasil analisis.

   Hasil analisis berisi Penyebab dan Solusi. Anda dapat memodifikasi kode Anda sesuai dengan penyebab dan solusi jika ada masalah yang ditemukan.

5. Setelah modifikasi, klik Selesai untuk menutup jendela.

FAQ

Klik mPaaS > Bantuan > Masalah Umum untuk pergi ke Masalah akses Android umum. Anda dapat memeriksa masalah umum yang mungkin Anda temui saat mengakses Android.

Lihat Dokumen

Klik mPaaS > Bantuan > Lihat Dokumen untuk pergi ke Pusat Dokumentasi mPaaS. Anda dapat melihat dokumen semua komponen.

Build

Di Android Studio, pilih mPaaS > Build. Lalu Anda dapat membangun proyek Anda.