더 빠른 앱 업데이트를 앱 스토어 지연 없이? Capgo 사용자에게 안전한 OTA(Over-the-Air) 업데이트를 즉시 배포할 수 있습니다. 앱 스토어 리뷰를 건너뛰고 앱을 손쉽게 최신 상태로 유지하세요.
핵심 요약:
- Capgo란 무엇인가요? 앱의 라이브 업데이트를 위한 Capacitor 오픈 소스 플랫폼입니다.
- 왜 OTA 업데이트를 사용할까요? 시간을 절약하고, 사용자 경험을 개선하며, 버그를 빠르게 수정하세요.
- 시작하는 방법은?
- 먼저 Capgo 플러그인을 설치하세요.:
npm install @capgo/capacitor-updater - API 키로 앱을 설정하세요.
- “production” 또는 “beta” 같은 채널로 타겟 롤아웃을 진행하세요.
- 먼저 Capgo 플러그인을 설치하세요.:
- 고급 기능: 종단 간 암호화, 오류 처리, CI/CD 통합.
Capgo 문서(capgo.app/docs)는 설정, 보안, 문제 해결에 대한 단계별 지침을 제공합니다. 설치부터 고급 설정까지, 원활한 업데이트를 위한 핵심 가이드입니다.
Capgo, Live update용 CapacitorJs 플러그인

