Semantic Versioning을 사용하는 방법: Capgo __CAPGO_KEEP_2_

앱 업데이트를 간소화하고 싶다면 앱 업데이트를 간소화하고 싶다면 __CAPGO_KEEP_0__ Semantic Versioning (SemVer) __CAPGO_KEEP_1__ Capgo’s Over-The-Air (OTA) 업데이트로 앱 관리가 더 쉽고 빠르다. 그 방법은 다음과 같다. Capacitor 버전은 다음 형식으로 사용된다.

MAJOR: 주 버전은 MAJOR.MINOR.PATCH:
- For breaking changes. MINOR:
- 소 버전은 __CAPGO_KEEP_0__의 새로운 기능이 뒤로 호환됩니다.
- PATCH: __CAPGO_KEEP_0__의 버그 수정.
Capgo를 사용하는 이유는 무엇인가요?
- 업데이트에 대한 명확한 통신.
- 버전 관리가 더 똑똑해집니다.
- 의존성 충돌을 피합니다.
- 릴리즈 계획이 정리가 됩니다.
Capgo 설정 단계:
1. Capgo 업데이터 플러그인을 설치합니다.
2. 앱의 버전을 구성합니다. capacitor.config.json and other files.
3. API 키로 초기화하세요.
4. __CAPGO_KEEP_0__ __CAPGO_KEEP_1__을 사용하여 업데이트를 패키지하고 업로드하세요. Capgo CLI 테스트 중인 경우 “beta” 채널, 안정적인 릴리즈인 경우 “production” 채널을 별도로 사용하세요.
주간 변경 사항에 대한 자동 업데이트를 제어하고 주요 변경 사항에 대한 수동 승인 정책을 설정하세요.:
- 업데이트 실패 시 롤백 옵션을 제공하세요.
- 배포 프로세스:
- 버전 번호는 SemVer 규칙에 따라 업데이트하세요.
배포하기 전에 철저히 테스트하세요.
- __CAPGO_KEEP_0__ __CAPGO_KEEP_1__을 사용하여 업데이트를 패키지하고 업로드하세요.
- __CAPGO_KEEP_0__ 키로 초기화하세요.
- CLI 명령어를 사용하여 업데이트를 업로드하고 배포하세요.

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

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

Semantic Versioning | Level Up

Capgo 설정 가이드

Capgo Live Update Dashboard 인터페이스

업데이트 관리 및 버전 관리를 쉽게 하기 위해 Capgo를 설정하는 방법입니다.

초기 설정 단계

업데이트를 시작하기 위해 __CAPGO_KEEP_0__를 설치하세요. Capgo updater plugin:

npm install @capgo/capacitor-updater  
npx cap sync

__CAPGO_KEEP_0__을 사용하는 것을 확인하세요. capacitor.config.json __CAPGO_KEEP_0__ 파일은 semantic version 형식으로 사용해야 합니다.:

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

이전 프로젝트의 경우, 다음 위치에서 버전 정보를 업데이트하세요:

package.json __CAPGO_KEEP_0__ field를 찾으세요. version __CAPGO_KEEP_0__를 업데이트하세요.
android/app/build.gradle __CAPGO_KEEP_0__를 업데이트하세요. versionName)
ios/App/App.xcodeproj/project.pbxproj __CAPGO_KEEP_0__를 초기화한 후, __CAPGO_KEEP_1__ 키와 함께 __CAPGO_KEEP_0__을 초기화하세요: CURRENT_PROJECT_VERSION)

Once configured, initialize Capgo with your API key:

npx @capgo/cli@latest init YOUR_API_KEY

설정 단계

