npm install --save @capacitor/core @capacitor/cli
npx cap init

mkdir my-app && cd my-app
npm init -y
npx cap init my-app com.company.app --web-dir dist

npm install @capacitor/ios @capacitor/android
npx cap add ios
npx cap add android

npm run build
npx cap sync

npx cap open ios     # Opens Xcode
npx cap open android # Opens Android Studio

    npm install --save @capgo/cli
    ```

2. 프로젝트에서 [Capgo 초기화](https://capgo.app/docs/webapp/):

```bash
    npx capgo init
    ```

3. 업데이트 빌드 및 배포:

```bash
    npm run build
    npx capgo release
    ```

4. 백그라운드 업데이트 프로세스를 시작하기 위해 앱을 여세요.

### 모범 사례

-   모든 사용자에게 배포하기 전에 채널을 사용하여 업데이트를 테스트하세요.
-   업데이트가 성공적으로 전달되고 사용자가 계속 참여하는지 확인하기 위해 분석을 모니터링하세요.
-   문제를 조기에 발견하고 수정하기 위해 오류 추적을 활성화하세요.
-   문제를 빠르게 해결하기 위해 롤백 기능을 준비하세요.

Capgo는 Capacitor 6과 7을 지원하며, CI/CD 파이프라인과 원활하게 통합되고, Apple과 Google 스토어 요구사항을 준수합니다.

## 일반적인 문제와 팁

플랫폼과 Capgo 설정을 완료한 후에는 몇 가지 일반적인 오류에 직면할 수 있습니다. 다음은 이를 빠르게 해결하는 방법입니다.

### 환경 설정 문제

-   **CLI를 찾을 수 없음**
    **오류**: `npx cap` 명령이 실패합니다.
    **해결**: `npm install --save @capacitor/cli @capacitor/core`를 실행하고 다시 시도하세요.

-   **Node 버전 불일치**
    **오류**: Node.js 버전 오류로 인해 CLI 명령이 실패합니다.
    **해결**: 설정 요구사항에 명시된 대로 Node.js 버전 14 이상을 설치하세요.

### 구성 문제

-   **구성 불일치**
    **오류**: `capacitor.config.json`의 변경사항이 적용되지 않습니다.
    **해결**: `appId`와 `webDir` 값이 프로젝트의 `package.json`과 웹 빌드 출력 폴더와 일치하는지 확인하세요.

-   **플랫폼 동기화 오류**
    **오류**: `npx cap sync` 실행 시 플러그인 버전 충돌이 발생합니다.
    **해결**: `@capacitor/android`와 `@capacitor/ios`를 동일한 메이저 버전으로 업데이트한 후 동기화 명령을 다시 실행하세요.

### 빌드 및 배포

-   **빌드 서명 실패**
    **오류**: 인증서나 키스토어가 없어 iOS 또는 Android 빌드가 실패합니다.
    **해결**: IDE 설정 지침을 따르세요. iOS의 경우 Xcode에서 개발 팀을 추가하고, Android의 경우 `build.gradle`에서 키스토어를 구성하세요.

-   **웹 디렉토리를 찾을 수 없음**
    **오류**: `npx cap sync`가 웹 자산을 찾을 수 없습니다.
    **해결**: 플랫폼을 동기화하기 전에 웹 빌드 명령(예: `npm run build`)을 실행하세요.

### 실시간 업데이트 문제

-   **[Capgo 업데이트 실패](https://capgo.app/docs/plugin/cloud-mode/manual-update/)**
    **오류**: 프로덕션 앱에서 업데이트가 나타나지 않습니다.
    **해결**: `capacitor.config.json`에서 [Capgo API 키](https://capgo.app/docs/webapp/api-keys/)를 다시 확인하고 올바른 채널을 대상으로 하고 있는지 확인하세요.

플랫폼별 설정에 대한 자세한 내용은 플랫폼 설정 섹션을 다시 확인하세요. 실시간 업데이트 작업을 하고 있다면 추가 문제 해결 팁을 위해 Capgo 설정 가이드를 참조하세요.

## 요약

### 설정 검토

Capacitor CLI로 웹 앱을 시작하고, iOS와 Android 플랫폼을 설정하고, 선택적으로 실시간 업데이트를 위해 Capgo를 포함하세요.

시작하는 방법은 다음과 같습니다:

-   Capacitor CLI를 사용하여 프로젝트를 초기화하세요.
-   앱의 패키지 ID를 설정하고 웹 출력 디렉토리를 정의하세요.
-   iOS와 Android 플랫폼에 대한 지원을 추가하세요.
-   다음 명령어로 Capgo를 설치하고 설정하세요: `npm install --save @capgo/cli && npx capgo init`

자세한 설