Migrasi dari AppFlow ke Capgo

🚦 Ionik mengumumkan bahwa produk komersial AppFlow, termasuk Live Updates, akan berhenti beroperasi. Proyek yang sudah ada dapat berjalan hingga 31 Desember 2027, tetapi tidak ada pelanggan baru yang diterima dan tidak ada fitur baru yang direncanakan. Panduan ini akan membantu Anda melalui aksi yang diperlukan untuk migrasi ke Capgo dan menyoroti otomatisasi native yang Anda dapatkan.

Ringkasan migrasi

Capgo mengelola saluran, penyimpanan paket, pengembalian ke versi sebelumnya, analisis, dan CLI unggah untuk Anda. Migrasi dapat disederhanakan dengan menginstal plugin, memanggil CapacitorUpdater.notifyAppReady(), dan—jika diinginkan—mengonfigurasi kontrol manual opsional. Bagian-bagian di bawah ini menjelaskan setiap tugas secara langsung.

Target Versi Seperti AppFlow

Jika Anda bergantung pada AppFlow’s automatic version matching (mengirimkan pembaruan yang kompatibel berdasarkan versi native), Capgo menyediakan kemampuan yang sama dengan kontrol yang ditingkatkan. Lihat Guida Target Versi Guida Target Versi

Langkah 0 – Tangkap konfigurasi AppFlow Anda saat ini

• Catat konfigurasi AppFlow Anda ID Aplikasisaluran yang ada, dan kunci tanda tangan.
• Export sejarah paket yang ingin Anda arsipkan.
• Jika Anda menggunakan GitHub Aksi atau penyedia CI lainnya, jaga jalur pipa itu—mereka akan terus berfungsi dengan Capgo.

Langkah 1 – Ganti AppFlow SDK dengan Capgo

npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

Itu saja. Capgo mengemas native code untuk kedua iOS dan Android; tidak ada bantuan JavaScript tambahan yang diperlukan.

Langkah 2 – Konfigurasi minimal (tidak ada bidang manual)

Konfigurasi blok yang ada sangat luas. Capgo mendeteksi otomatis proyek dan saluran Anda, sehingga konfigurasi minimal adalah:

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

Referensi cepat konfigurasi

Pengaturan Ionic AppFlow	Sama dengan Capgo	Apakah Anda perlu mengatur itu?
appId	Dikelola di dashboard Capgo	Disediakan secara otomatis ketika Anda membuat proyek
channel / defaultChannel	Aturan saluran di dashboard/API	Pengaturan override opsional; default datang dari server. Lihat Target Versi untuk strategi multi-versi
autoUpdateMethod	autoUpdate: true	Ditambahkan secara default
maxVersions	Kebijakan Retensi	Dikonfigurasi secara sentral (1 bulan default, maksimal 24 bulan)
enabled	Tidak diperlukan	Capgo mengatur ketersediaan per saluran

Langkah 3 – Panggil notifyAppReady() (hanya hook yang diperlukan)

Dalam panduan Ionic Anda menghubungkan sync, download, dan reload, kemudian sembunyikan layar splash secara manual. Capgo melakukan aksi-aksi tersebut secara native. Anda hanya perlu memastikan aplikasi sudah siap:

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

CapacitorUpdater.notifyAppReady()

Jika konfirmasi tidak pernah datang, Capgo secara otomatis mengembalikan bundle.

Itu saja—Capgo mengelola pengecekan latar belakang, visibilitas splash, dan pengembalian untuk Anda.

Opsional: Jalankan logika sebelum layar splash disembunyikan

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

