Live Update 배포

Capgo의 Live Updates 기능을 사용하면 앱의 UI와 비즈니스 로직을 실시간으로 원격 업데이트할 수 있습니다. 앱 스토어를 거치지 않고 JS bundle 업데이트를 사용자에게 직접 푸시해 버그를 즉시 수정하고 새 기능을 배포하세요.

팁

Capgo는 생성된 web build 폴더를 업로드합니다. HTML, CSS, JavaScript, assets, pure-JavaScript 패키지 변경 사항은 해당 폴더에 번들되면 OTA로 배포할 수 있습니다. 다음 항목을 변경하는 경우: capacitor.config.ts네이티브 플러그인 설정, 네이티브 패키지 또는 iOS/Android 프로젝트 파일은 네이티브 앱 릴리스가 필요합니다.

이 가이드는 다음 단계를 완료했다고 가정합니다: Capgo 빠른 시작하기 이미 다음을 완료한 상태여야 합니다:

1. 설치한 @capgo/capacitor-updater Capacitor 앱에서 SDK

2. 앱 ID와 업데이트 채널을 설정했습니다 capacitor.config.ts

3. code에 추가 CapacitorUpdater.notifyAppReady() 메서드

아직 해당 단계를 완료하지 않았다면, 먼저 퀵스타트를 완료한 뒤 돌아와 주세요.

앱 추가 Capgo 계정에 앱을 추가하고 앱에 플러그인을 설치하세요

Bundle 업로드하기

Capgo SDK 설치 및 설정을 마쳤다면, 첫 live update bundle을 업로드할 준비가 되었습니다:

1. 웹 에셋 빌드:

   npm run build

2. 번들을 Capgo에 업로드하세요:

   콘솔

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

   Github 액션

   .github/workflows/build_and_deploy.yml

   name: Build source code and send to Capgo
   
   concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
   
   on:
   push:
     branches:
       - main
   
   jobs:
   deploy_to_capgo:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: '24'
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} --channel ${{ env.CHANNEL }}
         env:
           CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

   GitLab

   .gitlab-ci.yml

   stages:
     - build
   
   build:
     stage: build
     image: node:18
     cache:
       - key:
           files:
             - package-lock.json
         paths:
           - .node_modules/
     script:
       - npm install
       - npm run build
       - npx @capgo/cli@latest bundle upload -a $CAPGO_TOKEN --channel $CAPGO_CHANNEL
     artifacts:
       paths:
         - node_modules/
         - dist/
     only:
       - master

   이 명령에 지정된 채널에 새로운 번들 버전을 업로드합니다.

업로드 문제 해결

업로드가 실패하면 다음을 다시 확인하세요:

• 다음에 있는 App ID가 capacitor.config.ts Capgo dashboard의 앱과 일치하는지
• Capacitor 프로젝트 루트에서 업로드 명령어를 실행 중인지
• 웹 에셋이 빌드되어 최신 상태인지

여전히 문제가 해결되지 않으면 문제 해결 섹션으로 이동하세요.

디바이스에서 업데이트 수신

bundle 업로드가 완료되면, 기기에서 live update를 테스트할 수 있습니다:

1. 앱을 기기에 sync하세요:

   npx cap sync ios

2. 다른 터미널을 열고 다음 명령어를 실행해 업데이트 상태를 확인하세요:

   npx @capgo/cli@latest app debug

3. 앱을 로컬에서 실행하세요:

   npx cap run ios

   또는 Xcode/Android Studio에서 iOS/Android 프로젝트를 열어 native run을 진행하세요.

4. 업데이트가 백그라운드에서 다운로드될 수 있도록 앱을 약 30초 동안 열어두세요.

5. 로그가 몇 초 후에 업데이트되어 업데이트 상태를 표시합니다.

6. 앱을 닫고 다시 열면 live update가 적용된 것을 확인할 수 있습니다!

다시 참고하세요 Capgo 빠른 시작하기 Live Update 테스트에 대한 자세한 내용은

다음 단계

Capgo로 첫 live update 배포를 완료했습니다! 🎉

더 자세히 알아보려면 나머지 Capgo Live Updates 문서를 검토해 보세요. 다음으로 확인해야 할 주요 주제:

• 채널로 업데이트 대상 지정
• 업데이트 동작 사용자 지정
• Live Update 롤백

Live Update 배포에서 계속하기

사용 중이라면 Live Update 배포 CI/CD 자동화를 계획하려면, 다음을 연결하세요 Capgo CI/CD 설정하기 Capgo CI/CD의 제품 워크플로우용, Capgo Native Build Capgo Native Builds의 제품 워크플로우용, Capgo 연동 서비스 Capgo Integrations의 제품 워크플로우용, CI/CD 통합 CI/CD Integration의 구현 세부 사항은, 그리고 GitHub Actions 연동 GitHub Actions Integration의 구현 세부 사항을 참고하세요.