Cara mengintegrasikan mPaaS ke dalam proyek yang sudah ada menggunakan CocoaPods - Mobile Platform as a Service

Topik ini menjelaskan cara cepat mengintegrasikan mPaaS dengan menghasilkan konfigurasi melalui ekstensi plugin native CocoaPods.

Prasyarat

Anda telah menginstal CocoaPods versi 1.0.0 atau yang lebih baru. Untuk informasi selengkapnya, lihat CocoaPods. Proyek Anda harus merupakan proyek CocoaPods.
Anda telah menginstal plugin Cocoapods-mPaaS. Jika belum, jalankan perintah berikut untuk menginstalnya.
```
sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)
```
Anda telah membuat aplikasi di Konsol dan mengunduh file konfigurasi .config. Untuk informasi selengkapnya, lihat Buat aplikasi di Konsol.

Langkah-langkah integrasi

Salin file konfigurasi .config ke direktori root proyek Anda—direktori yang sama dengan lokasi file Podfile.
Catatan
Pastikan nama file .config yang diunduh diakhiri dengan iOS. Jika diakhiri dengan ios, ubah secara manual menjadi iOS.
Pada antarmuka baris perintah, jalankan perintah pod mpaas init. Perintah ini secara otomatis memproses file Podfile serta menambahkan konfigurasi plugin, source, dan mPaaS_baseline. Konfigurasi yang dihasilkan secara otomatis adalah sebagai berikut:
```
 plugin "cocoapods-mPaaS"
 source 'https://gitee.com/mpaas/podspecs.git'
 mPaaS_baseline 'x.x.x'
```

Konfigurasikan file Podfile.

Tentukan baseline mPaaS dengan mengubah nilai mPaaS_baseline. Contohnya, mPaaS_baseline '10.2.3', di mana 10.2.3 adalah nomor versi baseline. Untuk informasi mengenai perbedaan antarversi, lihat Catatan rilis.

Tambahkan dependensi komponen mPaaS menggunakan mPaaS_pod. Contohnya, mPaaS_pod "mPaaS_Nebula", di mana mPaaS_Nebula adalah nama komponen. Untuk daftar nama komponen, lihat tabel daftar komponen di bawah ini.

