Capawesome Cloud에서 Capgo로 이동

⚡️ Capgo 채널, 번들 정리, 롤백, 분석 및 CLI 업로드를 자동화합니다.

Overview

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

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

Copy for AI

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

1단계 – Capgo 설치 및 Capawesome SDK 제거

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

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

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는 그 단계를 원래대로 수행합니다. API을 호출할 필요가 있는 유일한 단계입니다.

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 동등	__CAPGO_KEEP_0__
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	__CAPGO_KEEP_0__
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	__CAPGO_KEEP_0__
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	__CAPGO_KEEP_0__
LiveUpdate.reload()	CapacitorUpdater.reload()	Capgo notifyAppReady()
LiveUpdate.getCurrentBundle()	CapacitorUpdater.current()	__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

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

__CAPGO_KEEP_0__

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

__CAPGO_KEEP_0__

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

__CAPGO_KEEP_0__

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

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

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

Capawesome은 세 가지 전략을 문서화합니다. 그들은 어떻게 번역되는지 알아보겠습니다.

배경 업데이트

• 이전 워크플로우: code에서 구성하고 수동으로 다운로드를 예약합니다.
• Capgo: 기본적으로 활성화되어 있습니다 (autoUpdate: true). 추가적인 code이 필요하지 않습니다.

최신 버전

• 이전 워크플로우__CAPGO_KEEP_0__ 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 })
    }
  }
})

강제 업데이트

• 이전 워크플로우__CAPGO_KEEP_0__
• Capgo: __CAPGO_KEEP_0__을 대시보드에서 "필수"로 표시하고, 다음 이벤트를 듣기 시작하세요. majorAvailable 이벤트 (배포 후 notifyAppReady())를 통해 사용자에게 앱 내에서 업그레이드하도록 요구하세요.

Step 6 – 배포

이전에는 capawesome live-update deploy, Capgo은 유사한 CLI 워크플로를 제공하며, 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이 자동으로 배포 패키지의 상태를 추적하기 때문에, 다음도 얻을 수 있습니다.

• 장치 수준의 설치 로그
• 자동 보관 (기본 1 개월, 24 개월까지 조정 가능)
• 실시간 지연 시간 지표 ( status.capgo.app/history.

이동 계획

• 인벤토리 및 설치: 10 분 (npm install: 5 분 (
• : 15 분 (선택적 수동 테스트 또는 리스너)설정 및 준비notifyAppReady).
• 정상성 검사이동 계획
• 첫 번째 배포: Capgo CLI 또는 CI 통합과 함께 10 분

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

Capgo 지원

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

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

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

Capawesome Cloud에서 __CAPGO_KEEP_0__으로 계속 진행하세요 Migrate from Capawesome Cloud to Capgo Capawesome Cloud에서 __CAPGO_KEEP_0__으로 마이그레이션하세요. Capgo CI/CD와 연결하여 CI/CD 자동화 계획을 수립하세요. Capgo CI/CD에서 제품 워크플로우를 관리하세요. Capgo Native Builds에서 제품 워크플로우를 관리하세요. Capgo Native Builds에서 제품 워크플로우를 관리하세요. Capgo Integrations 제품 워크플로우에서 Capgo 통합에 대해 CI/CD 통합 CI/CD 통합에 대한 구현 세부 정보에 대해 GitHub 액션 통합 GitHub 액션 통합에 대한 구현 세부 정보에 대해