__CAPGO_KEEP_2__

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

이 안내서에서는 __CAPGO_KEEP_0__ Quickstart를 완료한 후에 진행합니다. 이미 완료했다면 다음 단계로 진행하세요. 앱 __CAPGO_KEEP_1__에 Capgo를 설치했습니다. __CAPGO_KEEP_0__의 업데이트 채널 및 앱 ID를 __CAPGO_KEEP_2__에 구성했습니다.

1. __CAPGO_KEEP_0__에 __CAPGO_KEEP_3__ 메서드를 추가했습니다. @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_0__ capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() __CAPGO_KEEP_2__

__CAPGO_KEEP_3__

앱 추가 앱을 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 프로젝트의 루트에서 업로드 명령어를 실행하고 있습니다.
• __CAPGO_KEEP_0__ 프로젝트의 웹 자산은 빌드되고 최신 상태입니다.

문제가 해결되지 않으면, 문제 해결 장을 참조하십시오.

장 제목:

배포된 번들을 업로드 한 후, 장치에서 실시간 업데이트를 테스트할 수 있습니다:

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

   npx cap sync ios

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

   npx @capgo/cli@latest app debug

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

   npx cap run ios

   iOS/Android 프로젝트를 Xcode/Android Studio에서 열고 네이티브로 실행하세요.

4. __CAPGO_KEEP_0__ 초보자 가이드에서 배포를 위해 앱을 열어두세요. 배포를 위해 앱을 열어두세요.

5. 로그가 업데이트되기까지 몇 초 정도 기다려 주세요.

6. 앱을 닫고 다시 열어보세요. 라이브 업데이트가 적용된 것을 확인하세요!

배포를 위해 앱을 열어두세요. 배포를 위해 앱을 열어두세요. Capgo 초보자 가이드 배포를 위해 앱을 열어두세요.

다음 단계

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

더 많은 정보를 얻으려면 다음을 확인하세요. Capgo 라이브 업데이트스 문서를 모두 검토하세요.다음으로 확인해야 할 몇 가지 주요 주제가 있습니다.

• 채널을 통해 업데이트를 대상화하는 방법
• 업데이트 동작을 커스터마이즈하는 방법
• 라이브 업데이트 롤백