Migrate dari Capawesome Cloud ke Capgo

Copas prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

⚡️ Capgo otomatisasi saluran, penghapusan bundle, pengembalian, analisis, dan CLI unggah natively. Gunakan panduan ini untuk melakukan langkah-langkah minimal yang diperlukan untuk migrasi dan secara optional menciptakan perilaku kustom yang masih dibutuhkan.

Ringkasan

Kumpulkan konfigurasi Cloud Capawesome yang sudah ada (ID Aplikasi, saluran, kunci tanda tangan, CLI token) agar Anda dapat menyimpan atau memeriksainya kemudian.
Instal plugin Capgo, hapus Capawesome SDK, dan panggil CapacitorUpdater.notifyAppReady().
Konfigurasi perilaku optional (download manual, pin bundle, reload) jika Anda bergantung pada aliran tersebut saat ini.

Untuk Capgo Anda hanya perlu menginstal plugin kami dan memanggil CapacitorUpdater.notifyAppReady()Semua hal lainnya—saluran, pembersihan paket, pengembalian, analisis, dan CLI otomatisasi—ditangani secara native. Bagian-bagian di bawah ini menjelajahi setiap tugas secara langsung.

Sebelum Anda memulai

Pastikan proyek Anda sudah menggunakan Capacitor 5 atau lebih baru.
Instal Capgo CLI (npm install -g @capgo/cli) jika Anda berencana untuk mengirimkan paket dari CI/CD.

Langkah 1 – Instal Capgo dan hapus SDK Capawesome

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

Langkah ini adalah satu-satunya penggantian wajib. Capgo native code telah dilengkapi dengan plugin; tidak ada bantuan JavaScript tambahan yang diperlukan.

Langkah 2 – Konfigurasi Minimal

Konfigurasi sebelumnya memerlukan pemetaan puluhan pilihan dalam capacitor.config. Capgo mengenali projek Anda secara otomatis, sehingga konfigurasi minimal terlihat seperti ini:

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
      periodCheckDelay: 10 * 60 * 1000, // optional: check every 10 minutes
    },
  },
}

export default config

Semua pilihan manual Capawesome (“}defaultChannel, autoDeleteBundlesretensi kebijakan, dll.) diatur melalui dashboard Capgo atau API. Anda hanya perlu mengganti kunci-kunci ini jika Anda ingin perilaku yang berbeda dari default Capgo.

Referensi Konfigurasi Cepat

Pilihan Capawesome	Setaraan Capgo	Apakah Anda perlu mengatur itu?
`appId`	Diperoleh dari dashboard Capgo setelah Anda membuat proyek	Hanya jika Anda menggunakan beberapa proyek dalam satu biner
`defaultChannel`	Aturan saluran yang diatur di dashboard/API	Opsional; sebagian besar tim mengatur ini secara server-side
`autoDeleteBundles`	`autoDeletePrevious: true` (default)	Sudah diaktifkan
`publicKey`	Dikelola di console Capgo	Hanya jika Anda memutar kunci secara manual
`maxVersions` / penyimpanan	Pengaturan penyimpanan pola	Dikonfigurasi secara sentral di Capgo (1 bulan default, 24 bulan maksimum)

Mengikuti langkah 3 – Panggil `notifyAppReady()` (hanya hook yang diperlukan)

Alur lama memperkenalkan pendengar custom (checkForUpdates(), retryDownload(), menyembunyikan layar splash, dll.). Capgo melakukan langkah-langkah tersebut secara native. Hanya API yang harus dipanggil adalah:

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

CapacitorUpdater.notifyAppReady()

Ini mengkonfirmasi bahwa aplikasi telah berjalan dengan sukses. Jika konfirmasi tidak pernah tiba, Capgo secara otomatis akan mengembalikan bundle—tidak perlu JavaScript tambahan.

Selesai—Capgo mengelola pengecekan latar belakang, visibilitas layar splash, dan pengembalian secara native.

Opsional: jalankan logika kustom sebelum layar splash disembunyikan

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

