Migrasi dari Pusat Aplikasi ke Capgo

Ringkasan Migrasi

Capgo adalah layanan yang membantu tim pengembang mengirimkan aplikasi hidup ke aplikasi yang sudah diinstal.
Capacitor JS aplikasi yang ditulis dalam jQuery Mobile, Framework 7, Sencha, KendoUI, Ionic, atau bahkan solusi kustom sendiri dapat di migrasi. Tidak diperlukan aplikasi Ionic yang sudah ada..
Colt menawarkan layanan yang setara untuk App Center Build (membangun aplikasi Android/iOS). Untuk layanan Test, Diagnostics, dan Analytics.

Catatan

Jika aplikasi Anda masih menggunakan Cordova, maka perlu migrasi ke Capacitor terlebih dahulu sebelum migrasi ke Capgo.

Dibangun oleh tim Ionic sebagai pengganti spiritual Cordova, Capacitor memungkinkan pengembangan untuk bergerak lebih dekat dengan alat-alat native dan kemampuan dengan tujuan memberikan pengalaman pengguna yang lebih baik dan kinerja.

Untungnya, proses migrasi mudah dan sebagian besar plugin Cordova kompatibel mundur ke Capacitor. Mulai migrasi di sini.

Tentang Capgo

Capgo, mengelola pembaruan aplikasi secara waktu. Tim pengembangan dapat fokus sepenuhnya pada fitur unik aplikasi dan mengutamakan proses pengiriman aplikasi yang rumit ke Capgo.

Capgo mengisi celah antara pengiriman web dan mobile.

Capgo Prasyarat

Seperti App Center, Capgo mendukung aplikasi yang dihosting di repositori Git pada Azure DevOps, Bitbucket, GitHub, dan GitLab.

Pasang Capgo CLI

peringatan

Pastikan Anda memiliki Node dan NPM terinstal di komputer Anda sebelum melanjutkan. Selalu gunakan versi LTS terbaru. __CAPGO_KEEP_0__ jangan menggunakan versi yang lebih tua. Capgo do not older versions.

dan __CAPGO_KEEP_0__ file konfigurasi `package.json` and Capacitor config files

catatan

Sebelum Anda memulai, saya merekomendasikan membuat perubahan pada cabang Git yang baru.

Karena Capgo dibuat untuk mengotomatisasi capacitor aplikasi, itu memerlukan satu file yang mungkin tidak ada di aplikasi Anda. Pertama, buatlah capacitor.config.json file. Cara termudah untuk membuatnya adalah dengan menjalankan perintah di root aplikasi Anda:

npm install @capacitor/core

Lalu, inisialisasi Capacitor menggunakan kuesioner CLI:

npx cap init

Kuesioner CLI akan bertanya beberapa pertanyaan, mulai dari nama aplikasi Anda, dan ID paket yang Anda inginkan untuk aplikasi Anda.

Akhirnya, komitkan file-file baru ke proyek Anda:

git add .git commit -m "added package json and capacitor config" && git push

Migrasi Code

Sekarang Anda telah memiliki file-file baru yang diperlukan __CAPGO_KEEP_0__ Sekarang Anda telah memiliki file-file baru yang diperlukan Capgo file-file tersebut, Anda bisa memfokuskan perhatian pada aplikasi itu sendiri. Capgo mengharapkan aplikasi yang dibangun secara keseluruhan untuk berada di dalam sebuah direktori bernama dist.

Jika aplikasi code yang dibangun Anda tidak berada di dalam sebuah dist direktori, ubah nilai ini di dalam file konfigurasi Capacitor.

Berikut adalah struktur direktori aplikasi yang seharusnya terlihat seperti ini:

Struktur Aplikasi

Konfigurasi Capgo

Dengan aplikasi Anda siap untuk Capgo integrasi, saatnya untuk mendaftar dan mendapatkan kunci API untuk mengunggah versi pertama! Mulailah dengan mendaftar untuk sebuah Capgo akun.

Setelah Anda masuk ke Capgo, navigasikan ke halaman Akun kemudian tekan tombol API lalu tekan tombol ‘tulis’ untuk menyalinnya ke clipboard.

Instal Capgo SDK

Dari command line, langsung ke root folder aplikasi Capacitor, jalankan perintah berikut:

npm i @capgo/capacitor-updater && npx cap sync Untuk menginstal plugin ke aplikasi Capacitor.

Dan kemudian tambahkan ke aplikasi Anda ini code sebagai pengganti CodePush satu:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Ini akan memberitahu plugin native bahwa instalasi telah berhasil.

Pengiriman Update Hidup (Alternatif CodePush)

Ciri khas Fitur Update Hidup bekerja dengan menggunakan __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Capgo SDK Masuk ke __CAPGO_KEEP_0__ CLOUD

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ all API Key tersedia di akun Anda untuk masuk dengan CLI:

npx @capgo/cli@latest login YOURKEY

