Semantic Versioning을 사용하는 방법: Capgo OTA 업데이트

업데이트를 간소화하고 버전 관리를 원하신다면? 앱 업데이트를 Semantic Versioning (SemVer) 와 __CAPGO_KEEP_0__ ’s Over-The-Air (OTA) 업데이트는 앱 관리를 더 쉽고 빠르게 만듭니다. Capgo버전은 다음 형식으로 사용됩니다. Capacitor __CAPGO_KEEP_0__

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ MAJOR.MINOR.PATCH:
- MAJOR: 새로운 버전의 큰 변화.
- MINOR: 새로운 기능이 뒤따르는 호환성 있는 버전.
- PATCH: 버그 수정.
SemVer를 사용하는 Capgo의 이유.
- 업데이트에 대한 명확한 통신.
- 버전 관리의 지혜.
- 의존성 충돌을 피하기.
- 릴리즈 계획의 조직화.
Capgo 설정 단계:
1. Capgo 업데이터 플러그인을 설치하세요.
2. 버전을 설정하세요. capacitor.config.json 버전을 설정하세요.
3. API 키를 초기화하세요.
4. Use Capgo CLI 업데이트를 패키징하고 업로드하세요.
버전 및 채널 관리:
- 분리된 채널을 사용하세요 (예: 테스트를 위해 'beta', 안정적인 릴리스를 위해 'production').
- 업데이트 정책을 제어하세요 (패치 자동 업데이트, 주요 변경 사항에 대한 수동 승인).
- 실패한 업데이트에 대한 롤백 옵션.
배포 프로세스:
- SemVer 규칙에 따라 버전 번호를 업데이트하십시오.
- 배포하기 전에 철저히 테스트하십시오.
- CLI 명령어를 사용하여 업데이트를 업로드하고 배포하십시오.

Capgo은 업데이트를 사용자에게 신속하고 신뢰할 수 있게 전달하며, 장애를 처리하고 안정성을 유지하는 데 필요한 도구를 제공합니다. CI/CD 워크플로우를 사용하여 업데이트를 자동화하는 팀에게 이상적인 선택입니다.

빠른 팁: 업데이트를 항상 테스트하고 채널을 사용하여 단계별 롤아웃을 효과적으로 관리하십시오.

Semantic Versioning | 업그레이드 수준

Capgo 설정 안내서

Capgo Live Update 대시보드 인터페이스

Capgo을 사용하여 Capgo OTA 업데이트와 버전 관리를 편리하게 관리하는 방법입니다.

초기 설정 단계

첫 단계는 __CAPGO_KEEP_0__ 업데이트러 플러그인을 설치하는 것입니다. Capgo 업데이트러 플러그인을 설치하여:

npm install @capgo/capacitor-updater  
npx cap sync

__CAPGO_KEEP_0__ capacitor.config.json 파일은 의미적 버전 형식으로 사용합니다.

{ 
  "appId": "com.example.app", 
  "appName": "My App", 
  "version": "1.0.0" 
}

파일이 의미론적 버전 형식으로 사용되는지 확인하세요:

package.json 오래된 프로젝트의 경우, 다음 위치에서 버전 정보를 업데이트하세요: version (버전 정보를 찾으려면)
android/app/build.gradle (update versionName)
ios/App/App.xcodeproj/project.pbxproj (update CURRENT_PROJECT_VERSION)

Capgo를 초기화 한 후 Capgo Capgo를 사용하여 API 키로 초기화하세요.

npx @capgo/cli@latest init YOUR_API_KEY

빠른 참조 표:

설정 단계	주요 동작	인증 단계
설치	플러그인 설치 및 동기화	체크 `package.json`
설정	버전 번호 설정	모든 파일에 대한 확인
초기화	API 키와 연결	연결 상태 테스트
빌드	초기 버전 생성	업로드 성공 확인

버전 관리 통합

Capgo는 CI/CD 플랫폼과 잘 작동하여 자동 업데이트 자동 업데이트

개발 환경에서 로컬 개발을 진행 중이라면, 자동 업데이트 기능을 비활성화하려면 다음을 설정 파일에 추가하세요:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

이 설정은 Capgo가 로컬 변경 사항을 덮어쓰지 않도록 합니다. 설정이 준비되면 첫 번째 버전을 업로드하세요:

npx @capgo/cli@latest bundle upload  
npx @capgo/cli@latest channel set production -s default

마지막으로 앱의 메인 파일에서 번들의 상태를 native 플러그인에 알리세요:

import { CapacitorUpdater } from '@capgo/capacitor-updater';  
CapacitorUpdater.notifyAppReady();

이 설정은 앱이 OTA 배포 및 버전 관리를 위한 smooth한 배포를 준비합니다.

Semantic Versioning을 사용하여 Capgo

버전 번호 관리

Capgo은 Semantic Versioning (SemVer)을 사용하여 앱 버전을 관리하며, 버전 형식은 다음과 같습니다. MAJOR.MINOR.PATCH다음과 같이 작동합니다:

