기능

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

이 페이지는 Capgo Live Updates에서 사용할 수 있는 모든 기능을 종합적으로 소개합니다. 각 기능에는 간단한 설명과 자세한 문서 링크가 포함되어 있습니다.

핵심 업데이트 시스템

Over-the-Air (OTA) 업데이트

앱 스토어 승인 없이 JavaScript, HTML, CSS 및 에셋 업데이트를 사용자에게 직접 배포하세요. 업데이트는 백그라운드에서 다운로드되며 다음 앱 재시작 시 적용됩니다.

주요 기능:

백그라운드 다운로드
자동 설치
사용자 흐름 방해 없음
크로스 플랫폼 지원 (iOS, Android, Electron)

업데이트 동작 방식 자세히 알아보기 →

Delta Updates (차분 업데이트)

버전 간 변경된 파일만 다운로드하여 대역폭 사용량을 최대 95%까지 줄이고 업데이트 속도를 높입니다.

주요 기능:

자동 파일 단위 diffing
Checksum 기반 검증
Delta 파일 비교
필요 시 전체 업데이트로 자동 전환

Delta 업데이트 자세히 알아보기 →

자동 롤백

업데이트 로드에 실패하거나 크래시가 발생하면, 시스템이 마지막으로 정상 작동했던 버전으로 자동 롤백합니다.

주요 기능:

크래시 감지
타임아웃 감지
자동 롤백
사용자 개입 불필요

롤백에 대해 자세히 알아보기 →

Checksum 검증 및 폴백

Checksum을 통해 번들 무결성을 검증하며, 손상이 감지되면 마지막으로 확인된 정상 버전으로 자동 폴백합니다.

주요 기능:

다운로드 시 Checksum 검증
데이터 손상 감지
마지막 정상 번들로 자동 폴백
수동 복구 도구 제공

Breaking 업데이트 감지

이전 native code 버전을 실행하는 기기에 호환되지 않는 업데이트가 적용되는 것을 방지합니다.

주요 기능:

Native 버전 호환성 체크
플러그인 의존성 검증
호환되지 않는 업데이트 자동 차단
명확한 에러 메시지 제공

버전 타겟팅에 대해 자세히 알아보기 →

배포 제어

채널 시스템

유연한 채널 설정으로 다양한 환경과 사용자 세그먼트 전반의 업데이트를 구성하고 관리하세요.

주요 기능:

무제한 커스텀 채널(production, staging, beta 등)
채널별 번들 할당
채널별 타겟팅 규칙
디바이스 자가 할당
디바이스별 채널 오버라이드

채널에 대해 자세히 알아보기 →

디바이스 타겟팅

단계적 롤아웃과 통제된 배포를 위해 특정 디바이스, 버전 또는 사용자 세그먼트를 타겟팅하세요.

주요 기능:

버전 기반 타겟팅
기기별 오버라이드
플랫폼 필터링 (iOS, Android, Electron)
커스텀 메타데이터 필터링
에뮬레이터/dev 빌드 차단

채널 정책

각 채널별 업데이트 배포 규칙 및 제한 사항을 설정합니다.

주요 기능:

자동 업데이트 비활성화
메이저 버전 업데이트 차단
에뮬레이터 업데이트 비활성화
개발 빌드에서 업데이트 비활성화
플랫폼별 정책 (iOS 전용, Android 전용, Electron 전용)

채널 정책 자세히 알아보기 →

개발자 도구

Bundle 미리보기

기기에 배포하기 전, 웹 대시보드에서 라이브 웹 환경으로 번들을 미리 확인하세요.

위치: Web Dashboard → App → Bundle → Preview 탭

실시간 디버깅

CLI를 통해 특정 기기의 업데이트 이벤트를 실시간으로 모니터링하며, 체크, 다운로드, 설치 및 에러 이벤트를 확인할 수 있습니다.

사용법:

npx @capgo/cli app debug [appId]

다음 항목 표시:

업데이트 확인
다운로드 진행률
설치 상태
에러 메시지
정책 차단

Bundle Delta 파일 뷰어

파일 목록, 체크섬, 메타데이터를 포함한 모든 bundle의 delta 파일을 검사하세요.

위치: Web Dashboard → App → Bundle → Delta files 탭

다음 항목 표시:

체크섬이 포함된 파일 목록
Bundle 메타데이터
Native 버전 호환성
Plugin 의존성

Native Plugin 의존성

각 bundle에 포함된 모든 native Capacitor plugin을 확인하여 버전별 의존성 변경 사항을 추적하세요.

위치: Web Dashboard → App → Bundle → Dependencies 탭

표시 항목:

플러그인 이름 및 버전
의존성 추가/제거 내역
호환성 경고

CLI 연동

