기능

설치

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

핵심 업데이트 시스템

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

배경 다운로드

자동 설치

사용자 간섭 없음
Section titled “Over-the-Air (OTA) Updates”
Section titled “Core Update System”
멀티 플랫폼 지원 (iOS, Android, Electron)

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

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

버전 사이에 변경된 파일만 다운로드하여, 95%까지의 대역폭 사용량을 줄이고 업데이트를 더 빠르게 전달합니다.

주요 기능:

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

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

자동 롤백

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

주요 기능:

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

롤백에 대한 자세한 내용 →

체크섬 검증 및 폴백

주요 기능:

체크섬 검증 및 폴백

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

업데이트가 깨질 경우 감지

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

기존 네이티브 __CAPGO_KEEP_0__ 버전을 실행하는 기기에서 불일치하는 업데이트가 적용되는 것을 방지합니다.

기능적 기능:
네이티브 버전 호환성 확인
플러그인 의존성 검증
불일치하는 업데이트를 자동으로 차단합니다.

버전 대상 설정 →에 대해 자세히 알아보기

배포 관리

채널 시스템

다양한 환경과 사용자 세그먼트를 위한 유연한 채널 설정을 통해 업데이트를 조직하고 관리하세요.

주요 기능:

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

Channels에 대해 더 알아보기 →

장치 대상 설정

특정 장치, 버전 또는 사용자 세그먼트를 대상으로 하여 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 - 라이브 디버깅

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 __CAPGO_KEEP_0__
Automatic cleanup via CLI
정기적인 청소 작업
저장소 사용량 추적

사용량:

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

분석 및 모니터링

업데이트 통계

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

사용 가능한 메트릭:

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

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

장치 로그

장치별 이벤트 로그, 업데이트 주기(체크부터 설치까지)가 완전히 표시됩니다.

이벤트 유형:

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

위치:

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

로그에 대한 자세한 내용 →

배포 용량 분석

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

메트릭:

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

채널 통계

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

지표:

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

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

배포 기록

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

추적된 이벤트:

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

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

보안 및 준수

End-to-End Encryption

Code Signing

End-to-End Encryption

__CAPGO_KEEP_0__ Signing

Section titled “__CAPGO_KEEP_0__ Signing”

애플 앱 스토어 및 구글 플레이 스토어 OTA 업데이트 정책에 완전히 준수합니다.

준수 사항 더 알아보기 →

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

기업 구성원 모두가 대시보드 및 API에 접근하기 위해 2단계 인증을 요구합니다.

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

2FA에 대한 자세한 내용 →

암호화된 패키지 강제 시행

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

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

팀 협업

역할 기반 접근 제어 (RBAC)

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

조직 역할:

org_super_admin - 조직 전체 제어
org_admin - 조직 관리 (billing/deletion 제외)
org_billing_admin - billing만 허용
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 키를 생성, 관리 및 취소하고 옵션의 만료 날짜 및 해시 저장소와 함께.

Key 기능:

앱당 또는 조직당 키
옵션의 만료 날짜
해시 저장소 ( необ반환 )
키 회전 지원

위치: 웹 대시보드 → API 키

API 키에 대해 더 알아보기 →

암호 정책

보안 표준을 강제하기 위한 조직 수준 암호 정책.

설정 가능한 정책:

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

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

플랫폼 지원

다중 플랫폼 지원

iOS, Android 및 Electron 앱에 대한 단일 SDK 지원

지원되는 플랫폼:

iOS (Capacitor 5, 6, 7, 8)
Android (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)
네트워크 요구 사항 (Android 전용 - WorkManager를 통해)

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

업데이트 유형

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

사용 가능한 유형:

배경 업데이트 (기본값)
즉시 업데이트
사용자에게 알림 업데이트
조건부 업데이트

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

크레딧 시스템

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

기능:

크레딧 사용 추적
사용 알림
스트리핑을 통해 충전
Live Updates 기능

위치: Web Dashboard → Organization → Credits

시작하기

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

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

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

Keep going from Features

Features 계획 모니터링 및 분석을위한 Statistics와 연결하세요 Keep going from Features implementation 세부 사항에 대해 로그 로그 Capgo에서 @capgo/capacitor-appinsights Capgo에서 @capgo/capacitor-appinsights Capgo에서 @capgo/capacitor-appinsights를 사용 Capgo에서 @capgo/capacitor-appinsights를 사용 Capgo에서 @capgo/capacitor-firebase-analytics for the implementation detail in @capgo/capacitor-firebase-analytics.