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() 방법

아직 이 단계들을 완료하지 않았다면, 다시 돌아가서 Quickstart를 먼저 완료해 주세요.

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

Bundle 업로드하기

Capgo SDK 설치 및 설정이 완료되었습니다. 이제 첫 번째 live update bundle을 업로드할 준비가 되었습니다:

1. 웹 에셋 빌드:

   npm run build

2. Capgo에 bundle를 upload 하세요:

   콘솔

   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

   명령어에 지정된 channel로 새로운 bundle 버전이 upload 됩니다.

Upload 문제 해결

Upload에 실패했다면 다음을 확인하세요:

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

문제가 계속되면 다음 문제 해결 섹션으로 이동하세요.

기기에서 Update 받기

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 updates 테스트를 진행하세요.

다음 단계

Capgo를 사용하여 첫 live update 배포에 성공하신 것을 축하합니다! 🎉

더 자세한 내용은 다음의 나머지 Capgo Live Updates 문서를검토해 보세요. 다음에 확인하면 좋은 주요 주제입니다:

• Channels를 이용한 업데이트 타겟팅
• 업데이트 동작 커스텀하기
• 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의 구현 세부 사항을 참고하세요.