자동 배포 및 CI/CD 통합을 위한 종합 CLI.

주요 명령어:

bundle upload - 새 bundle 업로드
bundle list - 모든 bundle 목록 조회
bundle delete - bundle 삭제
bundle cleanup - 오래된 bundle 정리
channel set - 채널 설정
app debug - 실시간 디버깅

CLI 전체 레퍼런스 보기 →

Bundle 암호화

AES-256 암호화를 통한 bundle 종단간 암호화로, 전송 중 및 저장 시 code를 보호합니다.

주요 기능:

RSA 키 쌍 생성
AES-256 bundle 암호화
Code 서명 검증
암호화 키 관리

암호화에 대해 자세히 알아보기 →

Bundle 정리 및 보관 정책

저장 공간 관리를 위해 보관 정책에 따라 오래된 bundle을 자동으로 정리합니다.

주요 기능:

보관 개수 설정 가능
CLI를 통한 자동 정리
예약된 정리 작업
저장 공간 사용량 추적

사용법:

npx @capgo/cli bundle cleanup --keep=10

분석 및 모니터링

업데이트 통계

사용자 전체의 업데이트 채택률, 성공률, 배포 진행 상황을 추적하세요.

제공되는 지표:

다운로드 성공률
설치 성공률
유형별 에러율
시간 경과에 따른 업데이트 채택률
버전별 분포

위치: 웹 대시보드 → 앱 → 통계

디바이스 로그

업데이트 확인부터 설치까지 전체 라이프사이클을 보여주는 기기별 이벤트 로그입니다.

이벤트 유형:

업데이트 확인
다운로드 시작/완료/실패
설치 시작/완료/실패
롤백 이벤트
정책 차단

위치:

웹 대시보드 → 앱 → 디바이스 → 로그
Web Dashboard → App → Logs (모든 기기)

로그에 대해 자세히 알아보기 →

Bundle 사용량 분석

활성 번들, 다운로드 횟수 및 스토리지 사용량에 대한 상세 분석 데이터를 제공합니다.

주요 지표:

번들별 활성 설치 수
다운로드 횟수
번들별 스토리지 사용량
대역폭 사용량

채널 통계

채널별 성능 및 채택 지표를 추적합니다.

지표:

채널별 디바이스 수
채널별 업데이트 성공률
배포 이력
채널별 에러율

위치: 웹 대시보드 → App → Channel → 통계

배포 내역

모든 bundle 배포, 채널 할당 및 설정 변경에 대한 전체 감사 추적(audit trail)을 제공합니다.

추적된 이벤트:

Bundle 업로드
Channel 할당
정책 변경
디바이스 오버라이드

위치: Web Dashboard → App → Channel → 기록

보안 및 컴플라이언스

종단 간 암호화

업계 표준 AES-256 암호화로 저장 및 전송 중인 bundle을 암호화합니다.

암호화에 대해 자세히 알아보기 →

Code 서명

암호화 서명으로 bundle의 무결성을 검증하고 변조를 방지합니다.

SOC 2 Type II 준수

엔터프라이즈 보안을 위해 SOC 2 Type II 표준에 따라 인증된 인프라와 프로세스.

App Store 규정 준수

Apple App Store 및 Google Play Store의 OTA 업데이트 정책을 완벽히 준수합니다.

규정 준수 자세히 보기 →

2FA 강제 적용 (조직 단위)

조직의 모든 구성원이 대시보드 및 API에 접근할 때 2단계 인증을 사용하도록 설정하세요.

위치: 웹 대시보드 → Organization → Security

2FA 자세히 알아보기 →

암호화된 번들 강제 적용

조직 수준에서 모든 bundle에 암호화를 적용하도록 설정합니다.

위치: 웹 대시보드 → Organization → Security

팀 협업

역할 기반 액세스 제어(RBAC)

조직 및 앱 단위의 세밀한 권한 제어 기능을 제공합니다.

조직 역할:

org_super_admin - 조직 전체 관리 권한
org_admin - 조직 관리 (결제/삭제 제외)
org_billing_admin - 결제 관리 전용 권한
org_member - 조직 읽기 전용 권한

앱 역할:

app_admin - 특정 앱 전체 관리 권한
app_developer - 번들 업로드 및 디바이스 관리
app_uploader - 번들 업로드 전용 권한
app_reader - 읽기 전용 권한

위치:

웹 대시보드 → 조직 → 멤버
웹 대시보드 → 앱 → 액세스

RBAC 자세히 알아보기 →

감사 로그

컴플라이언스와 보안을 위해 조직 및 앱의 모든 활동을 기록하는 전체 감사 추적을 제공합니다.

기록된 이벤트:

