기능

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시어를 복사하세요.

이 페이지는 Capgo Live Updates에서 사용 가능한 모든 기능에 대한 포괄적인 개요를 제공합니다. 각 기능에는 간결한 설명과 자세한 문서로 연결된 링크가 포함되어 있습니다.

핵심 업데이트 시스템

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

앱 스토어 승인 없이 사용자에게 JavaScript, HTML, CSS 및 자산 업데이트를 직접 배포할 수 있습니다. 업데이트들은 배경에서 다운로드되고 다음 앱 재시작 시 적용됩니다.

주요 기능:

배경 다운로드
자동 설치
사용자 간섭 없음
iOS, Android, Electron과 같은 플랫폼 간 지원

업데이트 동작에 대한 자세한 내용 →

__CAPGO_KEEP_0__ (Differential Updates)

__CAPGO_KEEP_1__을 다운로드하는 대신 변경된 파일만 다운로드하여 95%까지의 대역폭 사용량을 줄이고 업데이트를 더 빠르게 전달할 수 있습니다.

__CAPGO_KEEP_0__:

__CAPGO_KEEP_2__:
__CAPGO_KEEP_3__:
__CAPGO_KEEP_4__
__CAPGO_KEEP_5__

__CAPGO_KEEP_6__

자동 롤백

업데이트가 로드되지 않거나 충돌이 발생하면 시스템은 마지막으로 작동한 버전으로 자동으로 되돌아갑니다.

주요 기능:

추락 감지
시간 초과 감지
자동으로 롤백
사용자 개입이 필요하지 않습니다.

롤백에 대한 자세한 내용 →

체크섬 검증 및 폴백

체크섬을 통해 패키지의 무결성을 검증하고, 손상이 감지되면 마지막으로 작동한 버전으로 자동으로 폴백합니다.

주요 기능:

다운로드 시 체크섬 검증
손상 감지
자동으로 작동하는 버전으로의 fallback
수동 복구 도구가 제공됩니다.

업데이트 감지

code 버전보다 이전의 네이티브 버전이 실행 중인 장치에 불일치하는 업데이트가 적용되는 것을 방지합니다.

주요 기능:

네이티브 버전 호환성 확인
플러그인 의존성 검증
불일치하는 업데이트를 자동으로 차단합니다.
명확한 오류 메시지

__CAPGO_KEEP_0__ 버전을 대상으로 하는 방법에 대해 자세히 알아보세요 →

배포 제어

채널 시스템

다양한 환경과 사용자 세그먼트에서 업데이트를 조직하고 관리하는 데 유연한 채널 구성으로

Key 기능:

무제한의 사용자 지정 채널 (제품, 스테이징, 베타 등)
채널별 패키지 할당
채널별 목표 설정 규칙
기기 자체 할당
기기당 채널 오버라이드

채널에 대한 자세한 내용 →

기기 목표 설정

특정 장치, 버전, 또는 사용자 세그먼트를 대상으로 phased 롤아웃 및 제어된 배포를 수행합니다.

주요 기능:

버전 기반 대상 설정
장치별 오버라이드
플랫폼 필터링 (iOS, Android, Electron)
사용자 정의 메타데이터 필터링
에뮬레이터/개발자 빌드 차단

채널 정책

채널별 업데이트가 전달되는 방법에 대한 규칙과 제한을 구성합니다.

주요 기능:

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

채널 정책에 대해 더 알아보기 →

개발자 도구

번들 미리보기

장치에 배포하기 전에 장치에 배포하기 전에 실제 웹 환경에서 번들을 미리보는 데 사용할 수 있는 웹 대시보드에서 번들을 미리보세요.

위치: 웹 대시보드 → 앱 → 번들 → 미리보기 탭

실시간 디버깅

CLI를 통해 특정 장치의 업데이트 이벤트를 실시간으로 모니터링할 수 있습니다. 업데이트, 다운로드, 설치, 오류 이벤트를 확인할 수 있습니다.

사용 방법:

npx @capgo/cli app debug [appId]

보여줍니다:

업데이트 확인
다운로드 진행
설치 상태
오류 메시지
정책 블록

번들 매니페스트 뷰어

어떤 번들의 완전한 매니페스트를 포함한 파일 목록, 체크섬, 및 메타데이터를 검사할 수 있습니다.

위치: 웹 대시보드 → 앱 → 번들 → 매니페스트 탭

표시:

체크섬이 포함된 파일 목록
번들 메타데이터
네이티브 버전 호환성
플러그인 의존성

네이티브 플러그인 의존성

모든 버전에서 의존성 변경 추적을 위해 각 배포본에 포함된 모든 Capacitor 네이티브 플러그인을 모두 확인하세요.

