개요

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

Live Updates 작동 방식

Capgo의 Live Update 시스템에는 두 가지 주요 구성 요소가 있습니다:

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

새로운 JS 번들을 Capgo에 업로드하고 채널에 할당하면, 해당 채널로 구성된 앱의 Capgo SDK가 업데이트를 감지하고 다운로드합니다. 앱이 다시 시작될 때 새로운 번들이 로드됩니다.

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

Capgo 퀵스타트를 완료하여 Capgo에서 앱을 설정하고 Capgo SDK를 설치하세요.
앱 코드에서 앱 초기화가 완료된 후 CapacitorUpdater.notifyAppReady()를 호출하세요. 이는 Capgo SDK에 앱이 업데이트를 받을 준비가 되었음을 알립니다.
JS 번들을 빌드하고 Capgo에 업로드하세요:
Terminal window
```
npm run build
npx @capgo/cli@latest upload --channel=Production
```
앱을 열고 업데이트가 다운로드될 때까지 기다리세요. 다음 명령으로 상태를 확인할 수 있습니다:
Terminal window
```
npx @capgo/cli@latest app debug
```
업데이트가 다운로드되면 앱을 닫았다가 다시 열어 새로운 번들을 로드하세요.

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

Capgo CLI는 개발자가 자체 CI/CD 파이프라인에서 Capgo 서비스와 상호 작용할 수 있게 해주는 강력한 도구입니다. CLI를 사용하면 빌드가 생성되고 배포되는 시기를 세밀하게 제어할 수 있어, Capgo를 기존 엔터프라이즈 워크플로우에 통합할 수 있습니다.

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

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

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

npx @capgo/cli@latest login [API_KEY]

이 명령은 나중에 사용할 수 있도록 저장됩니다. 로그인 후에는 각 명령마다 API 키를 제공할 필요가 없습니다.

다른 라이브 업데이트 CLI 도구에 익숙하다면, Capgo CLI에 대한 몇 가지 주요 사항을 알아두어야 합니다:

Capgo는 라이브 업데이트 기능 세트에만 중점을 두기 때문에 개발과 CI/CD 사용 사례 모두에 단일 CLI를 사용합니다.
Capgo CLI는 별도의 설치 단계가 필요하지 않습니다. @capgo/cli 패키지에 번들로 제공되며 npx를 사용하여 직접 실행할 수 있습니다.
Capgo의 CLI는 라이브 업데이트 워크플로우에 특화되어 있어 더 일반적인 CLI 도구에서 찾을 수 있는 일부 기능이나 명령이 포함되지 않을 수 있습니다.

채널

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

롤백

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

업데이트 동작

앱에서 업데이트가 다운로드되고 적용되는 방식과 시기를 사용자 지정하세요.

빠른 업데이트

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