Tambahkan aplikasi pertama Anda

Mari kita mulai dengan membuat aplikasi pertama di Capgo Cloud dengan CLI.

npx @capgo/cli@latest app add

Perintah ini akan menggunakan semua variabel yang didefinisikan di file konfigurasi Capacitor untuk membuat aplikasi.

Unggah bundle pertama Anda

Jalankan perintah untuk membangun code dan kirimkannya ke Capgo dengan:

npx @capgo/cli@latest bundle upload --channel production

Dengan default, nama versi akan menjadi yang ada di file. package.json Periksa di

__CAPGO_KEEP_0__ Capgo Upload

Andai Anda bahkan ingin menguji aplikasi seluler saya aplikasi sandbox seluler saya.

Buat saluran default

Setelah Anda telah mengirimkan aplikasi ke Capgo, Anda perlu membuat saluran Anda default agar aplikasi dapat menerima pembaruan dari Capgo.

npx @capgo/cli@latest channel set production -s default

Konfigurasi aplikasi untuk memvalidasi pembaruan

Tambahkan konfigurasi ini ke file JavaScript utama Anda.

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Lalu lakukan npm run build && npx cap copy untuk memperbarui aplikasi Anda.

Terima Pembaruan Langsung di Perangkat

Untuk aplikasi Anda menerima pembaruan langsung dari Deploy, Anda akan perlu menjalankan aplikasi di perangkat atau emulator. Cara termudah untuk melakukannya adalah dengan menggunakan perintah berikut untuk meluncurkan aplikasi lokal Anda di emulator atau perangkat yang terhubung ke komputer Anda.

npx cap run [ios | android]

Buka aplikasi, letakkan di latar belakang dan buka lagi, Anda seharusnya melihat di log bahwa aplikasi melakukan pembaruan.

Selamat! 🎉 Anda telah berhasil mengaktifkan Live Update pertama Anda. Ini hanya awal dari apa yang bisa Anda lakukan dengan Live Updates. Untuk mengetahui lebih lanjut, lihatlah dokumentasi Live Updates yang lengkap. Dokumentasi Live Updates.

Hapus Ketergantungan App Center

Sekarang bahwa kami telah mengintegrasikan layanan Capgo Anda seharusnya menghapus semua referensi ke App Center. Selain menjadi praktik terbaik untuk menghapus code/services yang tidak digunakan, menghapus SDK seharusnya dapat mengurangi ukuran aplikasi Anda.

Pertama, buka terminal kemudian uninstall plugin App Center:

    cordova plugin remove cordova-plugin-appcenter-analytics cordova-plugin-appcenter-crashes cordova-plugin-code-push

Kemudian, buka config.xml dan hapus nilai-nilai berikut. Mereka akan terlihat seperti: preference Jika Anda menggunakan App Center Analytics di aplikasi Anda, hapuslah elemen-elemen berikut:

    <preference name="APP_SECRET" value="0000-0000-0000-0000-000000000000" /><preference name="CodePushDeploymentKey" value="YOUR-ANDROID-DEPLOYMENT-KEY" /><preference name="CodePushPublicKey" value="YOUR-PUBLIC-KEY" />

dan preferences Hapuslah nilai-nilai berikut APPCENTER_ANALYTICS_ENABLE_IN_JS Hapuslah elemen-elemen berikut APPCENTER_CRASHES_ALWAYS_SEND.

Hapuslah <access /> elemen-elemen:

    <access origin="https://codepush.appcenter.ms" /><access origin="https://codepush.blob.core.windows.net" /><access origin="https://codepushupdates.azureedge.net" />

Hapus referensi ke CodePush dalam CSP meta tag di index.html file (https://codepush.appcenter.ms):

    <meta http-equiv="Content-Security-Policy" content="default-src https://codepush.appcenter.ms 'self' data: gap: https://ssl.gstatic.com 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *" />

Akhirnya, di dalam aplikasi Anda, hapus semua referensi code ke layanan App Center, seperti codePush.sync();.

Langkah-Langkah Selanjutnya

Anda telah beralih dari App Center ke Capgo, menggunakan Live Updates. Ini hanya awal dari apa yang dapat Anda gunakan Capgo untuk. Eksplorasi layanan lainnya yang mencakup Channel (berbagai lingkungan) dan override. Integrasi Cloud CLI , gunakan Capgo di dalam platform CI/CD pilihan Anda (seperti GitHub Action, GitLab, Jenkins, dan lain-lain).

Kirimkan update aplikasi secara otomatis

Jika code Anda dihosting di GitHub, Anda dapat mengatur build dan release otomatis dalam beberapa langkah lagi, berkat GitHub actions.

Saya telah membuat artikel kedua untuk memungkinkan Anda melakukannya.

Kredit

Saya sangat berterima kasih kepada Ionik, artikel ini berdasarkan pada artikel ini diubah dengan chat-gpt-3 dan disesuaikan.

Migrasi dari App Center ke Capgo