주 버전 (X.0.0): 호환성 깨지는 변경 사항이 있을 때 MAJOR 숫자를 증가시킵니다.
소 버전 (1.X.0): 새로운 호환성 유지되는 기능에 대해 MINOR 숫자를 증가시킵니다.
패치 버전 (1.0.X): 호환성에 영향을 주지 않는 버그 수정에 대해 PATCH 숫자를 증가시킵니다.

버전 종류	인크먼트 시기	자동 업데이트 동작
주 버전 (X.0.0)	: 깨끗한 API 변경에 대해	: 수동 승인 필요
소 버전 (1.X.0)	: 새로운 기능에 대해	Capgo
패치 (1.0.X)	버그 수정	일반적으로 자동

SemVer 규칙을 따르면 버전 관리를 단순화하고 배포 채널 간 업데이트를 smoother하게 하실 수 있습니다.

버전 관리 지침

Capgo은 워크플로우의 다양한 단계에 대한 별도의 채널을 설정하여 배포를 효과적으로 관리하실 수 있도록 해줍니다.

채널 기반 버전 관리: 배포 프로세스를 조직하기 위해 테스트 및 프로덕션과 같은 별도의 채널을 생성하세요.
- 예를 들어, 새로운 기능을 테스트하기 위해 “beta” 채널 (예: 1.2.0-beta)을 사용하세요.
- 안정적인 릴리즈를 위해 “production” 채널 (예: 1.2.0)을 유지하세요.
- 플랫폼별 문제를 해결할 때 플랫폼별 채널 (예: “ios-hotfix” 버전 1.2.1)을 추가하세요.
업데이트 정책 구성: 업데이트가 적용되는 방법을 제어하는 Capgo의 구성 옵션을 사용하세요. 예를 들어:
```
{
  "plugins": {
    "CapacitorUpdater": {
      "disableAutoUpdate": "minor"
    }
  }
}
```
이 설정은 사용자가 패치 업데이트를 자동으로 받게 하며, 미니어처 및 메이저 업데이트는 수동 승인 필요합니다.
버전 롤백 전략: 이전 버전으로 롤백할 수 있도록 명확한 롤백 옵션을 유지하기 위해 프리 리리즈 식별자를 사용하세요. 이 접근 방식은 문제가 발생할 경우 이전 버전으로 롤백할 수 있으면서 모든 채널에서 버전 관리를 일관되게 유지할 수 있습니다.

이러한 베스트 프랙티스는 업데이트를 관리하는 데 도움이 되며, 새로운 기능을 테스트하고 앱의 배포 프로세스에서 안정성을 유지하는 데 도움이 됩니다.

sbb-itb-f9944d2

OTA 업데이트 배포

버전 관리 설정이 준비되면 OTA 업데이트를 효과적으로 배포하기 위한 단계를 따르세요.

업데이트 준비

버전을 업데이트하기 위해 package.json 및 capacitor.config.json버전은 SemVer 형식 (MAJOR.MINOR.PATCH)으로 구성되어야 합니다.:

버그 수정: PATCH 번호를 증가시킵니다 (예: 1.0.1 → 1.0.2)
새 기능: MINOR 번호를 증가시킵니다 (예: 1.0.0 → 1.1.0)
파괴적인 변경: MAJOR 번호를 증가시킵니다 (예: 1.0.0 → 2.0.0)

빌드가 완전히 테스트되고 앱이 서버와 통신하는 것을 확인한 후 notifyAppReady.

다음으로 업데이트 전략을 결정합니다 이용. 사용할 수 있는 옵션입니다:

자동 업데이트: 최소 버전 요구 사항을 자동으로 적용합니다.
수동 제어: 업데이트 시 정확한 버전 요구 사항을 지정합니다.
채널 기반: 채널을 통해 테스트 및 스테이지 롤아웃을 사용합니다.

Capgo CLI 업데이트 명령

Capgo의 CLI을 사용하여 업데이트를 쉽게 배포하세요. 방법은 다음과 같습니다:

# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]

# Upload your update bundle
npx @capgo/cli bundle upload [appId]

# Add a new distribution channel
npx @capgo/cli channel add [channelName] [appId]

Capgo은 종단 간 암호화 및 안전한 키 관리를 통해 안전한 배포를 보장합니다.

“Capgo은 @code을 위한 지능적인 방법입니다. (그것은 @AppFlow와 달리 모든 돈을 위해 아님 🙂)”

배포 후, Capgo의 대시보드를 통해 업데이트를 모니터링할 수 있습니다. 업데이트는 사용자가 앱을 열 때 일반적으로 몇 분 안에 사용자에게 도달합니다. 업데이트 프로세스는 다음과 같습니다:

앱은 업데이트 확인을 합니다.
배경에서 업데이트 다운로드를 수행합니다.
사용자가 앱을 종료할 때 새로운 버전을 활성화합니다.
다음 런칭 시 업데이트 적용을 수행합니다.

기업급 배포에 대한 경우, CI/CD 자동화 통합을 고려해 보세요.

“Agile 개발을 실천하고 @Capgo은 사용자에게 지속적으로 제공하는 mission-critical입니다!”

문제 해결 및 팁

버전 관리 문제