CapacitorUpdater.addListener('appReady', () => {
  // Run diagnostics or logging if you need to
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Mengikuti langkah 4 – Peta panggilan API (hampir opsional)

In Capgo Anda biasanya membiarkan auto-updater berjalan; API manual tetap tersedia jika Anda ingin memiliki kendali penuh.

Capawesome Cloud	Capgo setara	Apakah Anda membutuhkannya?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Hanya ketika Anda menerapkan alur download sendiri
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Opsional: auto-update asli sudah mengunduh
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Opsional: dashboard menempel bundle secara otomatis
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Opsional; Capgo mengenakan bundle wajib setelah `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Opsional: diagnostik

Jika Anda tetap dengan perilaku auto-update asli Anda dapat menghapus JavaScript Capawesome sepenuhnya.

Contoh kendali manual

Unduh bundle terbaru

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

const downloadUpdate = async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const bundle = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    console.log('Bundle downloaded', bundle?.id)
  }
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const downloadUpdate = async () => {
  const result = await LiveUpdate.fetchLatestBundle()
  if (result.downloadUrl) {
    await LiveUpdate.downloadBundle({
      bundleId: result.bundleId,
      url: result.downloadUrl,
    })
    console.log('Bundle downloaded')
  }
}

Capawesome Cloud

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

const setNextBundle = async () => {
  await CapacitorUpdater.next({ id: 'bundle-id-123' })
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const setNextBundle = async () => {
  await LiveUpdate.setNextBundle({ bundleId: 'bundle-id-123' })
}

__CAPGO_KEEP_0__

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

const applyUpdate = async () => {
  await CapacitorUpdater.reload()
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const applyUpdate = async () => {
  await LiveUpdate.reload()
}

Langkah 5 – Strategi pembaruan: bagaimana Capgo mengaturnya

Capawesome mendokumentasikan tiga strategi. Berikut ini bagaimana mereka diinterpretasikan:

Pembaruan latar belakang

Alur kerja sebelumnya: disetel secara otomatis di code dan download secara manual.
Capgocontext: HTML fragment teks dari string Capgo UI yang lebih panjang (kunci utama `submitting_a_pr_to_capgo`). Halaman/area: Situs web pemasaran Capgo. Peran: Kalimat teks situs web. Dilihat di: halaman contributing.astro. Simpanlah istilah produk/merek dan istilah pengembang Capgo secara tepat. Kunci pesan `submitting_a_pr_to_capgo` (Mengirimkan PR ke Capgo).autoUpdate: trueTidak perlu tambahan code apa pun.

Terbaru selalu

Alur kerja sebelumnya: tambahkan App.resume pengguna, panggil download, kemudian set.
CapgoKonteks: Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `submitting_a_pr_to_capgo`). Halaman/area: Situs web pemasaran Capgo. Peran: Kalimat copy situs web. Dilihat di: halaman contributing.astro. Simpanlah istilah produk/merek Capgo dan istilah developer secara tepat. Kunci pesan `submitting_a_pr_to_capgo` (Mengirimkan PR ke Capgo).

: pembaruan otomatis latar belakang sudah melakukan periksa setelah resume. Anda hanya perlu pengguna manual jika ingin interval kustom.

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

App.addListener('resume', async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const downloaded = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    if (downloaded) {
      await CapacitorUpdater.next({ id: downloaded.id })
    }
  }
})

Salin ke clipboard

Alur Kerja Sebelumnya: logika prompt kabel dan memaksa reload.
CapgoJika Anda ingin mengirimkan PR ke Capgo, Anda harus mengikuti langkah-langkah berikut: majorAvailable : tandai paket sebagai “wajib” di dashboard, kemudian dengarkan event (diterbitkan setelah notifyAppReady()) untuk meminta pengguna untuk mengupgrade di dalam aplikasi Anda.

Langkah 6 – Mengirimkan Paket

Jika Anda sebelumnya bergantung pada capawesome live-update deploy, Capgo offers a similar CLI workflow, and you can also automate deployments entirely via API.

# Authenticate once (stores a token in your CI environment)
capgo login

# Upload a new bundle (auto-detects platform/version)
capgo bundle upload --path dist --channel production

Karena Capgo secara otomatis mengawasi kesehatan paket, Anda juga mendapatkan:

Log audit perangkat untuk setiap instalasi.
Penghapusan otomatis (satu bulan secara default) dengan batasan yang dapat disesuaikan hingga 24 bulan.
Metrik latency waktu nyata di status.capgo.app/history.

Jadwal migrasi

Inventory & instal: 10 menit (npm install, hapus plugin lama).
Konfigurasi & kesiapan : 5 menit notifyAppReady).
Sanitas : 15 menit (uji coba manual opsional atau pengguna).
Pengembangan pertama: 10 minutes with Capgo CLI or CI integration.

: 10 menit dengan __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ atau integrasi CI.

Capgo support

Bab berjudul “__CAPGO_KEEP_0__ dukungan”Pelayanan migrasi book.capgo.app/demo.
buku.__CAPGO_KEEP_0__.app/demo (buku.__CAPGO_KEEP_0__.app/demo tidak diterjemahkan karena merupakan URL yang tidak dapat diubah).: bergabunglah dengan Capgo Discord.
Peta Masalah: github.com/Cap-go/capacitor-updater/issues.

Capgo dirancang untuk keandalan jangka panjang: pembaruan delta asli, paket yang dienkripsi, pengembalian otomatis, dan analitik yang tidak memerlukan JavaScript kustom. Setelah Anda migrasi, Anda dapat menghapus perangkat lunak yang berat untuk perawatan dan biarkan platform melakukan pembaruan secara otomatis.

Teruskan dari Migrate dari Capawesome Cloud ke Capgo

Jika Anda menggunakan Migrate dari Capawesome Cloud ke Capgo untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Pembangunan Nadi Asli untuk alur kerja produk di Capgo Pembangunan Nadi Asli Capgo Integrasi untuk alur kerja produk di Capgo Integrasi Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi