__CAPGO_KEEP_0__ 변경 사항

앱에서 발생하는 깨끗한 변경 사항을 처리하는 방법에 대한 설명입니다. 이 접근 방식은 사용자가 호환 가능한 업데이트를 받을 수 있도록 앱의 다양한 버전을 유지 관리할 수 있도록 합니다.

예시 시나리오

예를 들어, 다음을 가정해 보겠습니다.

• 앱 버전 1.2.3 (기존 버전) - 프로덕션 채널을 사용합니다.
• 버전 2.0.0 (새 버전, 깨진 변경 사항 포함) - v2 채널 사용
• 라이브 업데이트 1.2.4 (1.2.3과 호환)
• 라이브 업데이트 2.0.1 (2.0.0과 호환)

전략: 메이저 버전마다 defaultChannel 사용

권장 방법: Set a defaultChannel for every major version. This ensures you can always push updates to specific user groups without relying on dynamic channel assignment.

// Version 1.x releases
defaultChannel: 'v1'

// Version 2.x releases
defaultChannel: 'v2'

// Version 3.x releases (future)
defaultChannel: 'v3'

팁

이 방법의 이점:

• 항상 업데이트 수신을 받는 사용자를 제어할 수 있습니다 업데이트를 받는 사용자를 제어할 수 있습니다
• 앱에서 동적 채널-switching이 필요하지 않습니다 __CAPGO_KEEP_0__ needed in your app code
• 업데이트를 받는 사용자 그룹에 업데이트를 푸시할 수 있는 유연성 1. 새로운 버전을 위한 채널을 생성하세요
• 터미널 창 복사하기

__CAPGO_KEEP_0__

# Create channel for version 2.x
npx @capgo/cli channel create v2

2. Capacitor 버전 2.0.0을 위한 설정 업데이트

Capacitor 설정을 빌드하기 전에 앱 스토어 버전 2.0.0을 위한 업데이트 하세요.

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // ... other options
      defaultChannel: 'v2' // All 2.0.0 users will use v2 channel
    }
  }
};

export default config;

주의

버전 1.x의 경우: 버전 1.x 사용자는 기본적으로 defaultChannel 버전 1.x 사용자는 기본적으로 production 버전 1.x 사용자는 기본적으로 v3, v4버전 1.x 사용자는 기본적으로

3. 별도 Code Branch 관리

별도의 Git branch를 생성하여 앱 버전 간 호환성을 유지하세요:

# Create and maintain a branch for version 1.x updates
git checkout -b v1-maintenance
git push origin v1-maintenance

# Your main branch continues with version 2.x development
git checkout main

중요: 기존 앱이 지원하지 않는 code/API를 사용하지 않도록 하세요. 항상 해당 branch에서 업데이트를 빌드하세요:

• v1-maintenance branch: 1.x 앱 업데이트를 위한 (production channel)
• main branch: 2.x 앱 업데이트를 위한 (v2 channel)

4. 각 채널에 업로드 된 패키지

# For 1.x updates: Build from v1-maintenance branch
git checkout v1-maintenance
# Make your 1.x compatible changes here
npx @capgo/cli bundle upload --channel production

# For 2.x updates: Build from main branch
git checkout main
# Make your 2.x changes here
npx @capgo/cli bundle upload --channel v2

5. 자체 할당 활성화

# Allow apps to self-assign to v2 channel
npx @capgo/cli channel set v2 --self-assign

6. 앱 스토어에 배포

버전 2.0.0을 앱 스토어에 배포하고, 이 버전을 다운로드하는 모든 사용자(새 사용자 또는 업그레이드하는 기존 사용자)는 자동으로 v2 채널을 사용하게 됩니다. 이는 앱 번들에 구성된 채널 때문입니다.

주의

code 변경이 필요하지 않습니다! Since defaultChannel: 'v2' 는 앱 스토어 버전과 함께 패키징되어, 버전 2.0.0을 다운로드하는 모든 사용자는 자동으로 올바른 채널을 사용하게 됩니다.

미래 버전으로 확장하는 방법

버전 3.0.0을 출시할 때 더 많은 변경 사항이 있는 경우:

# Create channel for version 3.x
npx @capgo/cli channel create v3

// capacitor.config.ts for version 3.0.0
const config: CapacitorConfig = {
  // ...
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'v3' // Version 3.x users
    }
  }
};

이제 어떤 버전에도 업데이트를 푸시할 수 있습니다:

• production channel → 버전 1.x 사용자
• v2 channel → 버전 2.x 사용자
• v3 채널 → 버전 3.x 사용자

7. 마이그레이션 후 정리

버전 2.x로 모든 사용자가 마이그레이션되면 (3-4 개월 후):

1. 삭제 defaultChannel Capacitor 설정에서
2. __CAPGO_KEEP_0__ 설정에서 삭제

npx @capgo/cli channel delete v2

3. 복사

git branch -d v1-maintenance
git push origin --delete v1-maintenance

Tip

이 접근 방식은 사용자가 자신의 앱 버전과 호환되는 업데이트만 받도록 보장합니다.

배포 전에 각 채널에서 업데이트를 철저히 테스트하세요.

Note

Capgo에서 v2 채널을 안전하게 삭제할 수 있습니다. 사용자가 채널 오버라이드가 아직 남아도 자동으로 프로덕션 채널에서 업데이트를 받게 됩니다.

버전 1.x 업데이트 유지

버전 1.x와 호환되는 업데이트를 보내려면:

1. v1-maintenance branch로 switch하세요.

git checkout v1-maintenance

2. 변경 사항을 적용하고 커밋하세요:

# Make 1.x compatible changes
git add .
git commit -m "Fix for v1.x"
git push origin v1-maintenance

3. 생산 채널에 업로드하세요:

npx @capgo/cli bundle upload --channel production

팁

버전 1.x와 호환 가능한 버그 수정을 포함하여 v1-maintenance branch를 최신 상태로 유지하세요. 그러나 main에서 브레이킹 변경 사항을 병합하지 마세요.

브레이킹 변경 사항에서 계속하세요

__CAPGO_KEEP_0__ 사용 중이라면 __CAPGO_KEEP_1__ 변경 사항 __CAPGO_KEEP_2__ 채널 라우팅과 단계별 출시를 계획하고, __CAPGO_KEEP_2__와 연결하세요. __CAPGO_KEEP_2__ __CAPGO_KEEP_2__의 구현 세부 정보에 대해 참조하세요. __CAPGO_KEEP_2__ __CAPGO_KEEP_2__의 구현 세부 정보에 대해 참조하세요. __CAPGO_KEEP_2__ __CAPGO_KEEP_2__의 구현 세부 정보에 대해 참조하세요. __CAPGO_KEEP_3__ 테스트 솔루션 __CAPGO_KEEP_3__의 제품 워크플로우에 대해 참조하세요. __CAPGO_KEEP_4__ 버전 대상 솔루션 __CAPGO_KEEP_0__