키 동작	__CAPGO_KEEP_1__	인증 단계
설치	플러그인을 설치하고 동기화	확인 `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 배포 및 버전 관리를 위한 앱이 준비가 된 것을 보장합니다.

Capgo

버전 관리

Capgo는 SemVer를 사용하여 앱 버전을 관리하며, 다음과 같은 형식으로 구성됩니다. MAJOR.MINOR.PATCH다음과 같이 작동합니다:

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

버전 종류	인크멘트할 때	자동 업데이트 동작
주 버전 (X.0.0)	호환성에 영향을 주지 않는 API 변경 사항을 위한	수동 승인 필요
소 버전 (1.X.0)	새로운 기능을 위한	Capgo에서 구성 가능
패치 버전 (1.0.X)	버그 수정을 위한	__CAPGO_KEEP_0__

자동화가 보통인 경우

버전 관리를 단순화하고 업데이트가 smoother 하도록 하려면 SemVer 규칙을 따르세요.

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

채널 기반 버전 관리배포 프로세스를 조직하려면 테스트 및 프로덕션과 같은 다양한 단계에 대한 별도의 채널을 생성하세요.
- 예를 들어:
- 테스트 환경에서 새로운 기능을 테스트하기 위해 “beta” 채널 (예: 1.2.0-beta)을 사용하세요.
- 안정적인 릴리스를 위해 “production” 채널 (예: 1.2.0)을 유지하세요.
플랫폼별 문제를 해결할 때 플랫폼별 채널 (예: “ios-hotfix” 버전 1.2.1)을 추가하세요.: Control how updates are applied using Capgo’s configuration options. For instance:
```
{
  "plugins": {
    "CapacitorUpdater": {
      "disableAutoUpdate": "minor"
    }
  }
}
```
__CAPGO_KEEP_0__의 구성 옵션을 사용하여 업데이트가 어떻게 적용되는지 제어하세요. 예를 들어:
버전 롤백 전략: 문제가 발생할 경우 이전 버전으로 돌아가기 위해 명확한 롤백 옵션을 유지하기 위해 prerelease 식별자를 사용하십시오. 이 방법은 모든 채널에서 버전 관리를 일관되게 유지하면서 이전 버전으로 돌아가기 위해 문제가 발생할 경우 revert할 수 있도록 합니다.

이러한 베스트 프랙티스는 업데이트를 관리하는 데 더 쉽게 업데이트를 테스트하고 앱의 배포 프로세스에서 안정성을 유지하는 데 도움이 됩니다.

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.

다음으로, 업데이트 전략을 결정하세요. 업데이트 전략을 선택하세요.자동 업데이트

: 자동으로 최소 버전 요구 사항을 강제합니다.Auto-Update
__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 업데이트령령업데이트를 위해 정확한 버전 요구 사항을 지정하십시오.
채널 기반채널을 사용하여 테스트 및 스테이지 롤아웃을 수행하십시오.

Capgo CLI 업데이트령령

Use Capgo’s CLI to deploy your update with ease. Here’s how:

# 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는 @AppFlow와 달리 모든 돈을 위해热code 푸시를하는 지혜로운 방법입니다 🙂”

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

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

기업급 배포에 대해서는 CI/CD 자동화 통합을 고려해 보세요.

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

문제 해결 및 팁

버전 관리 문제

Capgo에서 의미론적 버전 관리를 관리하는 것은 업데이트를 배포하는 것을 복잡하게 할 수 있습니다. 개발 작업을 덮어쓰지 않도록 하려면, 다음을 설정하세요. capacitor.config.json 파일:

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

업데이트가 실패한 경우, 다음을 할 수 있습니다.

설정 autoUpdate 개발 중인 경우 false 앱을 제거합니다.
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__을 수정된 버전으로 다시 설치하세요.
__CAPGO_KEEP_0__ 자동 업데이트 기능을 다시 활성화하면 모든 것이 안정화된 후에.

Capacitor의 주요 버전 업데이트를 위해 disableAutoUpdateBreaking flag과 연결하고 flag을 위한 이벤트를 기다립니다. majorAvailable 업데이트를 적절하게 처리하기 위한 이벤트

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

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

팀 버전 관리

업데이트가 관리되는 개인 단위가 되면 팀은 강력한 버전 관리 관행을establish해야 합니다.

변경 사항을 하나씩 테스트하고 메인 저장소에 병합하기 전에 안정성을 강화하고 비용이 많이 드는 오류를 피할 수 있습니다. [4]

일관성을 유지하기 위한 방법은 다음과 같습니다.

__CAPGO_KEEP_0__을 하나로 정의합니다. main repository __CAPGO_KEEP_0__을 참조 소스로 사용합니다.
개발 및 운영 환경을 위한 별도의 Capgo 채널을 사용하세요.
CI/CD PIPELINE을 통해 버전 업로드를 자동화하세요.
code 변경 사항을 명확하고 자세한 커밋 메시지와 함께 문서화하세요.

대형 팀의 경우 다음 버전 관리 매트릭스를 업데이트를 조직하는 데 도움이 될 수 있습니다.

환경	채널	자동 업데이트	버전 패턴
개발	dev	비활성화	0.x.x
테스트	베타	활성화	x.x.x-베타
운영	안정	활성화	x.x.x

업데이트 복구 단계

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__
__CAPGO_KEEP_0__의 버전 번호를 새로 고친 경우 (주의: 삭제된 후 버전 번호는 재사용할 수 없습니다) [2].
__CAPGO_KEEP_0__의 업데이트를 앱 시작 시 확인하여 예상대로 작동하는지 확인합니다.

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

요약

Semantic Versioning과 Capgo를 결합하여 Capacitor 앱의 OTA 업데이트가 더 효율적이게 되었습니다. 947.6 만 개의 업데이트가 전달되었으며 1,400 개의 생산 앱이 이 시스템을 사용하여 [1]배포 프로세스는 81% 더 효율적으로 작동합니다. [1]이 설정은 개발자들이 업데이트를 빠르게하고 제어된 방식으로 푸시할 수 있으며 앱 스토어의 지연을 피할 수 있습니다.

개발자들이 말하는 것처럼요.

“__CAPGO_KEEP_0__ OTA 업데이트를 출시했습니다. Capgo OTA 업데이트를 출시했습니다. +5000명의 사용자 기반에서 운영 중입니다. 거의 모든 사용자가 @Capgo에 배포된 OTA가 몇 분 안에 업데이트되었습니다. - colenso [1]

MAJOR.MINOR.PATCH 버전 시스템은 쉽게 깨진 변경 사항, 새로운 기능 및 버그 수정을 전달할 수 있습니다. [5]이것은 특히 Capgo 플랫폼을 통해 매주 여러 릴리스를 관리하는 팀에게 특히 유용합니다.

Capgo의 암호화 된 솔루션, CI/CD 도구와 통합되어 예산에 적합합니다 - 5년 동안 $26,100을 절약합니다. [1]업데이트가 올바른 사용자에게 올바른 시간에 도달하도록 사용자 지정 채널을 보장합니다.

“우리는 애그일 개발을 실천하고 @Capgo은 사용자에게 지속적으로 제공하는 mission-critical입니다!” - Rodrigo Mantica [1]

Capgo OTA 업데이트와 함께 Semantic Versioning을 사용하는 방법을 계속 진행하세요.

__CAPGO_KEEP_0__ OTA 업데이트와 함께 Semantic Versioning을 사용하는 방법을 사용하는 경우 Capgo OTA 업데이트와 함께 Semantic Versioning을 사용하는 방법을 사용하는 경우 버전 제어 및 롤백 계획을 위해 연결하세요. 롤백 롤백 구현 세부 사항에 대해 버전 목표 버전 목표 구현 세부 사항에 대해 업데이트 동작 업데이트 동작 구현 세부 사항에 대해 번들 번들 구현 세부 사항에 대해, 그리고 Capgo Live Updates Capgo Live Updates 제품 워크플로에 대해.

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