본문으로 이동
Capgo 로고
개발 모바일 업데이트

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

Capacitor 앱의 업데이트와 버전 관리를 간소화하는 Capgo의 OTA 업데이트 방법을 알아보세요.

마틴 도나디유

마틴 도나디유

마케팅 담당자
Semantic Versioning을 사용하여 Capgo OTA 업데이트와 함께하는 방법

__CAPGO_KEEP_0__ 업데이트와 버전 관리를 단순화하고 싶다면? __CAPGO_KEEP_0__ 앱 업데이트와 버전 관리 Semantic Versioning (SemVer) __CAPGO_KEEP_0__의 Over-The-Air (OTA) 업데이트와 함께하는 Semantic Versioning __CAPGO_KEEP_0__의 OTA 업데이트와 Semantic Versioning을 사용하면 __CAPGO_KEEP_0__ 앱 관리가 더 쉬워지고 빠르다. 이 방법을 알아보자. Capgo__CAPGO_KEEP_0__ Capacitor __CAPGO_KEEP_0__

  • __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ 버전은 다음 형식으로 사용됩니다. MAJOR.MINOR.PATCH:

    • MAJOR: __CAPGO_KEEP_0__에서 중요한 변경 사항이 있을 때 사용합니다.
    • MINOR: __CAPGO_KEEP_0__에서 새로운 기능이 뒤따르는 경우 사용합니다.
    • PATCH: __CAPGO_KEEP_0__에서 버그를 수정할 때 사용합니다.

  • Capgo에서 SemVer를 사용하는 이유는 무엇입니까?

    • 업데이트에 대한 명확한 의사소통.
    • 버전 관리를 더 똑똑하게 하기 위해.
    • 의존성 충돌을 피하기 위해.
    • 릴리즈 계획을 조직하기 위해.

  • Capgo 설정 Steps:

    1. Capgo 업데이터 플러그인을 설치합니다.
    2. 앱의 버전을 capacitor.config.json 및 다른 파일에서 설정합니다.
    3. API 키로 초기화합니다.
    4. __CAPGO_KEEP_0__ __CAPGO_KEEP_1__을 사용하여 업데이트를 패키지하고 업로드합니다. Capgo CLI 테스트(예: 'beta')와 안정적인 릴리스('production')를 위한 별도의 채널을 사용합니다.

  • 패치 자동 업데이트와 주요 변경 사항에 대한 수동 승인 정책을 관리합니다.:

    • __CAPGO_KEEP_1__
    • __CAPGO_KEEP_0__
    • 업데이트 실패 시 롤백 옵션.

  • 배포 프로세스:

    • SemVer 규칙에 따라 업데이트된 버전 번호를 설정합니다.
    • 배포하기 전에 철저히 테스트합니다.
    • CLI 명령을 사용하여 업데이트를 업로드하고 배포합니다.

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

빠른 팁: 업데이트를 항상 테스트하고 채널을 사용하여 단계별 배포를 효과적으로 관리합니다.

Semantic Versioning | Level Up

Capgo 설정 가이드

Capgo Live Update Dashboard Interface

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

초기 설정 단계

__CAPGO_KEEP_0__ 업데이트러 플러그인을 설치하기 시작하세요. Capgo 플러그인이 설치된 것을 확인하세요.:

npm install @capgo/capacitor-updater  
npx cap sync

파일이 의미론적 버전 형식으로 사용되는지 확인하세요. capacitor.config.json 이전 프로젝트의 경우, 다음 위치에서 버전 상세 정보를 업데이트하세요.

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

