Cara mengintegrasikan Android menggunakan metode berbasis komponen - Mobile Platform as a Service

Untuk menggunakan metode berbasis komponen, lakukan langkah-langkah berikut:

Buat proyek baru pada client

Topik ini menjelaskan cara membuat aplikasi baru dalam lingkungan pengembangan Windows. Anda akan mengompilasi dan mengemas aplikasi tersebut untuk menghasilkan paket .apk yang dapat dijalankan.

Sebelum membuat proyek baru pada client, selesaikan tugas-tugas berikut:

Buat proyek Portal

Solusi berbasis komponen menggunakan metode Portal-Bundle. Anda harus terlebih dahulu membuat proyek Portal.

Proyek Portal biasanya tidak berisi kode bisnis. Tujuannya adalah menggabungkan Bundle menjadi paket .apk yang dapat dijalankan. Saat membuat proyek Portal, proyek Bundle dengan akhiran Launcher akan dibuat secara default.

Ikuti langkah-langkah berikut:

Setelah membuka Android Studio, klik Start a new mPaaS project pada halaman selamat datang.
Pada jendela Create New mPaaS Project, pilih mPaaS Portal, lalu klik Next.
Masukkan Project name. Untuk Path of configuration file (JSON) from console, pilih file konfigurasi .config yang telah Anda unduh dari Code Management > Code Configuration di Konsol. Plugin mPaaS akan secara otomatis mengurai file konfigurasi tersebut dan mengisi Package Name. Klik Next.
Pilih versi SDK mPaaS dan pilih dependensi modul yang diperlukan, lalu klik Next.
Penting
- Pilih dependensi modul sesuai kebutuhan. Untuk informasi lebih lanjut tentang dependensi, lihat dokumen integrasi setiap komponen.
- Anda juga dapat memilih hanya dependensi framework yang diperlukan. Setelah membuat aplikasi, Anda dapat menambahkan dependensi lain melalui fitur mPaaS plug-in > Component Management. Untuk informasi lebih lanjut, lihat dokumen integrasi setiap komponen.
Konfirmasi informasi untuk proyek Bundle default, lalu klik Finish.

Anda kini telah membuat proyek Portal dan proyek Bundle default.

Buat proyek Bundle baru

Framework mPaaS mendukung multiple Bundles. Anda dapat menambahkan beberapa proyek Bundle ke dalam proyek Anda.

Klik File > New > Start a New mPaaS Project.
Pada jendela Create New mPaaS Project, pilih mPaaS Portal, lalu klik Next.
Masukkan Project name. Untuk Path of configuration file (JSON) from console, pilih file konfigurasi .config yang telah Anda unduh dari Code Management > Code Configuration di Konsol. Plugin mPaaS akan secara otomatis mengurai file konfigurasi tersebut dan mengisi Package Name. Klik Next.
Pilih versi SDK mPaaS dan pilih dependensi modul yang diperlukan, lalu klik Next.
Konfirmasi informasi untuk proyek Bundle default, lalu klik Finish.

Anda kini telah membuat proyek Bundle. Untuk informasi lebih lanjut tentang pengembangan Bundle, lihat Bundle project.

Langkah selanjutnya

Lihat dokumen integrasi setiap komponen untuk mengintegrasikan dan menggunakan komponen mPaaS.

Tautan terkait

Metode berbasis komponen > Pengantar: Menjelaskan struktur kode, hasil kompilasi dan pengemasan, serta perbedaan dari proyek native untuk proyek Portal dan Bundle.

Kelola dependensi komponen

Untuk menyederhanakan peningkatan baseline SDK mPaaS dan manajemen dependensi komponen, pertama-tama perbarui plugin mPaaS Android Studio ke versi terbaru. Untuk informasi lebih lanjut tentang cara memperbarui plugin mPaaS, lihat Update the mPaaS plug-in.

Tambahkan dependensi komponen

Untuk menggunakan komponen mPaaS, tambahkan dependensi komponen tersebut ke proyek Portal dan Bundle:

Menambahkan dependensi ke proyek Portal memastikan bahwa dependensi tersebut termasuk dalam APK saat proses packaging.
Menambahkan dependensi ke proyek Bundle memastikan bahwa Anda dapat memanggil API komponen tersebut dalam proyek Bundle.
Untuk proyek Portal tunggal, tambahkan dependensi hanya ke proyek Portal.
Jika Anda sudah memilih komponen saat membuat proyek mPaaS, Anda tetap dapat menambah atau menghapus komponen dengan mengikuti langkah-langkah di bawah ini.

Prosedur

Di Android Studio, pilih mPaaS > Component-based Integration. Pada panel integrasi yang muncul, klik Start Configuration di bawah Configure/Update Components.
Pada jendela manajemen komponen yang muncul, klik tombol untuk menginstal komponen yang Anda butuhkan.
- Untuk komponen yang belum diinstal, tombolnya bertuliskan "Not Installed". Klik tombol tersebut untuk menginstal komponen.
- Untuk komponen yang sudah diinstal, tombolnya bertuliskan "Installed". Klik tombol tersebut lagi untuk menguninstal komponen.

