Capawesome Cloud에서 Capgo로 이동

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.

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

개요

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

Capgo Capgo을 사용하면 플러그인을 설치하고 호출하는 것만 필요합니다. CapacitorUpdater.notifyAppReady()모든 것이—채널, 번들 정리, 롤백, 분석 및 CLI 자동화—자연스럽게 처리됩니다.

시작하기 전에

프로젝트가 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단계 – 최소 구성

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

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()Capgo은 스플래시 화면을 숨기기 등과 같은 작업을 원시적으로 수행합니다. 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의 동등한 항목	필요합니까?
`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__

Capawesome JavaScript을 삭제할 수 있습니다.

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

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

다음 번들 설정

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

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

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

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

__CAPGO_KEEP_0__ 업데이트 전략 3 가지를 문서화합니다. 그들은 어떻게 변환되는지 알아보겠습니다.

배경 업데이트

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

항상 최신

이전 워크플로우: 추가 리스너를 등록하고 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_KEEP_0__을 "필수"로 표시하세요. (대시보드에서), 그리고 다음 이벤트를 듣세요 (이벤트는 __CAPGO_KEEP_1__ 업그레이드 후에 방출됩니다) 사용자에게 앱 내에서 업그레이드하도록 요구합니다. majorAvailable Step 6 – 배포 패키지 notifyAppReady()Section titled “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:

event (emitted after
Step 6 – 배포 패키지
실시간 지연 지표를 제공하는 status.capgo.app/history.

이주 일정

인벤토리 & 설치10분 (npm install기존 플러그인을 제거합니다.)
설정 & 준비5분 (notifyAppReady).
정상성 검사15분 (선택적 수동 테스트 또는 리스너).
첫 번째 배포: 10분 이내에 Capgo CLI 또는 CI 통합을 완료합니다.

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

Capgo 지원

마이그레이션 콘시어지: __CAPGO_KEEP_0__ 세션을 예약하세요. book.capgo.app/demo.
커뮤니티: __CAPGO_KEEP_0__ 디스코드에 가입하세요. Capgo Discord.
__CAPGO_KEEP_0__.com/Cap-go/__CAPGO_KEEP_1__-업데이터/issues: github.com/Cap-go/capacitor-updater/issues.

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

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

__CAPGO_KEEP_0__을 사용 중이라면 Capawesome Cloud에서 Capgo으로 마이그레이션하세요. CI/CD 자동화 계획을 위해 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 위해 Capgo Native Builds Capgo Native Builds에서 제품 워크플로우를 위해 Capgo Integrations Capgo Integrations에서 제품 워크플로우를 위해 CI/CD 통합 CI/CD 통합 구현 세부 사항에 대해, GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항에 대해.