Capgo 문서 사용
OTA 업데이트를 다룰 때 문서 탐색은 필수입니다. Capgo 문서는 Capacitor 앱에 Live Update를 통합하는 방법에 대해 상세한 가이드를 제공합니다.
문서 위치
Capgo 문서는 다음 주소에서 접근할 수 있습니다: capgo.app/docs [1]. 용도별로 섹션이 정리되어 있습니다:
| 섹션 | 목적 | 주요 주제 |
|---|---|---|
| 시작하기 | 초기 설정 | 설치 단계, API 키 설정 |
| 설정 | 핵심 설정 | 플러그인 구성, 환경 설정 |
| API 레퍼런스 | 기술 세부 정보 | 메서드, 매개변수, 반환값 |
| 보안 | 보호 조치 | 암호화 설정, 서명 검증 |
| 문제 해결 | 문제 해결 | 자주 발생하는 문제, 진단 도구 |
주요 용어 및 개념
다음은 자주 접하게 되는 주요 용어입니다:
- 채널: 버전 배포를 제어하는 데 사용되는 업데이트 스트림입니다. 예를 들어, 다양한 사용자 그룹을 대상으로 “production”, “beta”, “staging” 채널을 설정할 수 있습니다 [4].
- 업데이트 정책: 업데이트가 전달되고 적용되는 방식을 정의합니다. 옵션에는 자동 다운로드, 설치 시점, 사용자 프롬프트가 포함됩니다 [1].
- 앱 상태 리스너: 앱이 포그라운드에 있는지 백그라운드에 있는지 추적하는 컴포넌트입니다 [4].
- 번들: 앱의 새 버전이 담긴 패키징된 업데이트 파일로, 에셋, code 변경 사항, 구성 업데이트를 포함합니다 [4].
Code 예제 및 튜토리얼
문서에서는 통합을 간소화할 수 있도록 샘플 code를 제공합니다. 다음은 TypeScript/JavaScript를 사용한 기본 예제입니다:
import { CapacitorUpdater } from '@capgo/capacitor-updater'
// Initialize the updater
await CapacitorUpdater.notifyAppReady()
더 고급스러운 사용 사례를 위해 문서에는 실제 환경 예제가 포함되어 있습니다 [2][3], 예:
- A/B 테스트를 위한 채널 전환
- 사용자 프롬프트를 활용한 커스텀 업데이트 플로우
- 오류 처리 및 롤백 구현
- CI/CD 파이프라인과 업데이트 통합
각 튜토리얼은 성능 고려 사항과 보안 측면을 강조하여 현명한 의사결정을 돕습니다. 문서는 최신 기능과 모범 사례를 포함하도록 자주 업데이트됩니다 [1].
구현 세부 사항은 다음 설정 가이드를 확인하세요.
OTA 업데이트 설정
Capgo에서 OTA 업데이트를 설정하여 배포 프로세스를 간소화하세요. 다음 단계와 팁을 따라 문제 없는 구성을 진행하세요.
기본 설정 단계
Capacitor 프로젝트에 Capgo 플러그인을 설치하는 것으로 시작하세요:
npm install @capgo/capacitor-updater
npx cap sync
다음으로, capacitor.config.json 파일을 다음으로 업데이트하세요 Capgo API 키:
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": true,
"apiKey": "YOUR_API_KEY_HERE"
}
}
}
그다음, 앱의 메인 파일에서 업데이트를 감지하도록 업데이터를 초기화하세요:
import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.notifyAppReady();
이 작업이 끝나면 채널을 설정해 다양한 업데이트 스트림을 관리할 수 있습니다.
업데이트 채널 설정
다음 업데이트 채널 을(를) 배포 요구사항에 맞게 구성하세요:
| 채널 유형 | 목적 | 사용 사례 |
|---|---|---|
| 프로덕션 | 안정화 릴리스 | 일반 사용자 기반 |
| 무대 구성 | 릴리스 전 테스트 | QA 팀 및 베타 테스터 |
| 베타 | 기능 테스트 | 얼리 어답터 |
특정 채널에 업데이트를 업로드하려면 다음을 사용하세요. Capgo CLI:
npx @capgo/cli upload -c production
업데이트 방식
Capgo는 업데이트를 처리하는 두 가지 주요 방법을 제공합니다:
자동 업데이트
자동 업데이트를 활성화하려면 다음을 설정하세요 autoUpdate: true 설정에 포함하세요. 이렇게 하면 개발자가 따로 신경 쓰지 않아도 업데이트가 백그라운드에서 적용됩니다.
수동 업데이트 더 세밀한 제어가 필요하다면 업데이트를 수동으로 관리할 수 있습니다. 다음 패턴으로 업데이트를 확인하고 적용하세요:
// Check for updates
const update = await CapacitorUpdater.download();
// Install when ready
if (update) {
await CapacitorUpdater.set(update);
}
중요한 업데이트라면 진행 전에 사용자에게 확인을 요청할 수 있습니다:
if (update.version > currentVersion) {
const userConsent = await showUpdatePrompt();
if (userConsent) {
await CapacitorUpdater.set(update);
}
}
커스텀 ID와 채널로 특정 사용자 그룹을 대상으로 지정할 수도 있습니다:
await CapacitorUpdater.setCustomId('beta-tester-123');
await CapacitorUpdater.setChannel('beta');
마지막으로 에러 핸들링과 롤백 옵션을 꼭 포함하세요:
try {
await CapacitorUpdater.set(update);
} catch (error) {
await CapacitorUpdater.reset(); // Revert to the last working version
console.error('Update failed:', error);
}
이 단계를 마치면 OTA 업데이트 시스템이 준비됩니다. 고급 설정에서 업데이트 프로세스를 더 원하는 대로 커스터마이즈해 보세요.
sbb-itb-f9944d2
고급 설정
더 나은 Capgo OTA 업데이트 보안 조치와 유연한 업데이트 구성을 더해 설정을 개선해 보세요. 이 옵션들은 App Store 가이드라인을 지키면서 안전하고 매끄러운 업데이트 경험을 보장합니다.
보안 기능
Capgo는 업데이트 번들을 보호하고 사용자에게 안전하게 전달하기 위해 강력한 보안 프로토콜을 제공합니다. 이 플랫폼은 모든 업데이트에 공개 키 암호화를 적용한 종단 간 암호화를 사용합니다 [1]. 주요 보안 기능을 활성화하는 방법은 다음과 같습니다:
// Enable bundle verification
await CapacitorUpdater.setVerifyBundles(true);
// Configure encryption settings
await CapacitorUpdater.configure({
encryption: {
enabled: true,
failOnError: true
}
});
번들 보호 시스템의 주요 구성 요소는 다음과 같습니다:
| 보안 기능 | 설명 | 구현 방법 |
|---|---|---|
| 번들 무결성 | 암호화 서명으로 패키지 진위 여부 확인 | setVerifyBundles()로 자동 활성화 |
| 롤백 보호 | 업데이트 실패 시 안정적인 버전으로 롤백 | 업데이트 프로세스에 내장됨 |
| 접근 제어 | 역할 기반 권한으로 업데이트 관리 | 대시보드에서 설정 |
업데이트 동작 설정
이벤트 리스너와 설정 옵션을 사용하여 업데이트 배포 및 설치 방식을 사용자 정의할 수 있습니다. 이 설정으로 업데이트의 타이밍과 사용자 상호작용을 조정하세요:
// Listen for when an update is available
CapacitorUpdater.addListener('updateAvailable', async (info) => {
if (info.version > currentVersion) {
// Custom update logic based on app state
const isAppInactive = await checkAppState();
if (isAppInactive) {
await CapacitorUpdater.download();
}
}
});
// Monitor download completion
CapacitorUpdater.addListener('downloadComplete', (info) => {
console.log(`Update ${info.version} ready to install`);
// Implement custom installation timing if desired
});
단계적 롤아웃을 위해 대시보드 또는 code를 통해 업데이트 배포를 직접 설정할 수 있습니다:
// Set custom update conditions for a gradual rollout
await CapacitorUpdater.configure({
rollout: {
percentage: 25, // Start with 25% of users
timeInterval: 24 // Increase rollout percentage every 24 hours
}
});
특정 버전 관련 동작을 처리하려면:
// Handle version-specific update failures
CapacitorUpdater.addListener('updateFailed', async (info) => {
if (info.error.code === 'VERSION_MISMATCH') {
await CapacitorUpdater.reset(); // Revert to the last stable version
// Optionally, handle error notification here
}
});
이 설정은 업데이트의 신뢰성을 보장하는 동시에 앱의 필요에 맞게 프로세스를 조정할 수 있게 합니다. 프로덕션에 롤아웃하기 전에 항상 Capgo의 스테이징 환경에서 업데이트를 철저히 테스트하세요. [2].
문제 해결 가이드
Capgo의 에러 로그와 내장 도구는 스토어 요구사항을 준수하면서 OTA 업데이트 문제를 해결하는 데 도움을 줍니다.
주요 문제 및 해결 방법
다음은 일반적인 문제와 해결 방법입니다:
-
다운로드 실패 증상: 다운로드가 멈추거나 완료되지 않습니다. 솔루션: 네트워크 연결을 확인하고, 업데이트 URL이 유효한지 점검하며, 중단 상황을 처리하기 위해 재시도 메커니즘을 추가하세요.
-
버전 충돌 증상: 업데이트가 설치되지 않거나 앱 불안정을 유발합니다. 솔루션: 충돌을 방지하기 위해 명확한 버전 번호를 사용하고, 안전을 위해 롤백 옵션을 구현하세요.
-
설치 오류 증상: 업데이트가 실패하거나 자동 롤백이 발생합니다. 솔루션: 롤백을 방지하려면 업데이트 성공 후
notifyAppReady()를 반드시 호출해야 합니다.
50MB가 넘는 업데이트는 더 작은 파일로 나누면 Android 기기에서 성능을 개선할 수 있습니다. [5].
문제를 조기에 발견하려면 상세한 에러 로깅을 사용하세요. 예를 들어, 다음 리스너를 구현하세요:
CapacitorUpdater.addListener('updateFailed', (error) => {
console.log(`Update failed: ${error.code}`);
logUpdateError({
errorCode: error.code,
deviceInfo: error.device,
timestamp: new Date().toISOString()
});
});
에러 로깅과 사전 점검을 결합하면 컴플라이언스에 집중하기 전에 이러한 문제를 효과적으로 해결할 수 있습니다.
App Store 규정
기술적 수정만으로는 부족합니다. 업데이트도 앱 스토어 가이드라인에 맞아야 합니다.
Apple App Store 요구 사항:
- 사용자 투명성: 업데이트 내용을 사용자에게 명확히 알리고 동의를 받으세요.
- 핵심 기능: 앱의 주요 기능이 검토된 대로 그대로 유지되는지 확인하세요.
- 보안 조치: 업데이트 전송에는 안전한 방법을 사용하세요.
Android 구현:
await CapacitorUpdater.configure({
updateNotification: {
title: "Update Available",
message: "A new version is available. Please update to access the latest features.",
requireUserConsent: true
}
});
모범 사례:
- 버전 관리: 충돌을 줄이기 위해 업데이트를 점진적으로 배포하세요.
- 업데이트 알림: 명확하고 사용자 친화적인 업데이트 알림을 제공하세요.
- 보안: 번들 무결성을 검증하고 암호화를 사용해 데이터를 보호합니다.
요약
이 섹션은 가이드의 핵심 내용을 정리합니다.
Capgo의 문서는 앱 스토어 규정을 준수하면서 Capacitor 앱에 OTA 업데이트를 통합하는 명확한 지침을 제공합니다.
Capgo의 리소스를 사용하면 개발자는 다음과 같은 핵심 기능을 구현할 수 있습니다. 종단간 암호화(end-to-end encryption) 및 CI/CD 통합, 초기 설정부터 고급 구성까지 모든 것을 다룹니다. [1].
주요 구현 영역
| 항목 | 주요 초점 | 찾는 위치 |
|---|---|---|
| 보안 | 암호화 및 무결성 검사 | 보안 기능 섹션을 찾으세요 |
| 컴플라이언스 | Apple 및 Android 요구사항 준수 | App Store 규정 가이드 |
| 업데이트 관리 | 버전 관리 및 롤백 옵션 | 업데이트 방식 가이드 |
| 에러 핸들링 | 로그 및 문제 해결 단계 | 문제 해결 가이드 |
이 영역들은 Capgo 업데이트 관리 시스템의 핵심을 이룹니다.
Capgo의 CLI 및 분석 도구가 업데이트 관리를 앱의 전체 라이프사이클에 걸쳐 단순화합니다 [1].
추가 지원이 필요하면 다음과 같은 리소스를 참고할 수 있습니다 API 문서, 샘플 프로젝트, 그리고 커뮤니티 포럼 [2].
OTA 업데이트를 위한 Capgo 문서 사용법부터 계속 읽기
사용 중이라면 OTA 업데이트를 위한 Capgo 문서 사용법 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner 제품 워크플로우: Capgo 보안 Capgo Security 제품 워크플로우 및 Capgo 신뢰 센터 Capgo Trust Center 제품 워크플로우: