Capawesome Cloud에서 Capgo으로 이동하세요.

⚡️ Capgo 채널, 번들 정리, 롤백, 분석, 및 CLI natively 업로드합니다. 이 가이드를 사용하여 마이그레이션을 수행하고 옵션적으로 재생성해야 하는 모든 사용자 지정 동작을 다시 만들 수 있습니다.

개요

1. 이전 Capawesome Cloud 구성 (App ID, 채널, 서명 키, CLI 토큰)을 모아 아카이브하거나 감사할 수 있도록 하세요.
2. Capgo 플러그인을 설치하고 Capawesome SDK을 제거한 다음 CapacitorUpdater.notifyAppReady().
3. 선택적 동작을 구성 (수동 다운로드, 번들 핀, 리로드)หาก 오늘날의 흐름에 의존합니다.

Capgo를 사용하기 위해서는 Capgo 에서만 설치해야 합니다. CapacitorUpdater.notifyAppReady()CLI의 모든 기능을 사용하기 위해서는 CLI의 플러그인을 설치하고 CLI을 호출해야 합니다.

Everything else—channels, bundle cleanup, rollbacks, analytics, and __CAPGO_KEEP_0__ automation—is handled natively.

• Capgo를 사용하기 위해서는 Capacitor 5 이상을 이미 사용 중인지 확인해야 합니다.
• CI/CD에서 배포할 때 Capgo CLI을 설치해야 합니다.npm install -g @capgo/cli Capgo를 사용하기 위해서는 __CAPGO_KEEP_0__를 설치하고 Capawesome __CAPGO_KEEP_1__을 제거해야 합니다.

Step 1 – Install Capgo and remove the Capawesome SDK

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

That is the only mandatory swap. Capgo’s native code ships with the plugin; no extra JavaScript helpers are required.

2단계 – 최소 구성

이전 설정에서는 수십 개의 옵션을 매핑해야했습니다. capacitor.config Capgo은 프로젝트를 자동으로 인식하므로 최소 구성은 다음과 같습니다.

capacitor.config.ts

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

Capawesome이 수동 플래그 (defaultChannel, autoDeleteBundlesretention 정책 등)로 나열하는 모든 것은 Capgo 대시보드 또는 API에서 관리됩니다. Capgo의 기본값과 다른 동작을 원한다면만 이 키를 오버라이드하세요.

구성 빠른 참조

Capawesome 옵션	Capgo 동등 항목	이러한 기능을 사용하려면 설정을 해야 하나요?
appId	Capgo 프로젝트를 생성한 후에 Capgo 대시보드에서 가져옵니다.	한 바이너리에 여러 프로젝트를 사용하는 경우에만
defaultChannel	API 대시보드에서 채널 규칙을 관리합니다.	대부분의 팀은 서버 측에서 이 옵션을 설정합니다.
autoDeleteBundles	autoDeletePrevious: true (기본값)	이미 활성화되어 있습니다.
publicKey	Capgo 콘솔에서 관리합니다.	키를 수동으로 회전하는 경우에만
maxVersions 보관	Bundle 보관 정책	기본값은 1 개월이며 최대 24 개월까지 Capgo에서 중앙 집중식으로 구성됩니다.

Step 3 – __CAPGO_KEEP_0__ notifyAppReady() (only required hook)

__CAPGO_KEEP_0__ performs those steps natively. The only __CAPGO_KEEP_1__ you must call is:checkForUpdates(), retryDownload(), hiding the splash screen, etc.). Capgo performs those steps natively. The only API you must call is:

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

CapacitorUpdater.notifyAppReady()

That’s it—Capgo handles background checks, splash visibility, and rollbacks natively.

That’s it—Capgo handles background checks, splash visibility, and rollbacks natively.

Copy to clipboard

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

Section titled “Step 4 – API calls (mostly optional)”

일반적으로 Capgo 에서 자동 업데이터를 실행합니다. 만약 전체 제어를 원한다면 수동 API가 여전히 사용 가능합니다.

