Topik ini menjelaskan cara mengintegrasikan komponen MSS ke dalam klien Android.
Catatan Sejak 28 Juni 2020, mPaaS tidak lagi memelihara baseline 10.1.32. Gunakan baseline 10.1.68 atau 10.1.60. Untuk melakukan upgrade versi baseline Anda, lihat Panduan Upgrade mPaaS 10.1.68 atau Panduan Upgrade mPaaS 10.1.60. |
Komponen MSS mendukung dua metode integrasi: integrasi berbasis native AAR dan integrasi berbasis komponen.
Prosedur integrasi terdiri dari dua langkah:
Prasyarat
Anda telah mengintegrasikan proyek Anda dengan mPaaS.
Untuk integrasi berbasis native AAR, tambahkan mPaaS ke proyek Anda.
Untuk integrasi berbasis komponen, selesaikan proses integrasi berbasis komponen.
Tambahkan SDK
Integrasi berbasis native AAR
Gunakan Component Management (AAR) untuk menginstal komponen SYNC di proyek Anda. Untuk informasi selengkapnya, lihat manajemen komponen AAR.
Integrasi berbasis komponen
Pada proyek Portal dan Bundle, gunakan Component Management untuk menginstal komponen SYNC.
Untuk informasi selengkapnya, lihat Kelola dependensi komponen > Tambahkan atau hapus dependensi komponen.
Gunakan SDK
Pada baseline 10.1.32 dan yang lebih baru, kelas MPSync di lapisan middleware mPaaS mengenkapsulasi semua API komponen MSS. Anda dapat menggunakan objek MPSync untuk mengakses semua fitur MSS.
Tabel berikut memberikan ikhtisar cepat mengenai API MSS. Untuk informasi selengkapnya tentang API tersebut, lihat Referensi API Android.
API | Deskripsi |
setup(Application application) | Menginisialisasi layanan dasar yang dibutuhkan oleh MSS. Metode ini harus dipanggil sebelum metode |
initialize(Context context) | Menginisialisasi API dan layanan MSS. |
appToForeground() | Memberi tahu client SDK bahwa aplikasi dimulai untuk membuat koneksi jaringan dengan server. Panggil metode ini setiap kali aplikasi dibawa ke foreground. |
appToBackground() | Memberi tahu client SDK bahwa aplikasi dikirim ke background untuk memutus koneksi dengan server. Panggil metode ini setiap kali aplikasi dikirim ke background. |
updateUserInfo(String sessionId) | Panggil metode ini ketika informasi login seperti userId atau sessionId berubah. Metode ini harus dipanggil minimal satu kali. |
clearUserInfo() | Logout pengguna. |
registerBiz(String bizType, ISyncCallback syncCallback) | Mendaftarkan |
unregisterBiz(String bizType) | Membatalkan pendaftaran konfigurasi sinkronisasi tertentu. Setelah konfigurasi dibatalkan, client SDK tidak lagi memanggil kelas implementasi |
reportMsgReceived(SyncMessage syncMessag) | Setelah data diterima dalam kelas implementasi |
isConnected() | Memeriksa apakah layanan MSS berjalan sesuai harapan. |
Contoh kode
Contoh ini dikembangkan menggunakan SDK baseline 10.1.32. Pada aplikasi contoh, sebuah tombol dikonfigurasi untuk mendapatkan ID perangkat saat diklik. Konsol kemudian menggunakan ID perangkat tersebut untuk mendorong data sinkronisasi ke perangkat. Identitas sinkronisasi adalah bizType.
Contoh ini hanya menunjukkan cara memanggil API MSS dan bukan merupakan praktik terbaik untuk MSS. Unduh kode praktik terbaik untuk komponen MSS dari halaman Dapatkan contoh kode.
public void button1Clicked(View view)
{
// Gunakan metode getUtdid untuk mendapatkan ID perangkat.
String utdid =UTDevice.getUtdid(MainActivity.this);
// Cetak data MSS di Logcat.
Log.e("=========",utdid);
// Inisialisasi API dan layanan MSS.
MPSync.initialize(MainActivity.this);
// Daftarkan callback untuk menerima data bisnis. Setelah data yang didorong diterima, syncCallback dipanggil.
MPSync.registerBiz("bizType",new SyncCallBackImpl());
// Buat koneksi jaringan dengan server.
MPSync.appToForeground();
}
public class SyncCallBackImpl implements ISyncCallback
{
@Override
public void onReceiveMessage(SyncMessage syncMessage) {
// Cetak data MSS di Logcat.
Log.e("=========",syncMessage.msgData);
// Beri tahu server MSS bahwa data berhasil diterima.
MPSync.reportMsgReceived(syncMessage);
}
}Dukungan TLS
Untuk mengaktifkan koneksi TLS pada port selain 443, tambahkan metadata mss_use_tls ke file manifest dan atur nilainya menjadi YES.
Koneksi pada port 443 menggunakan TLS secara default.