실시간 업데이트 배포

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

팁

Capgo은 생성된 웹 빌드 폴더를 업로드합니다. HTML, CSS, JavaScript, 자산, 및 순수 자바 스크립트 패키지 변경은 OTA로 업데이트될 수 있습니다. native 플러그인 구성, native 패키지, 또는 iOS/Android 프로젝트 파일의 변경은 native 앱 릴리스가 필요합니다. capacitor.config.ts이 가이드는 __CAPGO_KEEP_0__이 완료된 것으로 가정합니다.

__CAPGO_KEEP_0__ Capgo Quickstart 그런 다음에:

1. __CAPGO_KEEP_0__을 설치하고 @capgo/capacitor-updater SDK을 사용하여 Capacitor 앱에 SDK을 설치했습니다.

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

3. code에 code을 추가했습니다. CapacitorUpdater.notifyAppReady() 메소드

이미 위의 단계를 완료하지 않았다면, 먼저 __CAPGO_KEEP_0__ 퀵스타트를 완료하세요.

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

제목: "업로드하는 번들"

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
• 앱 ID가 Capacitor 대시보드에 있는 앱과 일치하는지 확인하세요.
• 업로드 명령어를 __CAPGO_KEEP_0__ 프로젝트의 루트 디렉토리에서 실행 중인지 확인하세요.

웹 자산이 빌드되고 최신인지 확인하세요. 문제가 여전히 발생한다면 "업로드 문제 해결"로 이동하세요. section.

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

1. __CAPGO_KEEP_0__

   npx cap sync ios

2. __CAPGO_KEEP_0__

   npx @capgo/cli@latest app debug

3. __CAPGO_KEEP_0__

   npx cap run ios

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

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

5. 로그가 업데이트되서 업데이트 상태를 보여주는데 몇 초 정도 걸립니다.

6. 앱을 닫고 다시 열어보세요. __CAPGO_KEEP_0__ live update가 적용된 것을 확인할 수 있을 것입니다!

__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ Capgo Quickstart ‘다음 단계’라는 제목의 섹션

__CAPGO_KEEP_0__으로 첫 번째 live update를 성공적으로 배포했습니다! 🎉

Congrats on deploying your first live update with Capgo! 🎉

‘다음 단계’라는 제목의 섹션 Capgo Live Updates 문서. 다음에 체크할 주요 주제:

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

__CAPGO_KEEP_0__ Live Update를 계속 진행하는 방법

이러한 경우 __CAPGO_KEEP_0__ Live Update를 사용하고 있습니다. __CAPGO_KEEP_0__ Live Update를 사용하여 CI/CD 자동화 계획을 수립하고 __CAPGO_KEEP_0__ CI/CD와 연결하여 Capgo CI/CD에서 제품 워크플로우 Capgo Live Update를 계속 진행하는 방법 Capgo Native Builds 제품 워크플로우를 위한 Capgo Native Builds Capgo Integrations 제품 워크플로우를 위한 Capgo Integrations CI/CD 통합 CI/CD 통합 구현 세부 사항을 위한 GitHub Actions 통합 구현 세부 사항을 위한 GitHub Actions 통합