AppFlow에서 Capgo로의 이주

설치 단계와 이 플러그인에 대한 전체 마크다운 가이드가 포함된 설정 프롬프트 복사하기.

🚦 Ionic은 AppFlow의 상업 제품, 즉 Live Updates가 종료되고 있습니다. 기존 프로젝트는 2027년 12월 31일까지 실행할 수 있지만, 새로운 고객은 받지 않으며 새로운 기능은 계획하지 않습니다. 이 가이드는 __CAPGO_KEEP_0__로의 마이그레이션을 위한 필수 작업을 안내하며, __CAPGO_KEEP_0__에서 얻을 수 있는 네이티브 자동화도 강조합니다. 마이그레이션 개요, but no new customers are accepted and no new features are planned. This guide walks you through the actions required to migrate to Capgo and highlights the native automation you gain.

__CAPGO_KEEP_0는 채널, 번들 보존, 롤백, 분석 및 CAPGO_KEEP_1__ 업로드를 자동화합니다. 마이그레이션은 플러그인을 설치하고, 호출하는 것, 그리고 원하는 경우에만 옵션의 수동 제어를 구성하는 것입니다. 아래의 섹션은 각 작업을 직접 안내합니다.

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()__CAPGO_KEEP_0__

Step 0 – 현재 AppFlow 설정 캡처

AppFlow App ID, 기존 채널 및 서명 키를 기록하십시오.
업데이트 히스토리를 기록하고 싶은 경우에만 배포 히스토리를 내보내십시오.
GitHub 액션 또는 다른 CI 제공자가 사용 중이라면, Capgo과 함께 작동할 수 있도록 그 PIPELINE을 유지하십시오.

Step 1 – AppFlow SDK을 Capgo으로 대체하십시오.

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

그것이 다. Capgo은 iOS와 Android 모두에 대한 네이티브 code을 패키징합니다. 추가적인 JavaScript 도우미가 필요하지 않습니다.

2단계 - 최소 구성 (수동 field 없음)

기존 구성 블록이 광범위합니다. Capgo은 프로젝트와 채널을 자동으로 감지하므로 최소 구성은 다음과 같습니다:

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

구성 참조

아이오닉 앱 플로우 설정	Capgo 동등물	설정해야 하나요?
`appId`	Capgo 관리 대시보드에서 관리	프로젝트를 생성할 때 자동으로 제공
`channel` / `defaultChannel`	API 대시보드에서 채널 규칙	서버에서 기본값이 오는 경우 옵션 override; See 버전 타겟팅 다중 버전 전략을 위한
`autoUpdateMethod`	`autoUpdate: true`	기본적으로 활성화
`maxVersions`	보존 정책	중앙에서 구성 (기본 1 개월, 최대 24 개월)
`enabled`	필수는 아니지만	Capgo 채널당 가용성 toggle

Step 3 – Call `notifyAppReady()` (only required hook)

Ionic의 가이드에서 sync, download, 그리고 reload, 그 후 스플래시 화면을 수동으로 숨기세요. Capgo은 이 작업들을 네이티브로 수행합니다. 앱이 준비되었는지 확인하는 것만 필요합니다:

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

CapacitorUpdater.notifyAppReady()

확인이 절대 오지 않는다면 Capgo은 자동으로 번들을 롤백합니다.

그것만으로도 Capgo은 배경 검사, 스플래시 화면의 표시, 롤백을 모두 처리해줍니다.

선택 사항: 스플래시 화면이 숨기기 전에 논리를 실행하세요

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

