파괴적인 변경

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 명령어를 복사하세요.

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

예시 시나리오

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

버전 1.2.3 (기존 버전) - 프로덕션 채널 사용
버전 2.0.0 (새 버전, 주요 변경 사항 포함) - v2 채널 사용
버전 1.2.4 (버전 1.2.3와 호환) - 라이브 업데이트
버전 2.0.1 (버전 2.0.0과 호환) - 라이브 업데이트

전략: 주요 버전마다 defaultChannel 사용

권장 방법: 버전을 업데이트할 때마다 defaultChannel 모든 주요 버전마다

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

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

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

1. 새로운 버전 채널을 생성하세요

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

버전 2.0.0을 위한 Capacitor 설정을 업데이트 하세요

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

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;

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: For updates to 2.x apps (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. Enable Self-Assignment

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

5.

버전 2.0.0을 앱 스토어에 배포하고 빌드하세요. 이 버전을 다운로드하는 모든 사용자(새 사용자 또는 업그레이드 중인 기존 사용자)는 앱 번들에 구성된 v2 채널을 자동으로 사용합니다.

‘미래 버전으로 확장’ 제목의 섹션

터미널 창

# 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 채널 → 버전 1.x 사용자
v2 채널 → 버전 2.x 사용자
v3 채널 → 버전 3.x 사용자

7. 이전 마이그레이션 후 정리

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

삭제 defaultChannel Capacitor 설정에서 제거
버전 2 채널 삭제:

npx @capgo/cli channel delete v2

v1-maintenance branch를 삭제하세요:

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

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

버전 1.x 업데이트 유지

버전 1.x와 호환 가능한 업데이트를 보내려면:

버전 1-maintenance branch로 Switch:

git checkout v1-maintenance

변경 사항을 만들고 커밋하세요:

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

제품 채널에 업로드하고 빌드하세요:

npx @capgo/cli bundle upload --channel production