위치: 웹 대시보드 → 앱 → 배포본 → 의존성 탭

표시:

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

CLI 통합

자동 배포 및 CI/CD 통합을 위한 광범위한 명령줄 인터페이스.

주요 명령:

bundle upload - 새로운 번들을 업로드하세요
bundle list - 모든 번들을 목록화하세요
bundle delete - 번들을 삭제하세요
bundle cleanup - 오래된 번들을 정리하세요
channel set - 채널을 구성하세요
app debug - 실시간 디버깅

View full CLI reference →

번들 암호화

번들에 대한 끝에서 끝까지의 암호화는 AES-256 암호화를 사용하여, 번들이 전송 중인 동안과 저장 중인 동안 code를 보호합니다.

주요 기능:

RSA 키 pair 생성
AES-256 패키지 암호화
Code 서명 확인
암호화 키 관리

더 알아보기 →

패키지 정리 및 보존

보존 정책에 따라 자동으로 오래된 패키지를 정리하여 저장 용량을 관리합니다.

주요 기능:

보존 수를 조정할 수 있습니다.
자동 정리: CLI
예약된 정리 작업
저장 용량 추적

사용 방법:

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

분석 및 모니터링

통계 업데이트

사용 가능한 메트릭:

다운로드 성공률

설치 성공률
오류 유형별 오류율
__CAPGO_KEEP_0__
시간에 따른 채택률
버전 분포

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

기기 로그

기기별로 이벤트 로그를 보여주며, 업데이트 라이프 사이클(체크부터 설치까지) 전체를 보여줍니다.

이벤트 유형:

업데이트 체크
다운로드 시작/완료/실패
설치 시작/완료/실패
롤백 이벤트
정책 블록

위치:

웹 대시보드 → 앱 → 장치 → 로그
웹 대시보드 → 앱 → 로그 (모든 장치)

로그에 대한 자세한 내용 보기 →

Bundle 사용 분석

활성화된 Bundle, 다운로드 횟수, 저장 용량 사용에 대한 자세한 분석

지표:

Bundle 당 활성 설치 횟수
다운로드 횟수
Bundle 당 저장 용량 사용
대역폭 사용량

채널 통계

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

지표:

채널별 장치 수
채널별 업데이트 성공률
배포 기록
채널별 오류율

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

배포 기록

모든 번들 배포, 채널 assignments, 및 구성 변경의 완전한 감사 기록

추적된 이벤트:

번들 업로드
채널 assignments
정책 변경
장치 오버라이드

위치: 웹 대시보드 → 앱 → 채널 → 기록

보안 및 준수

끝-to-End 암호화

__CAPGO_KEEP_0__

REST 및 전송 중 AES-256 암호화로 데이터를 암호화합니다.

Code Signing

__CAPGO_KEEP_0__

SOC 2 Type II 인증

애플 앱 스토어 및 구글 플레이 스토어 정책에 대한 OTA 업데이트와 관련하여 완전한 준수입니다.

__CAPGO_KEEP_0__ Signing

SOC 2 Type II Compliance

Learn more about compliance →

2FA Enforcement (Organization-level)

모든 조직 구성원에게 대시보드 및 API에 접근하기 위해 두 팩터 인증을 요구하세요.

위치: Web 대시보드 → 조직 → 보안

Learn more about 2FA →

암호화된 번들 강제 시행

모든 번들을 조직 수준에서 암호화하도록 요구하세요.

위치: Web 대시보드 → 조직 → 보안

팀 협업

역할 기반 접근 제어 (RBAC)

기본 단위 단위로 조직 및 앱 수준 접근 제어를 위한 권한.

조직 역할:

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

앱 역할:

app_admin - 하나의 앱에 대한 전체 제어
app_developer - __CAPGO_KEEP_0__ 업로드, 장치 관리
app_uploader - __CAPGO_KEEP_0__ 업로드만
app_reader - 읽기 전용 접근

위치:

웹 대시보드 → 조직 → 멤버
웹 대시보드 → 앱 → 접근

RBAC에 대한 자세한 내용 →

감사 로그

조직 및 앱 활동의 모든 완전한 감사 기록을 보안 및 규정 준수에 사용합니다.

로그된 이벤트:

사용자 동작 (로그인, 로그아웃, 권한 변경)
__CAPGO_KEEP_0__ (업로드, 삭제, assign)
__CAPGO_KEEP_1__ (생성, 업데이트, 삭제)
__CAPGO_KEEP_2__ (설정, 멤버)

__CAPGO_KEEP_3__ __CAPGO_KEEP_4__ → __CAPGO_KEEP_5__ → __CAPGO_KEEP_6__

