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__

Step 0 – 현재 앱 플로우 설정 캡처

앱 플로우를 참고하세요. 앱 ID,
기존 채널 및 서명 키를 기록하세요.
If you are using GitHub Actions or another CI provider, keep those pipelines—they will keep working with Capgo.

SDK 액션 또는 다른 CI 제공자를 사용하고 있다면, 그 PIPELINES를 유지하세요. 그들은 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

구성 참조

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

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

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 – __CAPGO_KEEP_0__

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

기본 배경

AppFlowconfigure autoUpdateMethod = background: 설정 sync() call
Capgo__CAPGO_KEEP_0__

: 기본적으로 활성화되어 있으며 JavaScript가 필요하지 않습니다. 항상 최신 버전

AppFlow__CAPGO_KEEP_0__ 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

: 사용자에게 알리고 호출하세요.Copy to clipboard reload().
Capgo: __CAPGO_KEEP_0__을 대시보드에서 "필수"로 표시하고, majorAvailable 이벤트 (대시보드에서 notifyAppReady())가 발생한 후에

Step 5 – Mapping API calls

5단계 제목 – __CAPGO_KEEP_0__ 호출 매핑	Capgo와 관련된 AppFlow 메서드	__CAPGO_KEEP_0__의 동등한 항목
`LiveUpdates.sync()`	__CAPGO_KEEP_0__이 필요합니까?	Capgo이 자동으로 처리됩니다.
`LiveUpdates.download()`	`CapacitorUpdater.download()`	__CAPGO_KEEP_0__의 원래 자동 업데이트 기능은 수동 동기화 호출 없이 작동합니다.
`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

__CAPGO_KEEP_0__ 자동으로: 버전 목표 지침서 를 참조하십시오.

Capgo은 다음을 자동으로 수행합니다.

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

아이오닉 기업 플러그인

아이오닉 스택이 기업 플러그인을 사용한다면, 아래에 나열된 대상화된 마이그레이션 문서를 따르십시오. 각 지침은 Capgo 대체 항목과 다음 단계를 추천합니다.

자주 묻는 질문

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

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

이동 시간 섹션

대부분의 팀은 이 과정을 1일 이내에 완료합니다. notifyAppReady()채널, 배포, 및 릴리스 규칙과 같은 개념은 직접 매핑되며, 우리 팀은 문서화 및 실습 지원을 제공합니다.

많은 경우에는 단순히 플러그인을 설치하고

돈을 절약할 수 있을까요? 돈을 절약할 수 있을까요?. Capgo starts at $499/월 에서 시작됩니다. __CAPGO_KEEP_0__는$14/월

에서 시작되며 사용량에 따라 가격이 약

AppFlow는 현재 유지보수 모드에 들어서면서, 이전하는 sooner는 ongoing Capgo 혁신에 접근할 수 있습니다. 우리는 릴리즈 일정에 맞춰서 Switching을 추천합니다. 우리의 엔지니어 팀은 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로 마이그레이션하는 것을 계속하세요 계획 마이그레이션 및 기업 운영을 위해 마이그레이션하고 enterprise operations을 연결하세요 Capgo 기업 버전 Capgo 기업 버전의 제품 워크플로우를 위해, 아이오닉 기업 플러그인 대체 아이오닉 기업 플러그인 대체의 제품 워크플로우를 위해, Capgo 대체 Capgo 대체의 제품 워크플로우를 위해, Capgo 컨설팅 Capgo 컨설팅을 위한 제품 워크플로우, 그리고 Capgo 프리미엄 지원 Capgo 프리미엄 지원의 제품 워크플로우를 위해.