Capawesome Cloud	Capgo 동등한 항목	필요합니까?
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	다운로드 워크플로를 직접 구현할 때만
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	선택 사항: 네이티브 자동 업데이트가 이미 다운로드를 진행합니다.
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	선택 사항: 대시보드가 자동으로 패키지를 핀합니다.
LiveUpdate.reload()	CapacitorUpdater.reload()	선택 사항; Capgo은 필수 패키지를 Capgo이 강제합니다. notifyAppReady()
LiveUpdate.getCurrentBundle()	CapacitorUpdater.current()	선택 사항: 진단

네이티브 자동 업데이트를 유지하고 싶다면 Capawesome JavaScript를 완전히 삭제할 수 있습니다.

수동 제어 예시

최신 버블을 다운로드하세요

Capgo

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

__CAPGO_KEEP_0__

Capgo

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__

Capgo

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

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

Capawesome Cloud

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

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

5단계 - 업데이트 전략: Capgo이 어떻게 처리하는가

Capawesome은 3가지 전략을 문서화했습니다. 그들은 어떻게 변환되는지 알아보겠습니다.

배경 업데이트

• 이전 워크플로우: code에서 구성하고 수동으로 다운로드를 예약합니다.
• Capgo__CAPGO_KEEP_0__autoUpdate: true. No additional code required.

최신판

• 이전 워크플로우: add an App.resume 리스너, 호출 download, 그리고 set.
• Capgo: 백그라운드 자동 업데이트 already performs the check after resume. You only need the manual listener if you want a custom interval.

선택적: 수동 재개 확인

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

강제 업데이트

• 이전 워크플로우: wire prompt logic and enforce reload.
• Capgo: Capgo 마케팅 웹사이트의 CONTRIBUTING.ASTRO 페이지에 있는 CONTRIBUTE TO CAPGO 메시지 키의 HTML 텍스트 프라그먼트입니다. (Capgo 제품/브랜드 및 개발자 용어를 정확히 유지합니다.) majorAvailable : 대시보드에서 __CAPGO_KEEP_0__를 "필수"로 표시하고, __CAPGO_KEEP_1__가 발생한 후 __CAPGO_KEEP_2__를 통해 자동화된 배포를 수행할 수 있습니다. notifyAppReady()6단계 - 배포

6단계 - 배포

터미널 창 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

Capgo는 Capgo이 자동으로 번들 상태를 모니터링하기 때문에 다음도 제공합니다.

• 모든 설치에 대한 장치 수준 감사 로그
• 기본 1 개월 (24 개월까지 구성 가능) 자동 보존
• 실시간 지연 시간 지표 status.capgo.app/history.

Capgo로의 마이그레이션 일정

• 10 분 (기존 플러그인 제거)설정 및 준비npm install__CAPGO_KEEP_0__.app/history
• status.__CAPGO_KEEP_0__.app/history5분 이내 (notifyAppReady).
• 정상성 검사15분 이내 (선택적 수동 테스트 또는 리스너)
• 첫 번째 배포: 10 minutes with Capgo CLI or CI integration.

10분 이내 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 또는 CI 통합

Capgo support

• __CAPGO_KEEP_0__ 지원이주 콘시어지 book.capgo.app/demo.
• book.__CAPGO_KEEP_0__.app/demo: Capgo에 가입하세요. Capgo 디스코드.
• 이슈 트래커: github.com/Cap-go/capacitor-업데이터터/이슈.

Capgo은 장기적인 안정성을 위해 설계되었습니다: 원시 델타 업데이트, 암호화된 번들, 자동 롤백, 그리고 사용자 정의 자바스크립트가 필요하지 않은 분석입니다. 마이그레이션 후에는 유지보수-heavy 접착제를 삭제하고 플랫폼이 자동으로 업데이트를 실행하도록 허용할 수 있습니다.

Keep going from Migrate from Capawesome Cloud to Capgo

Capgo로 마이그레이션하기 Migrate from Capawesome Cloud to Capgo Capgo로 마이그레이션하기 Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds Capgo Native Builds Capgo Integrations Capgo Integrations CI/CD 연동 __CAPGO_KEEP_0__ Actions 연동 GitHub for the implementation detail in GitHub Actions Integration.