앱 추가

요구 사항

Capgo를 시작하기 전에 다음 사항을 확인하세요:

• Capacitor 앱이 설치 및 설정되어 있어야 합니다. Capacitor 설정 방법 알아보기
• Node.js 20 이상 설치 완료
• 다음 중 하나의 개발 환경:
  • macOS가 Xcode(iOS 개발용) 및/또는 Android Studio(Android 개발용)를 사용하여
  • Linux Android Studio(Android 개발용)를 사용하여
  • Windows Android Studio(Android 개발용)를 사용하여

참고

Capacitor 대신 Cordova를 사용하시나요? Capgo 앱도 동일한 방식으로 생성한 후, @capgo/cordova-updater Capacitor 플러그인 대신 Cordova 프로젝트에 설치하세요.

Capgo 소개

Live Update까지 3단계

가이드 설정

1. 다음에서 계정을 생성하세요: https://capgo.app/register.

2. Init 명령어로 시작하기

   npx @capgo/cli@latest init [APIKEY]

   몇 가지 질문이 나타납니다. 자동 설정을 완료하기 위해 필요한 답변을 입력해 주세요.

3. live update 배포하기

팁

이 단계를 따라 하면 금방 설정을 마칠 수 있습니다. 진행 중 도움이 필요하시면 저희 지원 팀이 도와드리겠습니다. 즐거운 onboarding 되세요!

상세 Onboarding 가이드 CLI onboarding 프로세스에 대한 전체 단계별 가이드를 확인하세요

live update 배포하기 앱에 live update를 배포하는 방법을 알아보세요

수동 설정

init 명령어가 작동하지 않는 경우, 앱을 수동으로 추가할 수 있습니다.

1. CLI를 계정에 연결하세요:

   npx @capgo/cli@latest login [APIKEY]

2. 다음 명령어로 계정에 앱을 추가하세요:

   npx @capgo/cli@latest app add [APP_NAME]

3. 앱에 플러그인을 설치하세요:

   npm i @capgo/capacitor-updater

4. 플러그인을 설정하세요: capacitor.config

   {
     "plugins": {
       CapacitorUpdater: {
         "appId": "Your appID",
         "autoUpdate": "atBackground",
         "version": "1.0.0"
       }
     }
   }

   사용 가능한 모든 옵션 보기. 정보를 제공하지 않으면 자동으로 추론됩니다.

5. 앱에서 가능한 한 빨리 init 메서드를 호출하세요:

   import { CapacitorUpdater } from '@capgo/capacitor-updater';
   CapacitorUpdater.notifyAppReady();

6. live update 배포하기

이전 Capacitor 버전 설치하기

위 명령(3단계)은 Capacitor 8용 최신 버전(v8.x)을 설치합니다. 이전 Capacitor 버전을 사용하려면 적절한 npm 태그를 사용하세요:

# Capacitor 7
npm i @capgo/capacitor-updater@lts-v7

# Capacitor 6
npm i @capgo/capacitor-updater@lts-v6

# Capacitor 5
npm i @capgo/capacitor-updater@lts-v5

# Capacitor 4
npm i @capgo/capacitor-updater@lts-v4

각 플러그인의 메이저 버전은 Capacitor 메이저 버전과 일치합니다(v8 → Capacitor 8, v7 → Capacitor 7, v6 → Capacitor 6, v5 → Capacitor 5, v4 → Capacitor 4). 최신 버전 라인이 8.3.4, 일치하는 LTS 버전은 다음과 같습니다: 7.3.4 동일한 기능과 버그 수정이 포함됩니다. 업데이트 도구는 매월 미러링된 LTS 백포트를 제공하며, v7/v6/v5; lts-v4 Capacitor 4 버전은 해당 일정 외에도 계속 사용할 수 있습니다. 다른 Capgo 플러그인은 요청 시 백포트됩니다.

Capgo CLI 메이저 버전은 하지 마세요 플러그인 또는 Capacitor 메이저 버전과 일치해야 합니다. 항상 다음을 사용하세요: npx @capgo/cli@latest. 참조 Capgo 버전 관리 전체 정책은 다음을 참조하세요.

앱 추가 단계에서 계속하기

사용 중이라면 앱 추가 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우와, Capgo Native Build Capgo Native Builds의 제품 워크플로우를 위해.