CapacitorUpdater.addListener('appReady', () => {
  // Log diagnostics or run custom code if needed
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Langkah 4 – Strategi diterjemahkan

AppFlow mendokumentasikan tiga strategi. Berikut adalah bagaimana mereka menerjemahkan ke Capgo:

Latar Belakang (default)

• AppFlow: konfigurasi autoUpdateMethod = backgroundtelusuri secara manual. sync() __CAPGO_KEEP_0__
• CapgoTerbaru selalu

Judul bagian “Terbaru selalu”

• : tambahkan handler yang mengunduh dan memuat ulang.__CAPGO_KEEP_0__ App.addListener('resume') Auto-update sudah berjalan saat aplikasi diresume. Tambahkan handler hanya jika Anda ingin jendela waktu yang dapat disesuaikan.
• Capgo__CAPGO_KEEP_0__

: diaktifkan secara default. Tidak memerlukan JavaScript.

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

App.addListener('resume', async () => {
  const bundle = await CapacitorUpdater.download()
  if (bundle) {
    await CapacitorUpdater.set({ id: bundle.id })
  }
})

Perbarui paksa

• AppFlow: tanyakan pengguna dan panggil reload().
• Capgo: tandai paket sebagai “wajib” di dashboard, kemudian dengarkan untuk event (diterbitkan setelah majorAvailable ) untuk menanyakan atau memaksa pengguna di dalam aplikasi Anda. notifyAppReady()Langkah 5 – Membuat pemetaan __CAPGO_KEEP_0__

Judul bagian “Langkah 5 – Membuat pemetaan API”

__CAPGO_KEEP_0__	Sama dengan Capgo	Apakah Anda membutuhkannya?
LiveUpdates.sync()	Diproses secara otomatis	Capgo’s native auto-update berjalan tanpa panggilan sinkron manual
LiveUpdates.download()	CapacitorUpdater.download()	Diperlukan untuk alur kustom
LiveUpdates.reload()	CapacitorUpdater.set()	Diperlukan; pengaturan dashboard menghandle pembaruan paksa
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diperlukan diagnostik

Langkah 6 – Deploy menggunakan Capgo CLI atau API

Selesaikan migrasi dengan mengunggah bundle dengan Capgo CLI atau API. Alur ini meniru apa yang Anda mungkin telah menulis sebelumnya, tetapi sekarang termasuk keamanan asli:

capgo login                # authenticate once
capgo bundle upload \
  --path dist \
  --channel production     # automatically tags platform/version

Deploymen terintegrasi versi (seperti AppFlow)

Jika Anda perlu menargetkan versi native tertentu (mirip dengan AppFlow’s native version locking):

# Only deliver to devices on native version 2.0.0 or higher
capgo bundle upload \
  --path dist \
  --channel production \
  --native-version "2.0.0"

# Use channels for different major versions
capgo bundle upload --channel v2  # for app version 2.x
capgo bundle upload --channel v3  # for app version 3.x

Lihat Petunjuk Targeting Versi untuk strategi menyeluruh.

Capgo secara otomatis:

• Mengarsipkan log audit perangkat untuk setiap instalasi.
• Mengirim email proaktif ketika Anda mendekati batas rencana.
• Menghadirkan kredit ledakan agar Anda tidak terblokir di tengah-tengah rilis.
• Publikasikan metrik latency untuk 18 wilayah global di status.capgo.app/history.

Plugin Ionic enterprise

Jika stack Ionic Anda juga menggunakan plugin enterprise, ikuti dokumen migrasi yang ditargetkan di bawah ini. Setiap panduan merekomendasikan pengganti Capgo dan langkah-langkah berikutnya.

• Migrasi dari Ionic Secure Storage
• Migrasi dari Ionic Auth Connect
• Migrasi dari Ionic Identity Vault

Faq yang sering ditanyakan

Mengapa AppFlow menutup pembaruan live?

Ionic menghentikan produk komersial, termasuk AppFlow, untuk fokus pada kerangka kerja open-source mereka. Pelanggan yang sudah ada masih bisa menggunakan pembaruan live sampai 31 Desember 2027, tapi tidak ada fitur baru atau pelanggan yang diterima. Capgo mengisi celah itu dengan platform OTA native yang khusus.

Berapa lama waktu migrasi?

Banyak tim menyelesaikan pindahannya dalam waktu kurang dari sehari. Konsep seperti saluran, pengiriman, dan aturan rilis dapat dipetakan langsung, dan tim kami menyediakan dokumentasi serta dukungan tangan-ke-tangan. Dalam banyak kasus, Anda hanya perlu menginstal plugin, memanggil notifyAppReady(), dan mengunggah bundle pertama Anda.

Apakah kami akan menghemat uang?

Iya. Pembaruan live AppFlow mulai dari $499/mo. Capgo mulai dari $14/mo dengan harga berdasarkan penggunaan yang menurun menjadi sekitar $0.001 per pengguna aktif bulanan. Anda juga mendapatkan enkripsi, rollback otomatis, dan pemantauan latensi global.

Kapan kita harus migrasi?

Karena AppFlow saat ini dalam mode perawatan, migrasi lebih cepat memberikan akses ke inovasi Capgo yang berlangsung. Kami merekomendasikan beralih ketika itu sesuai dengan jadwal rilis Anda. Tim ahli kami akan membantu Anda merencanakan perubahan agar CI/CD dan pengiriman tetap berjalan.

Sumber Daya Tambahan

• Panduan Target Versi - Penjelajahan mendalam ke strategi pencocokan versi AppFlow-style
• Perubahan-Penting - Mengelola pembaruan versi utama dengan saluran
• Pengelolaan Saluran - Referensi konfigurasi saluran lengkap

Memerlukan bantuan?

• Buat janji migrasi: book.capgo.app/demo
• Bergabunglah dengan komunitas: Capgo Discord
• Ikuti masalah / minta fitur: github.com/Cap-go/capacitor-updater

Capgo dirancang untuk perusahaan yang membutuhkan pembaruan delta asli, paket yang dienkripsi, dan inovasi yang terus-menerus. Setelah Anda melakukan migrasi, Anda dapat menghapus glue AppFlow code, bergantung pada otomatisasi asli, dan terus mengirimkan tanpa gangguan.

Teruskan dari Migrate dari AppFlow ke Capgo

Jika Anda menggunakan Migrate dari AppFlow ke Capgo untuk merencanakan migrasi dan operasi bisnis, hubungkannya dengan Capgo Enterprise untuk alur kerja produk di Capgo Enterprise, Alternatif Ionic Enterprise Plugin untuk alur kerja produk di Alternatif Ionic Enterprise Plugin, Capgo Alternatif untuk alur kerja produk di Capgo Alternatif, Capgo Konsultasi untuk alur kerja produk di Capgo Consulting, dan Capgo Support Premium untuk alur kerja produk di Capgo Support Premium.