실시간 업데이트 배포

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

이 안내서에서는 다음을 가정합니다. Capgo 빠른 시작을 완료했으며 이미: __CAPGO_KEEP_0__를 __CAPGO_KEEP_1__ 앱에 설치했습니다.

1. __CAPGO_KEEP_0__ 앱 ID 및 업데이트 채널을 __CAPGO_KEEP_2__에 구성했습니다. @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_0__를 빠른 시작으로 완료하지 않았다면 먼저 빠른 시작을 완료하십시오. capacitor.config.ts

3. code는 __CAPGO_KEEP_4__을 사용합니다. CapacitorUpdater.notifyAppReady() __CAPGO_KEEP_0__는 __CAPGO_KEEP_5__을 사용합니다.

__CAPGO_KEEP_0__는 __CAPGO_KEEP_6__을 사용합니다.

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

배포 패키지 업로드

Capgo SDK이 설치 및 설정되면, 첫 번째 라이브 업데이트 배포 패키지를 업로드할 준비가 되었습니다.

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

   이 명령어에 지정된 채널에 새로운 버전의 패키지를 업로드합니다.

문제 해결: 업로드

업로드가 실패하면 확인하세요:

• 앱 ID가 capacitor.config.ts 앱 Capgo 대시보드에 등록된 앱과 일치하는지 확인하세요.
• Capacitor 프로젝트의 루트에서 업로드 명령을 실행하고 있습니다.
• 웹 자산이 빌드되고 최신 상태입니다.

문제가 해결되지 않는다면 문제 해결 부분으로 이동하세요.

장치에서 업데이트 수신

업로드한 번들을 테스트하려면 라이브 업데이트 테스트를 장치에서 실행하세요.

1. 앱을 장치에 동기화하세요.

   npx cap sync ios

2. 다른 터미널 창에서 업데이트 상태를 확인하기 위해 다음 명령어를 실행하세요.

   npx @capgo/cli@latest app debug

3. __CAPGO_KEEP_2__

   npx cap run ios

   __CAPGO_KEEP_5__

4. __CAPGO_KEEP_6__

5. __CAPGO_KEEP_7__

6. __CAPGO_KEEP_8__

__CAPGO_KEEP_9__ Capgo Quickstart __CAPGO_KEEP_11__

다음 단계

Capgo으로 첫 번째 라이브 업데이트를 성공적으로 배포했습니다! 🎉

더 많은 정보를 얻으려면 다음을 검토하세요. Capgo 라이브 업데이트 문서의 나머지 부분. 다음을 확인할 수 있는 몇 가지 주요 주제:

• 채널을 통해 업데이트를 대상화하는 방법
• 업데이트 동작을 맞춤화하는 방법
• 라이브 업데이트 롤백

Deploy a Live Update에서 계속 진행하세요

Cloudflare을 사용하고 있다면 실시간 업데이트 배포 CI/CD 자동화 계획을 수립하기 위해 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 위해 Capgo 네이티브 빌드 Capgo 네이티브 빌드에서 제품 워크플로우를 위해 Capgo 통합 Capgo 통합에서 제품 워크플로우를 위해 CI/CD 통합 CI/CD 통합의 구현 세부 사항을 위해 GitHub 액션 통합 GitHub 액션 통합의 구현 세부 사항을 위해