__CAPGO_KEEP_7__

__CAPGO_KEEP_9__

__CAPGO_KEEP_10__

apps __CAPGO_KEEP_11__
app_versions __CAPGO_KEEP_12__
channels __CAPGO_KEEP_13__ (앱 생성/업데이트/삭제)
org_users - 회원 추가/삭제
orgs - 조직 업데이트

기능:

사용자 지정 웹훅 URL
이벤트 필터링
배달 로그
재시도 메커니즘
테스트 기능

위치: 웹 대시보드 → 조직 → 웹후크

다중 사용자 협업

__CAPGO_KEEP_0__ 팀원 초대

Features:

이메일 초대
역할 assignments
멤버 관리
권한 취소

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

API Key Management

API 키를 생성, 관리 및 만료일과 해시된 저장소 옵션과 함께 취소할 수 있습니다.

키 기능:

애플리케이션 또는 조직별 키
선택적 만료 날짜
해시된 저장소 ( irreversible )
키 회전 지원

위치: 웹 대시보드 → API 키

API 키에 대한 자세한 내용 →

패스워드 정책

조직 수준의 패스워드 요구 사항을 사용하여 보안 표준을 강제합니다.

정의 가능한 정책:

최소 길이
대문자 요구
숫자 요구
특수 문자 요구

위치: 웹 대시보드 → 조직 → 보안

플랫폼 지원

다중 플랫폼 지원

iOS, Android 및 Electron 앱을 위한 단일 SDK

지원하는 플랫폼:

iOS (Capacitor 5, 6, 7, 8)
안드로이드 (Capacitor 5, 6, 7, 8)
Electron (NEW in 2025)

장기 지원

이전 Capacitor 버전을 유지하기 위해 레거시 앱과 호환성을 유지하기 위해 더 이상 지원하지 않는 Capacitor 버전에 대한 지속적인 지원.

현재 지원 중인 __CAPGO_KEEP_0__ 버전은 다음과 같습니다.

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

사용자 지정 저장소 백엔드

Capgo의 기본 저장소 대신 사용자 지정 저장소 인프라 (S3, R2, etc.)를 사용하세요.

사용자 지정 저장소에 대해 더 알아보기 →

중국 설정

대륙 중국에서 배포되는 앱을 위해 지역 규제를 준수하기 위한 특별한 설정

중국 설정에 대해 더 알아보기 →

고급 기능

Configure when and how updates are checked and applied via the SDK.

targetLanguage

__CAPGO_KEEP_0__ (periodCheckDelay - 최소 600 초)
__CAPGO_KEEP_1__ (autoUpdate - off, atBackground, atInstall, onLaunch, 항상, 다운로드만)
__CAPGO_KEEP_2__ (Android 전용 - WorkManager를 통해)

Learn more about update behavior →

__CAPGO_KEEP_0__

__CAPGO_KEEP_4__

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__ (기본값)
__CAPGO_KEEP_7__
__CAPGO_KEEP_0__
__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__

__CAPGO_KEEP_7__
__CAPGO_KEEP_8__
__CAPGO_KEEP_9__
__CAPGO_KEEP_10__

__CAPGO_KEEP_11__ 웹 대시보드 → 조직 → 크레딧

Getting Started

이 기능들을 사용하기 위해 준비되셨나요? __CAPGO_KEEP_0__ Live Updates와 함께 첫 번째 앱을 설정하는 방법을 알아보세요. Quickstart Guide Capgo Live Updates와 함께 첫 번째 앱을 설정하는 방법을 알아보세요.

Need Help?

Discord에 가입하여 커뮤니티 지원을 받으세요.
FAQ를 확인하여 일반적인 질문을 확인하세요.
도큐먼트를 API으로浏览하세요 API 통합을위한
지원 문의 기업 지원을위한

기능에서 계속

__CAPGO_KEEP_1__이 __CAPGO_KEEP_2__을 사용하고 있나요 기능 계획, 모니터링 및 분석을위한 __CAPGO_KEEP_2__을 연결하세요 __CAPGO_KEEP_3__ __CAPGO_KEEP_3__의 구현 세부 정보 __CAPGO_KEEP_4__ 로그에 대한 구현 세부 정보를 위해 @capgo/capacitor-appinsights 로그에 대한 구현 세부 정보를 위해 @capgo/capacitor-appinsights Capacitor를 사용하여 @capgo/capacitor-appinsights Capacitor를 사용하여 @capgo/capacitor-appinsights와 함께 native 기능 @capgo/capacitor-firebase-analytics 구현 세부 정보를 위해 @capgo/capacitor-firebase-analytics