기능

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

Capgo Live Updates의 모든 기능에 대한 포괄적인 개요를 제공합니다. 각 기능에는 간결한 설명과 자세한 문서로 연결된 링크가 포함됩니다.

코어 업데이트 시스템

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

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

주요 기능:

백그라운드 다운로드
자동 설치
사용자 간섭 없음
플랫폼 간 지원 (iOS, Android, Electron)

업데이트 동작에 대해 더 알아보기 →

델타 업데이트 (차이 업데이트)

버전 사이에 변경된 파일만 다운로드하여, 95%까지의 대역폭 사용량을 줄이고 업데이트 достав리를 가속화합니다.

주요 기능:

파일 수준의 자동 차이 분석
체크섬 기반의 검증
매니페스트 비교
필요한 경우 전체 업데이트로 자동으로 전환

델타 업데이트에 대해 더 알아보기 →

자동 롤백

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

주요 기능:

충돌 감지
시간 초과 감지
자동 되돌아가기
사용자 개입이 필요하지 않습니다

롤백에 대한 자세한 내용 →

체크섬 검증 및 폴백

주요 기능:

충돌 감지

다운로드 시 체크섬 검증
손상 감지
마지막으로 작동한 번들을 자동으로 사용
수동 복구 도구가 사용 가능합니다.

업데이트가 깨지지 않도록 감지

Prevents incompatible updates from being applied to devices running older native code versions.

기능:

원본 버전과 호환되는지 확인
플러그인 의존성 검증
불일치하는 업데이트를 자동으로 차단
오류 메시지 표시

버전 대상 설정에 대해 더 알아보기 →

배포 제어

채널 시스템

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

주요 기능:

무제한의 커스텀 채널(제품, 스테이징, 베타 등)
채널별 패키지 assignments
채널별 타겟팅 규칙
디바이스 자체 assign
디바이스별 채널 override

채널에 대해 더 알아보기 →

장치 대상 설정

특정 장치, 버전 또는 사용자 세그먼트를 대상으로 하여 phased rollouts 및 controlled deployments를 수행합니다.

주요 기능:

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

채널 정책

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

주요 기능:

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

채널 정책에 대한 자세한 내용 →

개발자 도구

번들 미리보기

__CAPGO_KEEP_0__

위치: 웹 대시보드 → 앱 → 번들 → 미리보기를 클릭

실시간 디버깅

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

사용 방법:

npx @capgo/cli app debug [appId]

표시:

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

번들 매니페스트 뷰어

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

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

표시:

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

네이티브 플러그인 의존성

각 버전에서 의존성 변경 추적하기 위해 포함된 각 번들을 통해 모든 네이티브 Capacitor 플러그인을 모두 표시합니다.

위치: 웹 대시보드 → 앱 → 번들 → 의존성 탭

표시:

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

CLI 통합

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

주요 명령어:

bundle upload - 새로운 번들을 업로드합니다.
bundle list - 모든 번들을 목록화합니다.
bundle delete - 번들을 삭제합니다.
bundle cleanup - 오래된 번들을 정리합니다.
channel set - 채널을 구성합니다.
app debug - 라이브 디버깅

CLI 전체 참조를 보려면 →

번들 암호화

End-to-end encryption for bundles with AES-256 encryption, protecting your code in transit and at rest.

기능:

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

암호화에 대한 자세한 내용 →

패키지 정리 및 보존

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

기능:

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

사용:

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

분석 및 모니터링

업데이트 통계

사용자 기반으로 업데이트의 수용률, 성공률 및 배포 진행률을 추적합니다.

사용 가능한 메트릭:

다운로드 성공률
설치 성공률
오류 유형별 오류율
시간에 따른 업데이트 수용률
버전 분포

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

장치 로그

장치별 이벤트 로그는 업데이트 라이프 사이클의 모든 단계(체크부터 설치까지)를 완벽하게 보여줍니다.

이벤트 유형:

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

위치:

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

로그에 대한 자세한 내용을 알아보세요 →

배포 사용 분석

활성화된 배포, 다운로드 횟수, 저장소 사용량에 대한 자세한 분석입니다.

메트릭:

배포별 활성 설치 횟수
다운로드 횟수
채널별 저장소 사용량
채널별 대역폭 사용량

채널 통계

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

지표:

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

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

배포 기록

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

추적된 이벤트:

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

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

보안 및 준수

끝-to-끝 암호화

Section titled “End-to-End Encryption”

REST 및 전송 중에 AES-256 암호화 표준을 사용하여 암호화된 패키지를 보호합니다.

Code Signing

Section titled “__CAPGO_KEEP_0__ Signing”

패키지의 무결성을 검증하여 위조를 방지하는 암호학적 서명

Section titled “SOC 2 Type II Compliance”

기업 보안을 위한 SOC 2 Type II 표준에 따라 인프라 및 프로세스를 인증했습니다.

애플 App Store 및 Google Play Store OTA 업데이트 정책에 완전히 준수합니다.

규정 준수에 대한 자세한 내용 →

