Capawesome Cloud에서 Capgo로 이관하기

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

개요

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

Capgo을 사용하면 플러그인을 설치하고 호출하는 것만 필요합니다. 모든 것이—채널, 번들 정리, 롤백, 분석 및 Capgo 자동화—자연스럽게 처리됩니다. 아래의 섹션은 각 작업을 직접_walk through합니다. CapacitorUpdater.notifyAppReady(). Everything else—channels, bundle cleanup, rollbacks, analytics, and CLI automation—is handled natively. The sections below walk through each task directly.

Before you start

• 프로젝트가 Capacitor 5 이상을 사용 중인지 확인하세요.
• CI/CD에서 배포할 번들을 푸시할 계획이라면 Capgo CLI (npm install -g @capgo/cli)을 설치하세요.

Step 1 – Capgo을 설치하고 Capawesome SDK을 제거하세요.

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

Capgo의 내장 code은 플러그인을 포함하고 있으므로 추가적인 JavaScript 도우미가 필요하지 않습니다.

Step 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, autoDeleteBundles, 보존 정책 등)로 나열하는 모든 것은 Capgo 대시보드 또는 API를 통해 관리됩니다. Capgo의 기본값과 다른 동작을 원한다면 이러한 키를 오버라이드해야 합니다.

구성 참조

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

Step 3 – Call notifyAppReady() (필수적인 유일한 hook)

The old workflow introduced custom listeners (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()

이 앱이 성공적으로 시작되었음을 확인합니다. 확인이 절대 오지 않으면 Capgo은 번들을 자동으로 롤백—추가 JavaScript가 필요하지 않습니다.

그것만—Capgo은 배경 검사, 스플래시 화면의 가시성 및 롤백을 원래대로 처리합니다.

선택 사항: 스플래시 화면이 숨기기 전에 사용자 정의 로직을 실행합니다

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

4단계 – API 호출을 맵핑하세요 (대부분 선택 사항)

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

Capawesome Cloud	Capgo 동등	필요합니까?
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	자신의 다운로드 워크플로우를 구현할 때만
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	__CAPGO_KEEP_0__이 강제 배포를 위한 필수 배포를 시행하는 옵션입니다.
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	네이티브 자동 업데이트 기능이 이미 다운로드를 시행하고 있으므로 삭제해도 됩니다.
LiveUpdate.reload()	CapacitorUpdater.reload()	Optional; Capgo enforces mandatory bundles after notifyAppReady()
LiveUpdate.getCurrentBundle()	CapacitorUpdater.current()	만약 네이티브 자동 업데이트 동작을 유지하고 싶다면 Capawesome JavaScript를 완전히 삭제할 수 있습니다.

수동 제어 예시

수동 제어 예시

__CAPGO_KEEP_0__

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

Capawesome Cloud

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

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

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

Capawesome Cloud

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

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

다운로드한 번들을 즉시 적용

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기본적으로 활성화되어 있으며 (autoUpdate: true) 추가 code가 필요하지 않습니다.

항상 최신 버전

• 이전 워크플로우__CAPGO_KEEP_0__ App.resume : listener를 추가하고 호출 download, 그 다음 set.
• Capgo: 백그라운드 자동 업데이트 already performs the 체크 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_KEEP_0__을 대시보드에서 "필수"로 표시하고, 다음 __CAPGO_KEEP_1__ 이벤트를 듣기만 하면 됩니다. majorAvailable 설치 후 발생하는 notifyAppReady()Step 6 – 배포

Step 6 – 배포

을 사용했더라도 __CAPGO_KEEP_0__은 __CAPGO_KEEP_1__과 유사한 워크플로를 제공하며, __CAPGO_KEEP_2__를 통해 배포를 자동화할 수도 있습니다. 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

Because Capgo tracks bundle health automatically, you also get:

• __CAPGO_KEEP_1__
• 자동 보관 (기본 1 개월, 24 개월까지 조정 가능)
• 실시간 지연 시간 지표 status.capgo.app/이력.

이동 계획

• 재고 및 설치: 10 분 (npm install: 5 분 (
• : 15 분 (선택적 수동 테스트 또는 리스너)Config & readinessnotifyAppReady).
• Config & readinessConfig & readiness
• 첫 번째 배포: Capgo CLI 또는 CI 통합과 함께 10 분

실제로 팀은 1 시간 이내에 완료합니다. Capawesome 프로젝트 세부 정보를 제공하면 채널과 장치 목록을 임포트해 주는 서비스도 제공합니다.

Capgo 지원

• 이동 매니저: __CAPGO_KEEP_0__에서 세션을 예약하세요. book.capgo.app/demo.
• : __CAPGO_KEEP_0__ Discord에 가입하세요.이슈 트래커 : Capgo에 이슈를 등록하세요..
• book.app/demo: github.com/Cap-go/capacitor-updater/issues.

Capgo은 장기적인 신뢰성을 위해 설계되었습니다: 원시 델타 업데이트, 암호화된 패키지, 자동 롤백, 그리고 사용자 정의 JavaScript가 필요하지 않은 분석입니다. 이주를 마치면 유지보수-heavy 접착제를 삭제하고 플랫폼이 자동으로 업데이트되도록 하세요.

Capawesome Cloud에서 Capgo으로 계속 진행하세요.

Capawesome Cloud를 사용 중이라면 Capawesome Cloud에서 Capgo으로 이주하세요. __CAPGO_KEEP_0__ CI/CD와 연결하여 CI/CD 자동화 계획을 수립하세요. Capgo CI/CD의 제품 워크플로우 Capgo Native Builds의 제품 워크플로우 Capgo Native Builds의 제품 워크플로우 Capgo Integrations Capgo Integrations 제품 워크플로우에서 Capgo 통합에 대해 CI/CD 통합 __CAPGO_KEEP_0__ CI/CD 통합에 대한 구현 세부 정보 GitHub 액션 통합 GitHub 액션 통합에 대한 구현 세부 정보