개요

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

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

Live Updates 작동 원리

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

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

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

시작하기

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

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

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

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 파이프라인에서 Capgo의 서비스와 상호작용할 수 있게 해 주는 강력한 도구입니다. CLI를 사용하면 빌드 생성 및 배포 시점을 세밀하게 제어할 수 있어, 기존 엔터프라이즈 워크플로에 Capgo를 통합할 수 있습니다.

Capgo CLI는 무엇에 쓰나요?

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

Capgo의 내장 자동화에 의존하지 않고 업데이트를 빌드하고 배포할 시점을 정확히 정할 수 있습니다
빌드와 배포 단계 사이에 code 서명, QA 테스트, 관리자 승인 같은 자체 프로세스를 넣을 수 있습니다
Capgo를 기존 DevOps 도구와 워크플로우에 통합할 수 있습니다

인증

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 bundle 버전으로 롤백하는 방법을 알아보세요.

업데이트 동작

앱에서 업데이트가 다운로드되고 적용되는 방식과 시점을 커스터마이즈하세요.

빠른 업데이트

Fast Updates를 사용해 업데이트 프로세스 속도를 높이는 방법을 알아보세요.

개요에서 계속하기

사용 중이라면 개요 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 구현 세부 사항은 API 키에서 기기 구현 세부 사항은 기기에서, 그리고 번들 Bundles의 구현 세부 사항은