AppFlow에서 Capgo로 이주하세요

🚦 Ionic은 AppFlow의 상업 제품, 즉 Live Updates가 종료되고 있습니다. 기존 프로젝트는 2027년 12월 31일까지 실행할 수 있지만, 새로운 고객은 수락되지 않고 새로운 기능은 계획되지 않습니다. 이 안내서에서는 __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_1__

Version Targeting Like AppFlow

AppFlow의 자동 버전 일치 기능에 의존했다면 Capgo은 더 나은 제어를 제공하는 동일한 기능을 제공합니다. 더 자세한 관리 전략에 대한 정보는 Version Targeting Guide 를 참조하세요.

Step 0 – 현재 AppFlow 설정을 캡처하세요

• AppFlow App ID, 현재 채널 및 서명 키를 기록하세요.
• archive할 배포 기록을 내보내세요.
• GitHub Actions 또는 다른 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는 프로젝트와 채널을 자동으로 감지하므로 최소 구성은:

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

구성 참조

아이오닉 AppFlow 설정	Capgo 동등한 항목	설정해야 하나요?
appId	Capgo 대시보드에서 관리	프로젝트를 생성할 때 자동으로 제공
channel / defaultChannel	대시보드/API에서 채널 규칙	서버에서 오는 기본값을 오버라이드할 수 있습니다. 자세한 내용은 다중 버전 전략을 위한 버전 목표 기본적으로 활성화
autoUpdateMethod	autoUpdate: true	보존 정책
maxVersions	중앙에서 구성 (기본 1 개월, 최대 24 개월)	필요하지 않음
enabled	__CAPGO_KEEP_0__ equivalent	Capgo 채널별 가용성을 토글합니다.

Step 3 – __CAPGO_KEEP_0__ notifyAppReady() (필수적인 유일한 훅)

Ionic의 가이드에서 __CAPGO_KEEP_0__를 wire합니다. sync, download, 그리고 reload, Capgo가 자동으로 스플래시 화면을 숨깁니다. 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 – __CAPGO_KEEP_0__ translated

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

기본 (기본값)

• AppFlow: 설정 autoUpdateMethod = background, call sync() : 호출
• Capgo__CAPGO_KEEP_0__

: 기본적으로 활성화되어 있습니다. JavaScript가 필요하지 않습니다.

• AppFlow: 추가 App.addListener('resume') 핸들러를 다운로드하고 다시 로드합니다.
• 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__을 대시보드에서 "필수"로 표시하고, majorAvailable 이벤트 (대시보드에서 notifyAppReady())가 발생한 후 사용자에게 알리거나 강제로 앱 내에서 사용하도록 유도하는 이벤트입니다.

5단계 – API 호출 매핑

AppFlow 메서드	Capgo의 동등한 항목	필요합니까?
LiveUpdates.sync()	자동 처리	Capgo의 네이티브 자동 업데이트에는 수동 동기화 호출이 필요하지 않습니다.
LiveUpdates.download()	CapacitorUpdater.download()	사용자 정의 흐름에 대한 선택사항
LiveUpdates.reload()	CapacitorUpdater.set()	선택 사항; 대시보드 토글은 강제 업데이트 처리
LiveUpdates.getVersion()	CapacitorUpdater.current()	선택 사항의 진단

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

See the 버전 목표 지침 을 참조하십시오.

Capgo 자동으로:

• 기기 수준 감사 로그를 모든 설치에 대해 유지합니다.
• 계획 한계에 접근할 때 proactive 이메일을 보내줍니다.
• 릴리스 중간에 막히지 않도록 burst 크레딧을 제공합니다.
• 18 개의 글로벌 지역에서 18 개의 지연 시간 지표를 게시합니다. status.__CAPGO_KEEP_0__.app/history 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.

• Ionic Secure Storage에서 마이그레이션
• Ionic Auth Connect에서 마이그레이션
• Ionic Identity Vault에서 마이그레이션

자주 묻는 질문

AppFlow가 실시간 업데이트 기능을 중단하는 이유는 무엇인가요?

Ionic은 AppFlow와 같은 상업용 제품을 중단하고 오픈 소스 프레임워크에 집중하고 있습니다. 기존 고객은 2027년 12월 31일까지 실시간 업데이트 기능을 계속 사용할 수 있지만, 새로운 기능이나 고객은 받지 않습니다. __CAPGO_KEEP_0__은 Native OTA 플랫폼을 위한 전용 플랫폼입니다. __CAPGO_KEEP_0__은 Native OTA 플랫폼을 위한 전용 플랫폼입니다., but no new features or customers are accepted. Capgo fills that gap with a dedicated native OTA platform.

migration이 얼마나 오래 걸리나요? 섹션

대부분의 팀은 이 과정을 1일 이내에 완료합니다. 채널, 배포, 릴리즈 규칙과 같은 개념은 직접 매핑되며, 우리 팀은 문서화와 함께 실습 지원을 제공합니다. 많은 경우에 단순히 플러그인을 설치하고 notifyAppReady(), 첫 번째 배치를 업로드하면 됩니다.

돈을 절약할 수 있을까요?

네. AppFlow live updates는 $499/월Capgo는 $14/월 사용량에 따라 가격이 내려가며 약 $0.001사용자당에 도달하면 됩니다. 또한 암호화, 자동 롤백, 세계적인 지연 감시를 얻습니다.

이동할 때는 언제해야 하나요?

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

추가 리소스

• 버전 목표 지침 - AppFlow-style 버전 매칭 전략에 대한 깊은 이해
• 변경 사항 - 채널을 통해 주요 버전 업데이트를 관리하는 방법
• 채널 관리 - 채널 구성에 대한 완전한 참조

도움이 필요합니다

• Book a migration session: capgo.app/demo
• Join the community: Capgo Discord
• Track issues / request features: github.com/Cap-go/capacitor-updater

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

AppFlow에서 Capgo로 마이그레이션하는 것을 계속하세요.

AppFlow를 사용 중이라면 AppFlow에서 Capgo로 마이그레이션하는 것을 계속하세요 계획 마이그레이션 및 기업 운영을 위해 AppFlow를 연결하세요 Capgo 기업 Capgo 기업의 제품 워크플로우에 대해 아이오닉 기업 플러그인 대안 아이오닉 기업 플러그인 대안의 제품 워크플로우에 대해 Capgo 대안 Capgo 대안의 제품 워크플로우에 대해 Capgo 컨설팅 Capgo 컨설팅 및 Capgo 프리미엄 지원 Capgo 프리미엄 지원의 제품 워크플로우에 대해