기능

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

핵심 업데이트 시스템

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

__CAPGO_KEEP_0__

사용자에게 앱 스토어 승인이 필요하지 않아도 자바스크립트, HTML, CSS, 및 자산 업데이트를 직접 배포할 수 있습니다. 업데이트는 배경에서 다운로드되어 다음 앱 재시작 시 적용됩니다.

• 주요 기능:
• 배경 다운로드
• 자동 설치
• 사용자 간섭 없음

iOS, Android, Electron을 포함한 크로스 플랫폼 지원

---

__CAPGO_KEEP_0__

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

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

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

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

---

자동 롤백

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

주요 기능:

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

롤백에 대한 자세한 내용을 알아보세요 →

---

체크섬 검증 및 대체

체크섬을 통해 배포물의 무결성을 검증하고 손상이 감지되면 자동으로 마지막으로 작동한 버전으로 대체합니다.

주요 기능:

• 다운로드 시 체크섬 검증
• 손상 감지
• 자동으로 마지막으로 작동한 배포물로 대체
• 수동 복구 도구가 사용 가능합니다

---

업데이트 중단 감지

code 버전이 더 오래된 기기에서 불일치한 업데이트를 적용하는 것을 방지합니다.

주요 기능:

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

버전 목표에 대한 자세한 내용 →

---

배포 제어

채널 시스템

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

Key capabilities:

• 무제한의 사용자 지정 채널 (제품, 스테이징, 베타 등)
• 채널별 패키지 할당
• 채널별 타겟팅 규칙
• 디바이스 자체 할당
• 디바이스별 채널 오버라이드

채널에 대한 자세한 내용 →

---

디바이스 타겟팅

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

Key capabilities:

• 버전 기반 타겟팅
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__

---

__CAPGO_KEEP_0__

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

주요 기능:

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

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

---

개발자 도구

번들 미리보기

위치:

웹 대시보드 → 앱 → 번들 → 미리보기 탭 라이브 디버깅

---

개발자 도구 섹션

Real-time monitoring of update events for specific devices via CLI, showing check, download, install, and error events.

사용 방법:

npx @capgo/cli app debug [appId]

보여줍니다:

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

---

Bundle Manifest Viewer

Bundle의 모든 파일 목록, 체크섬, 메타데이터를 포함하여 완전한 매니페스트를 검사하세요.

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

보여줍니다:

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

---

네이티브 플러그인 의존성

각 버전에서 의존성 변경 추적하기 위해 포함된 모든 네이티브 플러그인을 보기 위해 Capacitor

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

Shows:

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

---

CLI Integration

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

주요 명령어:

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

전체 CLI 참조 →

---

번들 암호화

번들에 대한 AES-256 암호화로 끝까지 암호화하여 code 전송 및 저장 시 보호합니다.

주요 기능:

• RSA 키 pair 생성
• AES-256 번들 암호화
• Code 서명 검증
• 암호화 키 관리

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

---

Bundle Cleanup & Retention

자동으로 __CAPGO_KEEP_0__에 따라 보관 기간을 설정하여 저장 용량을 관리합니다.

주요 기능:

• 보관 기간 설정
• CLI를 통해 자동으로 삭제
• 예약된 삭제 작업
• 저장 용량 추적

사용 방법:

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

---

분석 및 모니터링

통계 업데이트

사용자 기반으로 업데이트의 수용률, 성공률, 배포 진행률을 추적하세요.

사용 가능한 메트릭:

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

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

---

기기 로그

기기별 이벤트 로그, 업데이트 라이프 사이클(체크부터 설치까지) 완전하게 표시

이벤트 유형:

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

위치:

• 웹 대시보드 → 앱 → 기기 → 로그
• 웹 대시보드 → 앱 → 로그 (모든 기기)

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

---

Bundle 사용 분석

활성화된 Bundle, 다운로드 횟수, 저장 용량에 대한 세부적인 분석입니다.

지표:

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

---

채널 통계

Track performance and adoption metrics per channel.

지표:

• 채널별 장치 수
• 채널별 배포 성공률
• 배포 기록
• 채널별 오류율

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

---

배포 기록

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

추적된 이벤트:

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

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

---

보안 및 준수

끝-to-끝 암호화

__CAPGO_KEEP_0__ 서명

업데이트

---

Code Signing

배포를 방지하기 위해 암호화 서명으로 번들完整성을 확인하세요.

---

SOC 2 Type II 준수

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

---

App Store 준수

준수 사항에 대한 자세한 내용 →

2FA 강제 (기업 수준)

---

2FA를 사용하여 모든 조직 구성원에게 __CAPGO_KEEP_0__에 접근할 수 있도록 하세요.

API 인증

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

2단계 인증에 대해 더 알아보기 →

---

암호화된 번들 강제

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

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

---

팀 협업

역할 기반 접근 제어 (RBAC)

단체 및 앱 수준 접근 제어에 대한 세분화된 권한.

단체 역할:

• org_super_admin - 전체 단체 제어
• org_admin - 단체 관리 (결제/삭제 제외)
• org_billing_admin - 결제만 허용
• org_member - 단체 읽기 전용 접근

앱 역할:

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

위치:

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

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

---

감사 로그

조직 및 앱 활동의 모든 감사 기록을 보관하여 법적 및 보안 요구를 충족합니다.

로그된 이벤트:

• 사용자 동작 (로그인, 로그아웃, 권한 변경)
• 패키지 작업 (업로드, 삭제, 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)
• Android (Capacitor 5, 6, 7, 8)
• Electron (2025년 신규)

---

장기 지원

Capacitor 버전을 유지하기 위해 레거시 앱과 호환성을 유지하기 위해 더 이상 지원하지 않는 이전 버전의 지원을 계속합니다.

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

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

---

사용자 지정 저장소 백엔드

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

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

---

중국 설정

중국 본토에서 배포되는 앱을 위한 특별한 설정을 구성합니다. 지역 규정에 따라 준수합니다.

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

---

고급 기능

업데이트 동작을 커스터마이즈

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

업데이트 주기 (

• - 최소 600초)periodCheckDelay 직접 업데이트 타이밍 (
• - 설치 시, 런칭 시, 항시)directUpdate 업데이트를 확인하고 적용하는 시점과 방법을 __CAPGO_KEEP_0__를 통해 구성합니다.
• 자동 업데이트 활성화/비활성화 (autoUpdate)
• 네트워크 요구 사항 (Android 전용 - WorkManager를 통해)

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

---

업데이트 유형

다양한 업데이트 유형이 다양한 사용 사례에 맞게 제공되며, 즉시 업데이트부터 사용자에게 업데이트를 제어하도록 하는 설치까지 다양한 옵션이 있습니다.

지원되는 유형:

• 배경 업데이트 (기본값)
• 즉시 업데이트
• 사용자에게 업데이트를 요청하는 업데이트
• 조건부 업데이트

업데이트 유형에 대한 자세한 내용 →

---

신용 시스템

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

기능:

• 신용 사용 추적
• 사용량 경고
• 스 트라이프를 통해 신용 충전
• 신용 계정

위치: 웹 대시보드 → 조직 → 신용

---

시작하기

이 기능들을 사용하기 위해 준비되셨나요? __CAPGO_KEEP_0__ Live Updates를 사용하여 첫 번째 앱을 설정하기 위해 우리의 Quickstart Guide to set up your first app with Capgo Live Updates.

도움이 필요하세요?

• 우리 Discord에 가입하세요. 커뮤니티 지원을 위해
• FAQ를 확인하세요. 일반적인 질문을 위해
• API for API integration
• __CAPGO_KEEP_0__ __CAPGO_KEEP_0__