Konfigurasi Komponen	Baseline yang Berlaku	Deskripsi
mPaaS_pod "mPaaS_LocalLog"	10.1.32+	Local log
mPaaS_pod "mPaaS_Log"	10.1.32+	Mobile Analysis Service: Menganalisis log perilaku, log otomatis, log crash, dan log performa.
mPaaS_pod "mPaaS_Diagnosis"	10.1.32+	Diagnosis: Analisis diagnostik sisi client.
mPaaS_pod "mPaaS_RPC"	10.1.32+	Mobile Gateway Service: Menyediakan fitur seperti unduh, unggah, dan remote procedure calls (RPC).
mPaaS_pod "mPaaS_Sync"	10.1.32+	Mobile Sync Service: Layanan koneksi persisten.
mPaaS_pod "mPaaS_Push"	10.1.32+	Message Push Service
mPaaS_pod "mPaaS_Config"	10.1.32+	Configuration Switch: Mengambil nilai yang sesuai dari server berdasarkan kunci untuk mengontrol logika client secara dinamis.
mPaaS_pod "mPaaS_Upgrade"	10.1.32+	Upgrade and release: Menyediakan layanan untuk pemeriksaan upgrade proaktif. Gunakan untuk rilis canary dan notifikasi versi baru online.
mPaaS_pod "mPaaS_Share"	10.1.32+	Share: Mendukung berbagi teks dan gambar ke saluran populer seperti Weibo, DingTalk, dan teman Alipay.
mPaaS_pod "mPaaS_Nebula"	10.1.32+	HTML5 container and offline packages: Kontainer Nebula mendukung interaksi antara antarmuka depan dan kode native.
mPaaS_pod "mPaaS_UTDID"	10.1.32+	Device ID: Cepat mendapatkan ID perangkat untuk membantu aplikasi mengidentifikasi perangkat tertentu secara aman dan efektif.
mPaaS_pod "mPaaS_DataCenter"	10.1.32+	Datacenter: Menyediakan penyimpanan key-value (KV) yang aman, cepat, dan dapat dienkripsi yang mendukung multiple tipe data. Juga menawarkan berbagai solusi Persistensi, seperti dukungan Data Access Object (DAO) database.
mPaaS_pod "mPaaS_ScanCode"	10.1.32+	Scan Code: Cepat mengenali kode QR dan barcode.
mPaaS_pod "mPaaS_LBS"	10.1.32+	Location Based Service: Solusi lokasi untuk client mobile.
mPaaS_pod "mPaaS_CommonUI"	10.1.32+	Common UI: Pustaka komponen antarmuka pengguna (UI) umum.
mPaaS_pod "mPaaS_BadgeService"	10.1.32+	Badge Service: Komponen Notifikasi "titik merah" di sisi client. Mendukung gaya notifikasi seperti titik, angka, dan "Baru". Juga secara otomatis mengelola hubungan hierarkis badge.
mPaaS_pod "mPaaS_Multimedia"	10.1.32+	Multimedia component: Mendukung fitur seperti unduh gambar, unggah, dan cache.
mPaaS_pod "mPaaS_MobileFramework"	10.1.32+	Mobile Framework: Kerangka kerja aplikasi client. Mengelola sub-aplikasi, aplikasi multi-tab, pengalihan pihak ketiga, transisi viewController, serta penanganan dan pelaporan exception.
mPaaS_pod "mPaaS_OpenSSL"	10.1.32+	OpenSSL
mPaaS_pod "mPaaS_TinyApp"	10.1.32+	Mini Program: Menyediakan kemampuan untuk mengintegrasikan dan menerbitkan miniapps.
mPaaS_pod "mPaaS_CDP"	10.1.32+	Mobile Content Delivery Platform: Menyediakan pengiriman cerdas dan dinamis berbagai iklan pemasaran dan format tampilan ke client.
mPaaS_pod "mPaaS_ARTVC"	10.1.68	Audio and Video Call: Komponen panggilan audio dan video. Mendukung panggilan video dua arah dan multipihak serta rapat online.
mPaaS_pod "mPaaS_BlueShield"	10.2.3+	BlueShield encryption component: Tambahkan parameter absBase64Code ke file config untuk secara otomatis menghasilkan gambar BlueShield.
mPaaS_pod "mPaaS_MDC"	10.2.3+	Mobile Dispatch Component (MDC): Penjadwalan kebijakan Nama domain tingkat granularitas tinggi.

Berikut contoh Podfile lengkap:

Jalankan pod mpaas update x.x.x, di mana x.x.x adalah nomor baseline yang dikonfigurasi, misalnya 10.2.3.
Jalankan pod install untuk menyelesaikan integrasi. Anda juga dapat menambahkan --verbose untuk melihat log detail.
Catatan
Jika Anda menerima pesan bahwa library dari situs GitHub resmi tidak ditemukan saat menjalankan pod install, tambahkan alamat sumber GitHub resmi di bagian atas Podfile Anda: https://github.com/CocoaPods/Specs.git.
Jika terjadi konflik library pihak ketiga setelah integrasi, hapus library yang bertentangan tersebut. Untuk informasi selengkapnya, lihat Tangani konflik iOS.

Panduan upgrade

Saat versi baru mPaaS dirilis, Anda dapat melakukan upgrade komponen individual atau seluruh baseline, yaitu versi SDK.

Upgrade komponen

Pada antarmuka baris perintah, jalankan pod mpaas update x.x.x, di mana x.x.x adalah nomor versi baseline saat ini, misalnya 10.2.3.
Jalankan pod install untuk mengupgrade komponen pada baseline yang ditentukan.

Upgrade baseline

Pada file Podfile, ubah nomor baseline untuk mPaaS_baseline guna mengupgrade seluruh baseline. Misalnya, ubah 10.1.68 menjadi 10.2.3. Baseline standar maupun kustom didukung.
Jalankan pod install untuk menyelesaikan upgrade baseline.

Mengganti alamat podspec mPaaS iOS

Latar Belakang

Repositori podspec mPaaS di code.aliyun.com telah dihentikan. Pembaruan terakhir diterima pada 1 Juni 2023, dan layanan tersebut sepenuhnya dihentikan pada 30 Juni 2023.

