개요

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

Capgo의 Live Updates 기능을 사용하면 앱의 JavaScript 번들을 실시간으로 원격 업데이트할 수 있습니다. 앱 스토어 심사 과정을 거치지 않고 사용자에게 JS 업데이트를 직접 배포하여 버그를 즉시 수정하고 새로운 기능을 빠르게 출시하세요.

Live Updates 작동 방식

Capgo의 Live Update 시스템은 두 가지 핵심 구성 요소로 이루어져 있습니다:

앱에 설치하는 Capgo SDK. SDK가 사용 가능한 업데이트를 확인하고 백그라운드에서 다운로드합니다.
특정 사용자 그룹을 대상으로 업데이트를 배포할 수 있는 Channels가 있습니다. Channels를 사용하면 다음과 같은 다양한 릴리스 트랙을 관리할 수 있습니다. Production, Staging, 그리고 Dev.

Capgo에 새로운 JS bundle을 upload하고 채널에 할당하면, 해당 채널에 설정된 앱의 Capgo SDK가 업데이트를 감지하고 download합니다. 다음에 앱이 재시작되면 새로운 bundle이 로드됩니다.

시작하기

Live Updates를 시작하려면 다음 단계를 따르세요:

다음을 완료하세요: Capgo 빠른 시작하기 Capgo에 앱을 설정하고 Capgo SDK를 설치하려면 Capgo Quickstart를 참고하세요.
앱의 code에서 다음을 호출하세요: CapacitorUpdater.notifyAppReady() 앱 초기화가 완료된 후 호출합니다. 이를 통해 Capgo SDK에 앱이 업데이트를 받을 준비가 되었음을 알립니다.

JS bundle을 빌드하고 Capgo에 upload하세요:

npm run build
npx @capgo/cli@latest bundle upload --channel=production

앱을 실행하고 업데이트 다운로드가 완료될 때까지 기다리세요. 상태는 다음 명령어로 확인할 수 있습니다:
터미널 창
```
npx @capgo/cli@latest app debug
```
업데이트 다운로드가 완료되면, 앱을 종료 후 다시 실행하여 새 bundle을 로드하세요.

전체 권한 목록은 Live Updates 배포하기 자세한 내용은 가이드를 참조하세요.

Capgo CLI

Capgo CLI는 개발자가 자신의 CI/CD pipeline에서 Capgo 서비스를 직접 제어할 수 있는 강력한 도구입니다. CLI를 사용하면 빌드 생성 및 배포 시점을 세밀하게 관리할 수 있어, Capgo를 기존 엔터프라이즈 워크플로우에 원활하게 통합할 수 있습니다.

Capgo CLI의 용도는 무엇인가요?

Capgo CLI는 live update 워크플로우에서 더 높은 제어권과 유연성이 필요한 개발자와 팀을 위해 설계되었습니다. CI/CD 파이프라인에 CLI를 사용하면 다음과 같은 작업이 가능합니다:

Capgo의 기본 자동화에 의존하는 대신, 업데이트를 빌드하고 배포할 시점을 직접 결정할 수 있습니다
빌드와 배포 단계 사이에 code 서명, QA 테스트 또는 관리자 승인과 같은 자체 프로세스를 추가할 수 있습니다
기존 DevOps 도구 및 워크플로우에 Capgo를 통합할 수 있습니다

인증

Capgo CLI를 사용하려면 API 키로 인증해야 합니다. Capgo 계정 설정에서 API 키를 생성할 수 있습니다.

로그인하고 API 키를 안전하게 저장하려면 다음 명령어를 실행하세요:

npx @capgo/cli@latest login [API_KEY]

이 명령은 이후에 다시 사용할 수 있도록 저장됩니다. 로그인 후에는 매번 API 키를 입력할 필요가 없습니다.

다른 CLI 도구와의 주요 차이점

다른 live update CLI 도구에 익숙하시다면, Capgo의 CLI에서 주의 깊게 보아야 할 몇 가지 사항이 있습니다:

Capgo는 live update 기능 세트에만 집중하므로, Capgo는 개발과 CI/CD 환경 모두에서 단일 CLI를 사용합니다.
Capgo CLI는 별도의 설치 단계가 필요하지 않습니다. 이는 다음 항목에 포함되어 있으며, @capgo/cli 패키지로 제공되어 바로 실행할 수 있습니다: npx.
Capgo의 CLI는 live update 워크플로우에 특화되어 설계되었으므로, 범용 CLI 도구에서 볼 수 있는 일부 기능이나 명령은 포함되지 않을 수 있습니다.

다음 단계

채널

채널로 다양한 릴리스 트랙을 관리하고 특정 사용자에게 업데이트를 타겟팅하는 방법을 알아보세요.

롤백

업데이트로 인해 문제가 발생하면 이전 JS 번들 버전으로 롤백하는 방법을 알아보세요.

업데이트 동작

앱에서 업데이트를 다운로드하고 적용하는 방식과 시점을 설정하세요.

빠른 업데이트

Fast Updates를 사용하여 업데이트 프로세스를 가속화하는 방법을 알아보세요.

Overview에서 계속하기

사용 중인 경우 개요 대시보드와 API 운영을 계획하려면, 이를 다음 항목과 연결하세요: API 개요 API Overview의 구현 상세 내용은 소개 Introduction의 구현 상세 내용은 API 키 API Keys의 구현 상세 내용은 디바이스 Devices의 구현 상세 내용과 번들 Bundles의 구현 상세 내용은