사용자 작업 (로그인, 로그아웃, 권한 변경)
Bundle 작업 (업로드, 삭제, 할당)
Channel 작업 (생성, 업데이트, 삭제)
조직 변경 사항 (설정, 멤버)

위치: Web Dashboard → Organization → Audit Logs

Webhook

HTTP webhooks를 통해 앱에서 발생하는 이벤트를 실시간 알림으로 받으세요.

지원되는 이벤트:

apps - App 생성/업데이트/삭제
app_versions - Bundle 업로드/삭제
channels - Channel 생성/업데이트/삭제
org_users - Member 추가/제거
orgs - Organization 업데이트

기능:

커스텀 webhook URL
이벤트 필터링
전송 로그
재시도 메커니즘
기능 테스트

위치: 웹 대시보드 → Organization → Webhooks

다중 사용자 협업

팀원을 조직에 초대하고 특정 역할과 권한을 부여하세요.

기능:

이메일 초대
역할 할당
멤버 관리
액세스 권한 회수

위치: 웹 대시보드 → 조직 → 멤버

API 키 관리

만료 날짜 설정 및 해시 저장이 가능한 API 키 생성, 관리 및 회수 기능을 제공합니다.

주요 기능:

앱별 또는 조직별 키 관리
선택적 만료 날짜 설정
해시 저장 (복구 불가)
키 로테이션 지원

위치: 웹 대시보드 → API 키

API 키 자세히 알아보기 →

비밀번호 정책

보안 표준 준수를 위한 조직 단위의 비밀번호 요구 사항 설정.

설정 가능한 정책:

최소 길이
대문자 포함
숫자 포함
특수 문자 포함

위치: 웹 대시보드 → Organization → Security

플랫폼 지원

멀티 플랫폼 지원

단 하나의 SDK로 iOS, Android, Electron 앱을 지원합니다.

지원 플랫폼:

iOS (Capacitor 5, 6, 7, 8)
Android (Capacitor 5, 6, 7, 8)
Electron (2025년 신규 지원)

장기 지원 (LTS)

레거시 앱과의 호환성을 유지하기 위해 이전 Capacitor 버전에 대한 지속적인 지원을 제공합니다.

현재 지원 버전:

Capacitor 8 (최신)
Capacitor 7
Capacitor 6
Capacitor 5

커스텀 스토리지 백엔드

Capgo의 기본 스토리지 대신 자체 스토리지 인프라(S3, R2 등)를 사용하세요.

커스텀 스토리지 자세히 알아보기 →

중국 지역 설정

중국 현지 규정을 준수하기 위해 중국 본토에 배포되는 앱을 위한 특수 설정입니다.

China configuration 자세히 알아보기 →

고급 기능

커스텀 업데이트 동작

SDK를 통해 업데이트를 확인하고 적용하는 시점과 방식을 설정합니다.

설정 가능한 옵션:

체크 간격 (periodCheckDelay - 최소 600초)
자동 업데이트 정책 (autoUpdate - off, atBackground, atInstall, onLaunch, always, onlyDownload)
네트워크 요구 사항 (Android 전용 - WorkManager 사용)

업데이트 동작 방식 자세히 보기 →

업데이트 유형

즉시 업데이트부터 사용자 제어 설치까지, 다양한 유스케이스에 맞는 업데이트 유형을 제공합니다.

사용 가능한 유형:

백그라운드 업데이트 (기본값)
즉시 업데이트
사용자 승인 업데이트
조건부 업데이트

업데이트 유형 자세히 보기 →

크레딧 시스템

대역폭, 스토리지 및 기타 리소스 사용량에 따라 크레딧으로 과금됩니다.

기능:

크레딧 사용량 추적
사용량 알림
Stripe로 충전
크레딧 내역

위치: 웹 대시보드 → Organization → Credits

시작하기

이 기능들을 바로 사용해 볼까요? 다음을 Quickstart 가이드 를 따라 첫 번째 앱에 Capgo Live Updates를 설정해 보세요.

도움이 필요하신가요?

Discord에 참여하세요 커뮤니티 지원
FAQ 확인하기 자주 묻는 질문
API 문서 살펴보기 API 연동 가이드
고객 지원 문의 엔터프라이즈 지원 문의

Features에서 계속하기

사용 중이라면 기능 모니터링 및 분석을 계획하려면, 다음 항목과 연결하세요 통계 Statistics의 구현 상세 내용은 로그 Logs의 구현 상세 내용은 @capgo/capacitor-appinsights @capgo/capacitor-appinsights의 구현 상세 내용은 @capgo/capacitor-appinsights 사용하기 @capgo/capacitor-appinsights 사용 시 Native 기능은, 그리고 @capgo/capacitor-firebase-analytics @capgo/capacitor-firebase-analytics.의 구현 상세 내용은