실시간 업데이트 배포

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

팁

Capgo은 생성된 웹 빌드 폴더를 업로드합니다. HTML, CSS, JavaScript, 자산 및 순수 자바 스크립트 패키지 변경은 OTA로 업데이트될 수 있습니다. Capgo capacitor.config.ts, native plugin configuration, native packages, or iOS/Android project files require a native app release.

이 가이드는 native plugin configuration, native packages, 또는 iOS/Android 프로젝트 파일이 native 앱 릴리즈를 필요로 할 때 사용됩니다. Capgo Quickstart 이 가이드는 __CAPGO_KEEP_0__ Quickstart를 완료하고 이미:

1. Capgo CLI를 설치했습니다. @capgo/capacitor-updater SDK를 Capacitor 앱에 설치했습니다.

2. __CAPGO_KEEP_0__에서 앱 ID와 업데이트 채널을 구성했습니다. capacitor.config.ts

3. code에서 method를 추가했습니다. CapacitorUpdater.notifyAppReady() 이미 위의 단계를 완료하지 않았다면, 먼저 __CAPGO_KEEP_0__ Quickstart를 완료하세요.

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

Capgo 계정에 앱을 추가하고 앱에 플러그인을 설치하세요. Add an app to your Capgo account, and install the plugin in your app

업로드하는 패키지

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

1. 웹 자산을 빌드하세요:

   npm run build

2. Capgo으로 패키지를 업로드하세요:

   __CAPGO_KEEP_2__

   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가 __CAPGO_KEEP_0__ 대시보드에 있는 앱과 일치하는지 capacitor.config.ts Capgo 프로젝트의 루트 디렉토리에서 업로드 명령을 실행하는지
• You’re running the upload command from the root of your Capacitor project
• 업로드 문제 해결

문제가 계속되면 문제 해결 페이지

업데이트를 받는 기기

업로드한 번들을 테스트할 수 있습니다.

1. 기기를 동기화하세요.

   npx cap sync ios

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

   npx @capgo/cli@latest app debug

3. 애플리케이션을 로컬에서 실행하세요:

   npx cap run ios

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

4. 업데이트를 다운로드하는 데 약 30초 정도 시간이 걸리므로 앱을 열어두세요.

5. 로그가 업데이트되는 데 몇 초가 걸리며 업데이트 상태를 표시합니다.

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

__CAPGO_KEEP_0__ Quickstart Capgo Quickstart 다음 단계

다음 단계

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

더 많은 정보를 얻으려면 다음을 검토하세요. Capgo 라이브 업데이트스 문서. 다음 주제를 확인하세요:

• 채널을 사용하여 업데이트를 대상하기
• 업데이트 동작을 맞춤화하기
• 라이브 업데이트 롤백

Deploy a Live Update에서 계속하기

Deploy a Live Update을 사용하여 CI/CD 자동화 계획을 만드는 경우 Deploy a Live Update을 연결하세요. Deploy a Live Update Capgo CI/CD Capgo CI/CD를 위한 제품 워크플로우 Capgo Native Builds Capgo Native Builds를 위한 제품 워크플로우 Capgo Integrations Capgo Integrations를 위한 제품 워크플로우 CI/CD 통합 __CAPGO_KEEP_0__ Actions Integration GitHub Actions Integration의 구현 세부 사항 for the implementation detail in GitHub Actions Integration.