Capgo에서 의미적 버전 관리를 관리하는 경우, 업데이트 배포가 복잡해질 수 있습니다. 개발 작업을 덮어쓰지 않도록 하기 위해, 다음을 설정하세요. capacitor.config.json 파일:

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

업데이트가 실패한 경우, 다음을 수행하세요:

설정 autoUpdate to false 개발 중인 동안
앱을 제거하세요.
수정된 버전으로 다시 설치하세요.
모든 것이 안정되면 다시 자동 업데이트를 활성화하세요.

주 버전 업데이트를 위해 disableAutoUpdateBreaking flag를 사용하고 majorAvailable 업데이트를 처리하기 위해

CapacitorUpdater.addListener('majorAvailable', (info) => {
  console.log(`Major update available: ${info.version}`);
  // Add your update prompt logic here
});

이벤트를 듣는 것을 기억하세요:

이러한 설정과 좋은 팀 관행을 combination하면 버전 일관성을 유지하고 오류를 줄일 수 있습니다.

팀 버전 관리

개별 업데이트가 관리되면 팀은 강력한 버전 관리 관행을establish해야합니다. [4]

다음 방법을 통해 일관성을 유지할 수 있습니다:

하나의 branch를 주 repository로 정의하여 truth의 원천으로 사용합니다. 개발 및 운영 환경을 위한 별도의 __CAPGO_KEEP_0__ 채널을 사용합니다. CI/CD pipeline을 통해 버전 업로드를 자동화합니다.
명확하고 자세한 commit 메시지로 모든 Capgo 변경 사항을 문서화합니다.
큰 팀의 경우 다음 버전 관리 매트릭스를 업데이트를 조직하기 위해 도움이 될 수 있습니다:
모든 code 변경 사항을 명확하고 자세한 커밋 메시지로 문서화하십시오.

채널

Environment	자동 업데이트	버전 패턴	업데이트 패턴
개발	dev	비활성화	0.x.x
스테이징	beta	활성화	x.x.x-beta
운영	안정	활성화	x.x.x

업데이트 복구 단계

업데이트가 실패하는 경우, 다음 복구 단계를 따르십시오.

이전 안정 버전으로 롤백하십시오.
새로운 수정 사항에 대한 버전 번호를 증가시키십시오 (주의: 삭제된 버전 번호는 재사용할 수 없습니다) [2].
앱 시작 시 업데이트를 확인하여 예상대로 작동하는지 확인하십시오.

Capgo의 업데이터는 장애를 처리하기 위해 설계되었습니다. 예를 들어, 서버가 연결되지 않거나 업데이트가 삭제되는 경우 앱은 정상적으로 작동합니다. [3]또한, 실패한 네트워크 요청은 다음 앱 시작 시 자동으로 다시 시도됩니다. [3]이 내장된 내구성은 다운타임을 최소화하고 smoother한 운영을 보장합니다.

요약

Semantic Versioning과 Capgo의 combination은 Capacitor 앱의 OTA 업데이트를 더 효율적으로 만듭니다. 947.6 백만 업데이트가 전달되고 1,400 개의 생산 앱이 이 시스템을 사용함에 따라 배포 프로세스는 81% 더 효율적으로 진행됩니다. [1]이 설정은 개발자들이 업데이트를 빠르게하고 제어된 방식으로 푸시할 수 있으며 앱 스토어 지연을 피할 수 있습니다. [1]업데이트 복구 단계

개발자들은 이렇게 말하고 있습니다:

“우리는 +5000 명의 사용자 기반에서 프로덕션에서 OTA 업데이트를 배포했습니다. OTA가 @__CAPGO_KEEP_0__에 배포된 후 몇 분 안에 거의 모든 사용자가 업데이트가 된 것을 볼 수 있습니다.” - colenso Capgo OTA 업데이트를 MAJOR.MINOR.PATCH 버전 시스템은 깨진 변경 사항, 새로운 기능 및 버그 수정을 쉽게 전달할 수 있게 해줍니다. 특히 Capgo 플랫폼을 통해 주당 여러 개의 릴리스를 관리하는 팀에게는 특히 도움이 됩니다. [1]

__CAPGO_KEEP_0__의 [5]. This is especially helpful for teams managing several releases each week through Capgo’s platform.

Capgo’s . 사용자에게 업데이트를 전달하는 올바른 시간에 올바른 채널을 사용할 수 있습니다.“우리는 애그일 개발을 실천하고 @__CAPGO_KEEP_0__은 사용자에게 지속적으로 제공하는 mission-critical입니다!” - Rodrigo Mantica [1]How to Use Semantic Versioning with __CAPGO_KEEP_0__ OTA Updates로 계속 진행하세요

Capgo [1]

Capgo

Capgo를 사용 중이라면 Capgo OTA 업데이트와 Capgo 버전 관리 방법 버전 관리와 롤백을 계획하고 연결하려면 롤백 롤백의 구현 세부 사항 버전 목표 버전 목표의 구현 세부 사항 업데이트 동작 업데이트 동작의 구현 세부 사항 번들 번들의 구현 세부 사항 Capgo 실시간 업데이트 for the product workflow in Capgo Live Updates.

Capgo의 Capgo OTA 업데이트를 사용하는 방법