Capgo로 마이그레이션하세요.

설치, 동기화 및 이 플러그인의 전체 소스 가이드를 복사할 수 있는 명령어로 따라하세요.

🚦 Ionic은 AppFlow의 상업 제품, 즉 Live Updates가 종료되기 시작했습니다. 기존 프로젝트는 까지 실행할 수 있지만, 새로운 고객은 수락되지 않고 새로운 기능은 계획되지 않습니다. 이 가이드는 __CAPGO_KEEP_0__로의 마이그레이션을 안내하며, native 자동화의 이점을 강조합니다., 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 handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()버전 목표와—if 필요하면—선택적 수동 제어를 구성하는 방법에 대해 설명합니다. 아래 섹션에서는 각 작업을 직접 안내합니다.

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

App ID App IDApp ID
App ID를 포함한 기존 채널 및 서명 키를 기록하세요.
If you are using GitHub Actions or another CI provider, keep those pipelines—they will keep working with Capgo.

1단계 – 앱플로우 SDK를 Capgo로 대체하세요.

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

그것만으로입니다. Capgo는 iOS와 Android 모두에 대한 네이티브 code를 패키징합니다. 추가적인 자바스크립트 헬퍼가 필요하지 않습니다.

2단계 – 최소한의 구성 (수동 field가 필요하지 않습니다)

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

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

구성 참조

Ionic AppFlow 설정	Capgo 동등 항목	설정해야 하나요?
`appId`	Capgo 대시보드에서 관리	프로젝트 생성 시 자동으로 제공
`channel` / `defaultChannel`	채널 규칙 대시보드/API	선택적 override; 기본값은 서버에서 오는 것을 참조. See 버전 목표 설정 다중 버전 전략을 위한
`autoUpdateMethod`	`autoUpdate: true`	기본적으로 활성화
`maxVersions`	보존 정책	중앙에서 구성 (기본 1 개월, 최대 24 개월)
`enabled`	필수는 아니지만	Capgo 채널별로 사용 가능 여부를 설정합니다.

3 단계 - 호출 `notifyAppReady()` (필수 hook)

, 그리고 sync, download, 스플래시 화면을 수동으로 숨기세요. __CAPGO_KEEP_0__은 이 작업들을 네이티브로 처리합니다. 앱이 준비되었는지 확인만 하면 됩니다: reload, then hide the splash screen manually. Capgo performs those actions natively. You only need to confirm the app is ready:

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

4단계 – 업데이트 전략 번역

AppFlow는 세 가지 전략을 문서화합니다. Capgo은 다음과 같이 매핑됩니다.

배경 (기본)

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

항상 최신

AppFlow: 다운로드 및 다시 로드하는 핸들러를 추가하세요. App.addListener('resume') __CAPGO_KEEP_0__
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 })
  }
})

강제 업데이트

앱플로우: 사용자에게提示并调用 reload().
Capgo: 대시보드에서 번들을 "필수"로 표시하고, majorAvailable 이벤트 (Capgo에서 notifyAppReady())를 기다리며 사용자에게提示하거나 강제로 앱 내에서 사용하도록 합니다.

5단계 - API 호출 매핑

앱플로우 메서드	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
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
  --path dist \
  --channel production \
  --min-update-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 자동으로:

__CAPGO_KEEP_0__는 장치 수준의 감사 로그를 모든 설치에 대해 유지합니다.
__CAPGO_KEEP_0__는 계획 한계에 접근할 때마다 예방적 이메일을 보냅니다.
__CAPGO_KEEP_0__는 릴리스 중간에 차단되지 않도록 버스트 크레딧을 제공합니다.
__CAPGO_KEEP_0__는 18 개의 글로벌 지역에서 18 개의 지연 시간 지표를 제공합니다. capgo.app/history.

아이오닉 엔터프라이즈 플러그인

Ionic 스택이 기업 플러그인을 사용하는 경우에도, 아래의 대상화된 마이그레이션 문서를 따르세요. 각 가이드는 Capgo 대체 및 다음 단계를 추천합니다.

자주 묻는 질문

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

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

이주가 얼마나 걸리는지?

대부분의 팀은 하루 이내에 이주를 완료합니다. 채널, 배포, 및 릴리스 규칙과 같은 개념은 직접 매핑되고, 우리 팀은 문서화 및 실습 지원을 제공합니다. 많은 경우에 단순히 플러그인을 설치하고, notifyAppReady()를 호출하고,

첫 번째 번들을 업로드합니다.

비용을 얼마나 절약할 수 있을까요? 예. AppFlow live updates는 . Capgo starts at 에서 시작되며, __CAPGO_KEEP_0__ 은 사용량에 따라 시작하는 가격이 . Capgo를 사용하면 암호화, 자동 롤백 및 전 세계 지연 감시도 제공됩니다.

이제 AppFlow는 유지 보수 모드에 들어가 있습니다. 따라서 이전하는 sooner는 __CAPGO_KEEP_0__의 지속적인 혁신에 접근할 수 있습니다. 우리는 릴리스 일정에 맞춰 Switch하는 것을 추천합니다. 우리의 엔지니어 팀은 CI/CD 및 배포가 계속 작동하도록 변경을 계획하는 것을 도와드립니다.

Because AppFlow is now in maintenance mode, migrating sooner gives you access to ongoing Capgo innovation. We recommend switching when it fits your release schedule. Our engineering team will help you plan the changeover so your CI/CD and deployments keep running.

버전 대상 매뉴얼

Breaking Changes - 채널을 사용하여 주요 버전 업데이트를 관리하는 방법
Channel Management - 채널 구성 참조
Additional Resources Version Targeting Guide

도움이 필요하세요?

업그레이드 세션 예약: book.capgo.app/demo
커뮤니티에 가입하세요: Capgo Discord
이슈 추적 / 기능 요청: github.com/Cap-go/capacitor-updater

Capgo는 기업용으로 설계된 엔터프라이즈 제품으로, 원본 델타 업데이트, 암호화된 패키지, 지속적인 혁신을 제공합니다. 마이그레이션 후 AppFlow의 중간 계층 code를 삭제하고, 원본 자동화에 의존하고, 중단 없이 계속 배포할 수 있습니다.

AppFlow에서 Capgo로 계속 진행:

__CAPGO_KEEP_0__ Migrate from AppFlow to Capgo to plan migration and enterprise operations, connect it with __CAPGO_KEEP_0__ Enterprise Capgo Enterprise for the product workflow in Capgo Enterprise Ionic Enterprise Plugin Alternatives for the product workflow in Ionic Enterprise Plugin Alternatives Capgo Alternatives for the product workflow in Capgo Alternatives Capgo Consulting for the product workflow in Capgo Consulting, and Capgo Premium Support for the product workflow in Capgo Premium Support