2FA 강제 시행 (기업 수준)

기업 내 모든 구성원에게 API에 접근하기 위해 2단계 인증을 요구합니다.

위치: 웹 대시보드 → 기업 → 보안

2FA에 대한 자세한 내용 →

암호화된 패키지 강제 시행

기업 수준에서 모든 패키지가 암호화되도록 요구합니다.

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

팀 협업

역할 기반 접근 제어 (RBAC)

조직 및 앱 수준 접근 제어에 대한 세부 권한.

조직 역할:

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

애플리케이션 역할:

app_admin - 1 개의 애플리케이션에 대한 전체 제어
app_developer - 패키지 업로드, 장치 관리
app_uploader - 패키지 업로드만
app_reader - 읽기 전용 접근

위치:

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

RBAC에 대한 자세한 내용을 알아보세요.

감사 로그

조직 및 앱 활동의 모든 기록을 완벽하게 유지하여 법적 및 보안 목적으로.

Logged events:

사용자 행동 (로그인, 로그아웃, 권한 변경)
배포 패키지 연산 (업로드, 삭제, Assign)
채널 연산 (생성, 업데이트, 삭제)
조직 변경 (설정, 멤버)

위치: 웹 대시보드 → 조직 → 감사 로그

웹 훅

앱에서 발생하는 이벤트에 대한 실시간 알림을 HTTP 웹 훅을 통해 받을 수 있습니다.

지원되는 이벤트:

apps - 앱 생성/수정/삭제
app_versions - 업로드/삭제된 패키지
channels - 채널 생성/수정/삭제
org_users - 멤버 추가/삭제
orgs - 조직 업데이트

기능:

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

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

다중 사용자 협업

특정 역할과 권한을 부여받은 팀원들을 특정 조직에 초대할 수 있습니다.

기능:

이메일 초대
역할 assignments
회원 관리
권한 취소

위치: 웹 대시보드 → 조직 → 회원

API 키 관리

API 키를 생성, 관리 및 취소할 수 있습니다. 만료 날짜가 있는 옵션 및 해시된 저장소가 있습니다.

키 기능:

앱당 또는 조직당 키
만료 날짜가 있는 옵션
해시된 저장소 ( irreversible )
키 회전 지원

위치: 웹 대시보드 → API 키

API 키에 대한 자세한 내용 →

패스워드 정책

보안 표준을 강제하기 위한 조직 수준의 패스워드 요구 사항.

설정 가능한 정책:

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

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

플랫폼 지원

다중 플랫폼 지원

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

지원되는 플랫폼:

iOS (Capacitor 5, 6, 7, 8)
안드로이드 (Capacitor 5, 6, 7, 8)
Electron (2025년 신규)

장기 지원

이전 버전의 Capacitor를 유지하기 위해 호환성을 유지하기 위해 더 이상 지원하지 않는다.

현재 지원되는 버전:

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

사용자 지정 저장 백엔드

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

사용자 지정 저장에 대한 자세한 내용 →

중국 설정

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

중국 설정에 대한 자세한 내용 →

고급 기능

사용자 지정 업데이트 동작

SDK

설정 가능한 옵션:

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

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

업데이트 유형

다양한 업데이트용途를 위한 다양한 업데이트 유형, 즉 즉시 업데이트부터 사용자 제어 설치까지.

사용 가능한 유형:

배경 업데이트 (기본값)
즉시 업데이트
사용자 동의 업데이트
조건 업데이트

업데이트 유형에 대해 더 알아보기 →

크레딧 시스템

대역폭, 저장소 및 기타 자원에 대한 크레딧으로 사용 기반 요금제.

기능:

크레딧 사용량 추적
사용량 경고
스트라이프를 통해 충전
Live Updates 기능

위치: Web 대시보드 → 조직 → 크레딧

시작하기

이 기능을 사용하기 위해 준비되셨나요? __CAPGO_KEEP_0__ Live Updates를 사용하기 위해 첫 번째 앱을 설정하는 방법을 알아보세요. 도움이 필요하세요? to set up your first app with Capgo Live Updates.

Capgo 커뮤니티에 가입하여 지원을 받으세요.

Capgo 커뮤니티에 가입하여 지원을 받으세요. Capgo 커뮤니티에 가입하여 지원을 받으세요.
FAQ를 확인하세요 일반적인 질문에 대해
API 문서를浏览하세요 API 통합을 위해
기업 지원을 위해 연락하세요 Keep going from Features

Keep going from Features

__CAPGO_KEEP_0__ 통계와 연결하세요 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ Statistics 구현 세부 사항에 대해 로그 로그 구현 세부 사항에 대해 @capgo/capacitor-appinsights 구현 세부 사항에 대해 @capgo/capacitor-appinsights를 사용하여 @capgo/capacitor-appinsights를 사용하는 데 native 기능이 있습니다. @capgo/capacitor-firebase-analytics 구현 세부 사항에 대해 @capgo/capacitor-firebase-analytics for the implementation detail in @capgo/capacitor-firebase-analytics.