Langkah selanjutnya

Jika ini pertama kalinya Anda menggunakan fitur Component Management pada plugin mPaaS Android Studio untuk menambahkan komponen, Anda juga harus memeriksa atau memodifikasi konfigurasi berikut.

Periksa file build.gradle di direktori root proyek Portal atau Bundle. Pastikan file tersebut berisi dependensi berikut dengan versi 2.8.0 atau lebih baru:
```
buildscript {
 ...
 dependencies {
     classpath 'com.android.boost.easyconfig:easyconfig:2.8.4'
 }
}
```

Periksa file build.gradle di modul utama proyek Portal. Pastikan file tersebut berisi konten berikut:

apply plugin: 'com.alipay.portal'
portal {
 allSlinks true
 mergeAssets true
}
apply plugin: 'com.alipay.apollo.baseline.update'
mpaascomponents{
 excludeDependencies=[]
}

Hapus dependensi lama:
Penting
Buat backup konten berikut sebelum menghapusnya.
- Untuk mode Portal & Bundle, pada file build.gradle di modul utama proyek Portal, hapus dependensi komponen mPaaS di bawah node dependencies. Jangan hapus mpaas-baseresjar.
- Untuk mode proyek Portal tunggal, pada file build.gradle di modul utama, hapus konten berikut:
```
apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_bundles.gradle"
apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_apis.gradle"
```
  Selain itu, hapus file mpaas_bundles.gradle dan mpaas_apis.gradle dari direktori root proyek. Perlu diperhatikan bahwa menghapus file mpaas_apis.gradle dapat menyebabkan kegagalan kompilasi. Anda harus memodifikasi konfigurasi di sub-modul seperti yang dijelaskan di bawah.
Untuk memanggil API komponen mPaaS di sub-modul:
- Untuk proyek mode Portal & Bundle, tambahkan berikut ini ke file build.gradle di sub-modul proyek Bundle:
```
apply plugin: 'com.alipay.apollo.baseline.update'
```
- Untuk mode proyek Portal tunggal, hapus berikut ini dari file build.gradle di sub-modul:
```
apply from: rootProject.getRootDir().getAbsolutePath() + "/mpaas_apis.gradle"
```
  Kemudian, tambahkan berikut ini:
```
apply plugin: 'com.alipay.apollo.baseline.update'
```
Jika dependensi lama berisi library kustom, Anda juga harus menambahkan dependensi kustom.
Jika kompilasi gagal karena konflik library, lihat Overview.

Upgrade baseline

Di Android Studio, pilih mPaaS > Component-based Integration. Pada panel integrasi yang muncul, klik Start Configuration di bawah Integrate/Upgrade Baseline.
Klik daftar drop-down versi, pilih versi baru, lalu klik OK untuk meningkatkan baseline.

Upgrade komponen tunggal

Versi baru

Di Android Studio, pilih mPaaS > Component Upgrade. Daftar komponen akan muncul.
Periksa status komponen dan lakukan upgrade. Jika notifikasi pembaruan muncul di pojok kanan atas, klik notifikasi tersebut untuk memperbarui komponen.

Versi lama

Di Android Studio, pilih mPaaS > Component Upgrade. Daftar komponen akan muncul.
Periksa status komponen dan lakukan upgrade:
- Jika statusnya Latest, komponen tersebut tidak perlu di-upgrade.
- Jika tidak, tersedia versi baru. Anda dapat mengklik tombol status untuk meng-upgrade komponen.

Tambahkan dependensi kustom

Jika ini pertama kalinya Anda menggunakan Component Management untuk mengelola komponen dan Anda belum melakukan upgrade SDK, tambahkan library kustom di bawah node dependencies dalam file build.gradle di modul utama proyek Portal. Contohnya:
```
bundle 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.18032216xxxx@jar'
manifest 'com.alipay.android.phone.mobilesdk:logging-build:2.0.2.18032216xxxx:AndroidManifest@xml'
```
Jika ini pertama kalinya Anda menggunakan Component Management untuk mengelola komponen dan Anda telah melakukan upgrade SDK, atau jika Anda telah melakukan upgrade SDK menggunakan Baseline Upgrade, library kustom Anda mungkin memerlukan penyesuaian ulang untuk versi baru tersebut. submit a ticket atau hubungi dukungan teknis mPaaS untuk konfirmasi. Setelah library disesuaikan ulang, atau setelah Anda mengonfirmasi bahwa penyesuaian ulang tidak diperlukan, Anda dapat menambahkan dependensi kustom seperti yang dijelaskan di atas.

Build

Klik mPaaS > Build untuk mengompilasi proyek menggunakan fitur Build pada plugin mPaaS untuk Android Studio.