Migrate dari AppFlow ke Capgo

🚦 Ioni mengumumkan bahwa produk komersial AppFlow—termasuk Live Updates—sedang berhenti. Projek yang sudah ada dapat berjalan hingga 31 Desember 2027, but no new customers are accepted and no new features are planned. This guide walks you through the actions required to migrate to Capgo and highlights the native automation you gain.

Pendahuluan Migrasi

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()dan—jika diinginkan—mengatur kontrol manual opsional. Bagian-bagian di bawah menjelajahi 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 Versi Targeting Guide untuk strategi rinci mengenai mengelola pembaruan di antara versi aplikasi yang berbeda.

Langkah 0 – Tangkap konfigurasi AppFlow Anda saat ini

• Perhatikan AppFlow ID Aplikasi, saluran yang ada, dan kunci tanda tangan.
• Export sejarah bundle apa pun yang ingin Anda arsipkan.
• Jika Anda menggunakan GitHub Actions atau penyedia CI lainnya, jangan hapus pipeline mereka—mereka akan tetap berfungsi dengan Capgo.

Langkah 1 – Ganti SDK AppFlow dengan Capgo

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

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

Langkah 2 – Konfigurasi minimal (tidak ada bidang manual)

Konfigurasi 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	Capgo setara	Apakah Anda perlu mengatur hal ini?
appId	Dikelola di dashboard Capgo	Disediakan secara otomatis ketika Anda membuat proyek
channel / defaultChannel	Aturan saluran di dashboard/API	Override opsional; default datang dari server. Lihat Pengaturan Target Versi context: Halaman/area: Halaman pemasaran solusi Capgo. Peran: Judul bagian atau halaman. Dilihat di: page solusi/pengaturan-target-versi.astro. Pesan kunci `solutions_version_targeting_title` (Judul Pengaturan Target Versi Solusi). | Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: page solusi/pengaturan-target-versi.astro. Pesan kunci `solutions_version_targeting` (Pengaturan Target Versi Solusi).
autoUpdateMethod	autoUpdate: true	untuk strategi multi-versi
maxVersions	Disediakan secara default oleh sistem otomatis	Diatur secara sentral (1 bulan default, 24 bulan maks)
enabled	Tidak diperlukan	Capgo mengatur ketersediaan per saluran

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

Pada 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 akan mengembalikan bundle secara otomatis.

Itu saja—Capgo menghandle periksa 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 pembaruan diterjemahkan

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

Latar belakang (default)

• AppFlow: atur autoUpdateMethod = background, panggil sync() manual.
• CapgoDiaktifkan secara otomatis. Tidak memerlukan JavaScript.

Terbaru selalu

• AppFlow: tambahkan sebuah App.addListener('resume') pengaturan yang mengunduh dan memuat ulang.
• Capgocontext: HTML fragment teks dari string Capgo UI yang lebih panjang (kunci induk `submitting_a_pr_to_capgo`). Halaman/area: Situs web pemasaran Capgo. Peran: Kalimat teks situs web. Dilihat di: halaman berkontribusi.astro. Simpan Capgo produk/merek dan istilah pengembang secara tepat. Kunci pesan `submitting_a_pr_to_capgo` (Mengirimkan PR ke Capgo).

: pembaruan otomatis berjalan saat resume sudah. Tambahkan pengaturan hanya jika Anda ingin jendela waktu timing yang dapat disesuaikan.

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 })
  }
})

Salin ke clipboard

• AppFlow: meminta pengguna dan memanggil reload().
• : Capgo: menandai paket sebagai “wajib” di dashboard, kemudian mendengarkan event (diterbitkan setelah ) untuk meminta atau memaksa pengguna di dalam aplikasi Anda. majorAvailable Langkah 5 – Membuat Peta __CAPGO_KEEP_0__ notifyAppReady()Methode AppFlow

Sama dengan API

Diatur secara otomatis	Capgo	Langkah 5 – Membuat Peta __CAPGO_KEEP_0__
LiveUpdates.sync()	Methode AppFlow	Capgo’s native auto-update berjalan tanpa panggilan sinkron manual
LiveUpdates.download()	CapacitorUpdater.download()	Opsional untuk aliran kustom
LiveUpdates.reload()	CapacitorUpdater.set()	Opsional; pengaturan dashboard menghandle pembaruan paksa
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostik opsional

Langkah 6 – Terapkan menggunakan Capgo CLI atau API

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

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

Pembaruan versi tertentu (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
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
  --path dist \
  --channel production \
  --min-update-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 Panduan Target Versi untuk strategi menyeluruh.

Capgo secara otomatis:

• Mengarsipkan log audit perangkat untuk setiap instalasi.
• Mengirimkan email proaktif ketika Anda mendekati batas plan.
• Menyediakan kredit burst sehingga Anda tidak pernah diblokir di tengah-tengah rilis.
• Menerbitkan 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 penggantian Capgo dan langkah-langkah berikutnya.

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

Pertanyaan yang sering diajukan

Mengapa AppFlow menutup pembaruan live?

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

Berapa lama waktu migrasi?

Sebagian besar tim menyelesaikan pindahan dalam waktu kurang dari sehari. Konsep seperti saluran, pengembangan, 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 __CAPGO_KEEP_0__, dan mengunggah bundle pertama Anda. notifyAppReady()Apakah kami akan menghemat uang?

Bab berjudul “Apakah kami akan menghemat uang?”

499/mo . __CAPGO_KEEP_0__ dimulai dari $. Capgo starts at dengan harga berdasarkan penggunaan yang menurun menjadi sekitar $ 0.001 per pengguna aktif bulanan Section titled “Berapa lama waktu migrasi?”Kamu juga mendapatkan enkripsi, pengembalian otomatis, dan pemantauan latensi global.

Mengapa harus melakukan migrasi?

Karena AppFlow saat ini dalam mode pemeliharaan, 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 - Mencari tahu strategi matching versi AppFlow yang lebih dalam
• Pembaharuan Berubah - Mengelola pembaruan versi utama dengan saluran
• Pengelolaan Saluran - Referensi konfigurasi saluran lengkap

Memerlukan bantuan?

• Booking sesi migrasi: book.capgo.app/demo
• Join komunitas: Capgo Discord
• Track masalah / permintaan fitur: github.com/Cap-go/capacitor-updater

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

Teruskan dari Migrate dari AppFlow ke Capgo

Jika Anda menggunakan Migrate from AppFlow to Capgo Untuk merencanakan migrasi dan operasional perusahaan, hubungkannya dengan Capgo Bisnis Untuk alur kerja produk di Capgo Enterprise, Alternatif Plugin Enterprise Ionic Untuk alur kerja produk dalam Ionic Enterprise Plugin Alternatif, Alternatif Capgo Untuk alur kerja produk dalam Capgo Alternatif, Konsultasi Capgo untuk alur kerja produk di Capgo Consulting, dan Capgo Premium Support Untuk alur kerja produk di Capgo Support Premium.