(버전 정보를 찾으세요.)

  • package.json (업데이트 version (업데이트
  • android/app/build.gradle (업데이트 versionName)
  • ios/App/App.xcodeproj/project.pbxproj __CAPGO_KEEP_0__ CURRENT_PROJECT_VERSION)

Capgo를 설정한 후, API 키와 함께 Capgo를 초기화하세요.

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

이 설정은 앱이 OTA 배포 및 버전 관리를 위한 smooth한 준비가 된 상태로 유지되도록 합니다.

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

Semantic Versioning을 사용하는 __CAPGO_KEEP_0__

Using Semantic Versioning with Capgo

__CAPGO_KEEP_0__은 Semantic Versioning (SemVer) 방식을 사용하여 앱 버전을 관리하며, 형식은 다음과 같습니다:

Capgo uses Semantic Versioning (SemVer) to manage app versions, formatted as 다음과 같이 작동합니다:주 버전 (X.0.0)

  • 주 버전 (X.0.0): __CAPGO_KEEP_0__ 버전을 변경하는 변경 사항이 호환성을 깨뜨릴 경우 MAJOR 숫자를 증가시킵니다.
  • 소수 버전 (1.X.0): 호환성을 유지하는 새로운 기능을 위해 MINOR 숫자를 증가시킵니다.
  • 수정 버전 (1.0.X): 호환성을 유지하지 않는 버그 수정을 위해 PATCH 숫자를 증가시킵니다.
버전 종류버전 증가 시점자동 업데이트 동작
주 버전 (X.0.0)호환성을 깨뜨리는 API 변경 사항을 위해수동 승인 필요
소수 버전 (1.X.0)새로운 기능을 위한Capgo에서 설정할 수 있습니다.
Patch (1.0.X)버그 수정을 위한일반적으로 자동입니다.

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

버전 관리 지침

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

  • 채널 기반 버전 관리: 배포 프로세스를 조직하기 위해 테스트 및 프로덕션에 대한 별도의 채널을 생성하세요. 예를 들어:

    • : 테스트 중인 새로운 기능을 위한 “beta” 채널 (예: 1.2.0-beta)을 사용하세요.
    • 안정적인 릴리스를 위한 “프로덕션” 채널 (예: 1.2.0)을 유지하세요.
    • 플랫폼에 특정한 채널 (예: 버전 1.2.1의 “ios-hotfix”)을 추가하여 플랫폼에 특정한 이슈를 해결합니다.

  • 정책 구성 업데이트: 업데이트가 적용되는 방법을 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 업데이트 명령

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 [channelId] [appId]

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

“Capgo는 @AppFlow와 달리 모든 돈을 위해热code 푸시를하는 지혜로운 방법입니다 🙂”

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

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

기업급 배포에 대한 경우 CI/CD 자동화 통합을 고려할 수 있습니다.

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!”

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

문제 해결 및 팁

Managing semantic versioning in Capgo can sometimes complicate update deployments. To avoid overwriting your development work, configure the following in your capacitor.config.json __CAPGO_KEEP_0__에서 의미론적 버전 관리를 관리하는 경우 업데이트 배포가 복잡해질 수 있습니다. 개발 작업을 덮어쓰지 않도록 하기 위해 파일에 다음을 구성하세요:

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

파일: __CAPGO_KEEP_0__에서 업데이트 실패 시 다음을 수행할 수 있습니다:

  • 설정 autoUpdate __CAPGO_KEEP_0__ false 개발 중에 설정합니다.
  • 앱을 제거합니다.
  • 수정된 버전으로 다시 설치합니다.
  • 모든 것이 안정되면 자동 업데이트를 다시 활성화합니다.

주요 버전 업데이트의 경우 disableAutoUpdateBreaking flag를 사용하고 majorAvailable event를 듣고 업데이트를 처리하세요.

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

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

팀 버전 관리

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

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

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

  • 하나의 branch를 메인 저장소로 정의하여 참조 소스로 사용합니다. 개발 및 운영 환경을 위한 별도의 __CAPGO_KEEP_0__ 채널을 사용합니다. CI/CD pipeline을 통해 버전 업로드를 자동화합니다.
  • 명확하고 자세한 커밋 메시지를 사용하여 모든 Capgo 변경 사항을 문서화합니다.
  • 대형 팀의 경우 다음 버전 관리 매트릭스를 사용하여 업데이트를 조직할 수 있습니다.
  • Document all code changes with clear and detailed commit messages.

채널

자동 업데이트CI/CD pipeline을 통해 버전 업로드를 자동화합니다.명확하고 자세한 커밋 메시지를 사용하여 모든 변경 사항을 문서화합니다.버전 패턴
개발dev비활성화0.x.x
스테이징beta활성화x.x.x-beta
프로덕션stable활성화__CAPGO_KEEP_0__

업데이트 복구 단계

주의에도 불구하고 업데이트가 실패할 수 있습니다. 그럴 경우, 다음 복구 단계를 따르세요:

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

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

요약

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

개발자들이 말하는 것:

“We rolled out Capgo OTA 업데이트를 프로덕션에서 +5000 명의 사용자 기반에 대해 출시했습니다. 거의 모든 사용자가 업데이트가 배포된 후 @Capgo에서 몇 분 안에 업데이트가 된 것을 볼 수 있습니다. - colenso [1]

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

Capgo의 암호화 된 솔루션, CI/CD 도구와 통합되어 예산적으로도 비용을 절약할 수 있습니다 - 5년 동안 $26,100을 절약할 수 있습니다. [1]. 사용자에게 필요한 때에 업데이트를 전달할 수 있는 사용자 지정 채널을 보장합니다.

“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” - Rodrigo Mantica [1]

How to Use Semantic Versioning with Capgo OTA Updates

만약 __CAPGO_KEEP_0__ OTA Updates를 사용 중이라면 Semantic Versioning with Capgo OTA Updates 사용 방법 __CAPGO_KEEP_0__ OTA Updates와 함께 롤백 롤백에 대한 구현 세부 정보 버전 목표 버전 목표에 대한 구현 세부 정보 업데이트 동작 업데이트 동작에 대한 구현 세부 정보 번들 번들에 대한 구현 세부 정보 Capgo Live Updates Capgo Live Updates를 위한 제품 워크플로우

실시간 업데이트 Capacitor 앱에

웹-layer 버그가 실시간으로 존재할 때, 앱 스토어 승인 대기 없이 Capgo를 통해 패치를 배포하세요. 사용자는 배경에서 업데이트를 받으며, 네이티브 변경 사항은 일반적인 리뷰 경로를 유지합니다.

시작하기

블로그에서 최신 뉴스

Capgo는 전문적인 모바일 앱을 만들기 위해 필요한 최고의洞察력을 제공합니다.

Capacitor 앱에서 2-Way 통신
개발, 모바일, 업데이트
2025년 4월 26일

Capacitor 앱에서 2-Way 통신

OTA 업데이트 실수를 피하는 5가지 일반적인 실수
개발, 보안, 업데이트
2025년 4월 13일

OTA 업데이트 실수를 피하는 5 가지 일반적인 방법

모바일 앱 라이브 업데이트에 대한 5 가지 보안最佳 관행
개발, 모바일, 업데이트
2025년 1월 14일

모바일 앱 라이브 업데이트에 대한 5 가지 보안最佳 관행

블로그에서 모두 보기