CapacitorUpdater.addListener('appReady', () => {
  // Log diagnostics or run custom code if needed
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Step 4 – Update strategies translated

AppFlow는 세 가지 전략을 문서화합니다. 그들은 Capgo에 어떻게 매핑되는지 여기에 설명합니다.

배경 (기본)

AppFlow: 구성 autoUpdateMethod = background, 호출 sync() 수동으로.
Capgo: 기본적으로 활성화되어 있습니다. JavaScript가 필요하지 않습니다.

항상 최신

AppFlow: App.addListener('resume') ,handler가 다운로드하고 다시 로드합니다.
Capgo: 자동 업데이트 재개 시 이미 작동합니다. 사용자 지정 타이밍 창을 추가하려면 핸들러만 추가하세요.

선택적: 수동 재개 확인

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

App.addListener('resume', async () => {
  const bundle = await CapacitorUpdater.download()
  if (bundle) {
    await CapacitorUpdater.set({ id: bundle.id })
  }
})

강제 업데이트

AppFlow: 사용자에게 알리고 호출합니다. reload().
Capgo: __CAPGO_KEEP_0__을 “필수”로 마크하세요. 대시보드에서, __CAPGO_KEEP_0__ 호출을 __CAPGO_KEEP_0__의 이벤트 (__CAPGO_KEEP_0__ 호출 후에 방출됨)를 듣습니다. majorAvailable 5단계 – __CAPGO_KEEP_0__ 호출을 매핑하세요. notifyAppReady()__CAPGO_KEEP_0__ 매핑 섹션

Step 5 – Mapping API calls

필요합니까?	Capgo equivalent	__CAPGO_KEEP_0__의 네이티브 자동 업데이트 __CAPGO_KEEP_0__ 호출 없이 동기화 호출이 필요하지 않습니다.
`LiveUpdates.sync()`	사용자 지정 흐름에 대한 선택사항	Capgo’s native auto-update runs without a manual sync call
`LiveUpdates.download()`	`CapacitorUpdater.download()`	__CAPGO_KEEP_0__ 호출이 발생한 후에 방출되는 이벤트를 듣고, 사용자에게 __CAPGO_KEEP_0__ 또는 강제로 사용자에게 __CAPGO_KEEP_0__를 강제로 업데이트 하세요.
`LiveUpdates.reload()`	`CapacitorUpdater.set()`	__CAPGO_KEEP_0__의 네이티브 자동 업데이트 __CAPGO_KEEP_0__ 호출 없이 동기화 호출이 필요하지 않습니다.
`LiveUpdates.getVersion()`	`CapacitorUpdater.current()`	Optional diagnostics

6단계 – Capgo CLI 또는 API를 사용한 배포

Capgo CLI 또는 API를 업로드하여 마이그레이션을 완료하세요. 이 워크플로는 이전에 스크립트한 것과 비슷하지만, 이제는 네이티브 보안을 포함합니다.

capgo login                # authenticate once
capgo bundle upload \
  --path dist \
  --channel production     # automatically tags platform/version

버전별 배포 (AppFlow와 같은 경우)

특정 네이티브 버전을 대상으로 하려면 (AppFlow의 네이티브 버전 잠금과 유사한 경우):

# Only deliver to devices on native version 2.0.0 or higher
capgo bundle upload \
  --path dist \
  --channel production \
  --native-version "2.0.0"

# Use channels for different major versions
capgo bundle upload --channel v2  # for app version 2.x
capgo bundle upload --channel v3  # for app version 3.x

__CAPGO_KEEP_0__ 버전 목표 지침 전반적인 전략을 위한 comprehensive strategies.

Capgo 자동으로:

모든 설치에 대하여 장치 수준의 감사 로그를 유지합니다.
계획 한계에 접근할 때마다 proactive 이메일을 보냅니다.
릴리스 중에 중단되지 않도록 burst 크레딧을 제공합니다.
18 개의 글로벌 지역에서 latency 지표를 발행합니다. status.capgo.app/history.

아이오닉 기업 플러그인

If your Ionic stack also uses enterprise plugins, follow the targeted migration docs below. Each guide recommends the Capgo replacement and the next steps.

자주 묻는 질문

AppFlow가 실시간 업데이트 종료하는 이유는 무엇인가요?

Ionic은 AppFlow와 같은 상업 제품을 중단하고 오픈 소스 프레임워크에 집중하고 있습니다. 기존 고객은 2027년 12월 31일까지 실시간 업데이트 사용이 가능하지만, 새로운 기능이나 고객은 받지 않습니다. __CAPGO_KEEP_0__은 전용 네이티브 OTA 플랫폼을 제공하여 이 boş간을 채웁니다. 이주가 얼마나 걸리는가요?, but no new features or customers are accepted. Capgo fills that gap with a dedicated native OTA platform.

대부분의 팀은 하루 이내에 이주를 완료합니다. 채널, 배포, 릴리즈 규칙과 같은 개념은 직접 매핑되며, 우리 팀은 문서와 함께 직접적인 지원을 제공합니다. 많은 경우에 단순히 플러그인을 설치하고, __CAPGO_KEEP_0__을 호출하면 됩니다.

but no new features or customers are accepted. notifyAppReady()와 함께 첫 번째 번들을 업로드하세요.

돈을 절약할까요?

예. AppFlow live updates는 499 달러/월. Capgo은 14 달러/월 사용량에 따라 가격이 떨어지며 약 0.001 달러/MAU입니다. 또한 암호화, 자동 롤백 및 전 세계 지연 감시도 제공됩니다.

이제 언제 이주해야 하나요?

AppFlow는 현재 유지보수 모드에 있으므로 sooner로 마이그레이션을 하면 진행 중인 Capgo 혁신에 접근할 수 있습니다. 릴리스 일정에 맞춰 Switch를 추천합니다. 우리의 엔지니어 팀은 CI/CD 및 배포를 계속 실행하도록 변경을 계획하는 데 도움을 줄 것입니다.

추가 리소스

버전 대상 매칭 가이드 - AppFlow-style 버전 매칭 전략에 대한 깊은 이해
파괴적인 변경 - 채널을 사용하여 주요 버전 업데이트를 관리하는 방법
채널 관리 - 채널 구성 참조

도움이 필요합니다.

변경을 위한 마이그레이션 세션 예약: book.capgo.app/도구
Join the community: Capgo 디스코드
Track issues / request features: github.com/Cap-go/capacitor-업데이터

Capgo는 기업이 원하는 네이티브 델타 업데이트, 암호화된 패키지, 지속적인 혁신을 위해 설계되었습니다. 마이그레이션을 완료하면 AppFlow의 접착제 code를 삭제하고 네이티브 자동화에 의존하고, 중단 없이 계속 배포할 수 있습니다.

AppFlow에서 Capgo로 계속 진행하세요

AppFlow에서 __CAPGO_KEEP_0__로 계속 진행하세요 Migrate from AppFlow to Capgo AppFlow에서 __CAPGO_KEEP_0__로 마이그레이션하세요 AppFlow에서 Capgo로 마이그레이션하세요 제품 워크플로우에서 Capgo Enterprise를 위해 Ionic Enterprise 플러그인 대체 제품 워크플로우에서 Ionic Enterprise 플러그인 대체를 위해 Capgo 대체 제품 워크플로우에서 Capgo 대체를 위해 Capgo 컨설팅 제품 워크플로우에서 Capgo 컨설팅을 위해 Capgo 프리미엄 지원 제품 워크플로우에서 Capgo 프리미엄 지원을 위해