__CAPGO_KEEP_0__

Capgo의 Live Updates 기능을 사용하여 앱의 UI 및 비즈니스 로직을 실시간으로 원격으로 업데이트할 수 있습니다. 앱 스토어를 통하지 않고도 바로 버그를 고치고 새로운 기능을 배포할 수 있습니다.

팁

Capgo은 생성된 웹 빌드 폴더를 업로드합니다. HTML, CSS, JavaScript, 자원 및 순수 자바 스크립트 패키지 변경은 OTA로 전송할 수 있습니다. 변경된 capacitor.config.ts, 네이티브 플러그인 구성, 네이티브 패키지 또는 iOS/Android 프로젝트 파일은 네이티브 앱 릴리즈가 필요합니다.

이 가이드는 Capgo 빠른 시작을 완료한 것으로 가정합니다. 그리고 이미:

1. 설치된 @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_1__ 앱 capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() __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 대시보드에 등록된 앱과 일치하는지
• 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__ Live Updates 문서의 나머지 부분을 확인하세요. Capgo Live Updates 문서의 나머지 부분을 확인하세요. __CAPGO_KEEP_0__ Live Updates 문서의 나머지 부분을 확인하세요.

__CAPGO_KEEP_0__ Live Updates 문서의 나머지 부분을 확인하세요.

Capgo Live Updates 문서의 나머지 부분을 확인하세요.

__CAPGO_KEEP_0__ Live Updates 문서의 나머지 부분을 확인하세요. Capgo Live Updates 문서의 나머지 부분을 확인하세요.. 다음에 체크할 주요 주제:

• 채널을 통해 업데이트 목표 설정
• 업데이트 동작을 커스터마이즈
• 라이브 업데이트 롤백

Deploy a Live Update

__CAPGO_KEEP_0__ CI/CD __CAPGO_KEEP_0__ CI/CD __CAPGO_KEEP_0__ Native Builds Capgo CI/CD를 사용하여 제품 워크플로우를 Capgo CI/CD와 연결 for the product workflow in Capgo CI/CD, Capgo Native Builds Capgo 네이티브 빌드 workflow에서 제품을 위한 Capgo 통합 Capgo 통합에서 제품 workflow를 위한 CI/CD 통합 __CAPGO_KEEP_0__ 통합에서 구현 세부 정보를 위한, 그리고 GitHub 액션 통합에서 구현 세부 정보를 위한. for the implementation detail in GitHub Actions Integration.