파괴적인 변경 사항

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

예시 시나리오

예를 들어, 다음과 같은 경우가 있습니다:

• App version 1.2.3 (old version) - uses production channel
• App version 2.0.0 (new version with breaking changes) - uses v2 channel
• Live update 1.2.4 (compatible with 1.2.3)
• Live update 2.0.1 (compatible with 2.0.0)

전략: 메이저 버전마다 defaultChannel을 사용하세요.

권장 방법: 각 메이저 버전마다 defaultChannel 을 설정하세요. 이렇게 하면 특정 사용자 그룹에 업데이트를 푸시할 수 있습니다. 동적 채널 할당에 의존하지 않습니다.

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

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

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

Tip

이 접근 방식의 이점:

• 항상 업데이트 받는 사용자에 대한 통제를 유지하세요
• 동적 채널-switching 이용하지 않아도 됩니다 code
• 다양한 앱 버전 사이의 분리
• flexibility 업데이트를 특정 버전 그룹에 푸시하는

1. 새로운 버전 채널 만들기

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

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

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

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 사용자는 __CAPGO_KEEP_0__을 설정하지 않았을 때 defaultChannel 처음에 __CAPGO_KEEP_0__을 설정하지 않았을 때 production __CAPGO_KEEP_0__ 채널을 항상 명시적으로 설정하십시오. 미래의 주요 버전을 위해 v3, v4, etc.

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 branch1.x 앱 업데이트를 위한 (production channel)
• main branch: 2.x 앱 업데이트 (v2 채널)

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 채널을 자동으로 사용합니다.

Note

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

Scaling to Future Versions

버전 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
    }
  }
};

Now you can push updates to any version:

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

7. 이주 후 정리

모든 사용자가 버전 2.x로 이주한 후 (3-4 개월 후):

1. 삭제 defaultChannel Capacitor 설정에서 삭제
2. 채널 v2 삭제:

npx @capgo/cli channel delete v2

3. 버전 1-maintenance branch 삭제:

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

팁

이 방법은 사용자가 자신의 앱 버전과 호환되는 업데이트만 받을 수 있도록 합니다.

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

주의

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

버전 1.x 업데이트를 유지 관리하는 방법

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

1. __CAPGO_KEEP_0__ branch로 switch 하세요:

git checkout v1-maintenance

2. __CAPGO_KEEP_3__ 변경 사항을 커밋하세요:

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

3. __CAPGO_KEEP_0__ 빌드 및 __CAPGO_KEEP_4__ 채널에 업로드하세요:

npx @capgo/cli bundle upload --channel production

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__ 버전 1.x와 호환되는 버그 수정을 __CAPGO_KEEP_0__ branch에 최신화하세요. __CAPGO_KEEP_0__ branch는 __CAPGO_KEEP_7__에서 발생하는 깨끗한 변경 사항을 절대 병합하지 마세요.

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__ __CAPGO_KEEP_2__ __CAPGO_KEEP_3__ __CAPGO_KEEP_4__ __CAPGO_KEEP_4__ __CAPGO_KEEP_4__ __CAPGO_KEEP_4__ __CAPGO_KEEP_5__ __CAPGO_KEEP_6__ __CAPGO_KEEP_7__ Beta 테스트 솔루션의 제품 워크플로우에 대해, 그리고 버전 목표 솔루션 버전 목표 솔루션의 제품 워크플로우에 대해.