Jika Anda tetap menggunakan repositori lama, Anda akan mengalami masalah berikut:

Saat memperbarui SDK menggunakan plugin pod mPaaS, Anda tidak dapat menarik versi baseline terbaru.
Setelah 30 Juni 2023, Anda tidak dapat menarik versi baseline apa pun menggunakan plugin pod mPaaS.

Semua versi mPaaS kini didukung di gitee.com.

Solusi

Upgrade plugin pod mPaaS

Jalankan perintah berikut untuk memperbarui ke plugin pod mPaaS terbaru:

sh <(curl -s http://mpaas-ios.oss-cn-hangzhou.aliyuncs.com/cocoapods/installmPaaSCocoaPodsPlugin.sh)

Setelah perintah selesai, jalankan pod plugins installed di terminal dan periksa versi cocoapods-mPaaS. Upgrade berhasil jika versinya 0.9.6 atau yang lebih baru.

Ubah konfigurasi source di Podfile

Pada Podfile Anda, ganti source "https://code.aliyun.com/mpaas-public/podspecs.git" dengan yang berikut:

source "https://gitee.com/mpaas/podspecs.git".

Perubahan API

Modifikasi ini hanya melibatkan perubahan pada plugin. Penggunaan perintah plugin tetap tidak berubah.

Pengujian dan verifikasi

Setelah menyelesaikan upgrade dan perubahan konfigurasi, jalankan perintah pull plugin pod mPaaS untuk menguji apakah Anda dapat menarik versi baseline dan SDK terbaru.

Daftar parameter

Anda dapat mengonfigurasi parameter untuk mengubah beberapa perilaku default plugin.

Prosedur:

Tambahkan parameter setelah plugin "cocoapods-mPaaS" di Podfile Anda. Berikut contohnya:

Parameter	Fitur	Versi yang Berlaku
`:guard_image_version => 6`	Menghasilkan gambar Bodyguard V6	≥ V0.9.6
`:guard_image_version => 5`	Menghasilkan gambar keamanan V5	≥ V0.9.6
`:only_frameworks => true`	Dalam beberapa skenario, seperti proyek framework mandiri, Anda tidak perlu menambahkan file direktori templat mPaaS secara otomatis.	≥ V0.9.5.0.0.2
`:check_repo => false`	Dalam beberapa skenario, seperti saat menggunakan agen jaringan internal, repositori default tidak diperiksa dan ditambahkan secara otomatis.	≥ V0.9.5.0.0.2

Catatan

Untuk baseline versi 10.2.3, Anda tidak perlu mengatur :guard_image_version karena gambar V6 dihasilkan secara default.

Daftar perintah

Setelah menginstal plugin cocoapods-mPaaS, Anda dapat menggunakan antarmuka baris perintah (CLI) untuk membantu pengembangan Anda.

Perintah	Fitur
`pod mpaas init`	Menambahkan `plugin`, `source`, dan `mPaaS_baseline` ke file `Podfile`.
`pod mpaas update <VERSION>`	Memperbarui baseline dan repositori podspec. Parameter `<VERSION>` adalah nomor baseline spesifik, seperti 10.2.3.
`pod mpaas update --all`	Pada plugin resmi, perintah ini melakukan upgrade plugin dengan menjalankan ulang skrip instalasi. Pada plugin beta, perintah ini juga memperbarui baseline lokal.
`pod mpaas info`	Menampilkan informasi lengkap tentang baseline dan komponen yang sesuai.
`pod mpaas info <NAME> <VERSION>` (di mana `<VERSION>` bersifat opsional)	Menyaring informasi untuk nama modul tertentu.
`pod mpaas info --only-mPaaS`	Menampilkan informasi baseline default parsial untuk memudahkan penyalinan satu klik ke Podfile.
`pod mpaas open`	Membuka file `.xcworkspace` langsung dari antarmuka baris perintah.
`pod mpaas version`	Menampilkan baseline lengkap yang digunakan oleh proyek saat ini.
`pod mpaas version --plugin`	Menampilkan nomor versi plugin Cocoapods-mPaaS saat ini.