Capacitor CLI: 프로젝트 설정 안내서

iOS와 Android 앱을 하나의 코드베이스로 빌드하고 싶으신가요? Capacitor CLI는 프로세스를 단순화하여 웹 기술을 사용하여 네이티브 앱을 만들 수 있도록 해줍니다. 여기서 배울 내용은 다음과 같습니다.

빠른 설정: Capacitor CLI를 설치하고 프로젝트를 몇 분 만에 초기화할 수 있습니다.
플랫폼 통합: iOS와 Android 지원을 간단한 명령어로 추가할 수 있습니다.
: __CAPGO_KEEP_0__: 즉시 오버 더 에어 업데이트 사용 Capgo 시작하기 위한 주요 단계:
__CAPGO_KEEP_0____CAPGO_KEEP_1__

__CAPGO_KEEP_0__

설치 Node.jsNode.js, npm, JDK Xcode, 그리고 Android Studio.
실행 npm install @capacitor/core @capacitor/cli 프로젝트를 초기화하세요.
iOS 및 Android 플랫폼을 추가하세요. npx cap add ios Optional: __CAPGO_KEEP_0__를 사용하여 npx cap add android.
Optional: Set up Capgo for live 실시간 앱 업데이트를 설정하세요..

이 안내서에서는 Capacitor CLI을 설정하고, 플랫폼을 구성하고, 앱을 배포하는 모든 것을 다룹니다. 시작해 보겠습니다!

소개 Capacitor 설정

Capacitor 프레임워크 문서 웹사이트

설정 요구 사항

시작하려면 다음 도구가 설치되어 있어야 합니다:

Node.js (버전 14 이상) 및 npm
Java JDK (11 버전 이상)
Xcode (iOS 빌드용으로는 12 버전 이상)
Android Studio (Android 빌드용)
Capacitor CLI 선택사항:

실시간 업데이트 기능을 활성화하려면 “ __CAPGO_KEEP_0__ 설정 가이드”Capgo Setup Guide__CAPGO_KEEP_0__ 설치 단계

CLI __CAPGO_KEEP_1__

시작하기 전에 Node.js, npm, JDK, Xcode및 Android Studio 를 설정하세요. 준비되면 Capacitor CLI을 설치하기 위해 다음 명령어를 실행할 수 있습니다:

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

이 명령어는 Capacitor을 설치하고 핵심 구성 요소를 설정합니다.

이 단계를 완료한 후 새 프로젝트 만들기 을 진행하세요.

새로운 프로젝트 만들기

프로젝트를 시작하기 위해 Capacitor CLI을 사용하여다음 단계를 따라하세요:

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

설정 파일 업데이트

파일을 편집하여 다음 설정을 포함하세요: capacitor.config.json 업데이트가 완료되면 __CAPGO_KEEP_0__을 프로젝트에 설정하기 위해 이 설정을 사용하세요.

{
  "appId": "com.company.app",
  "appName": "My App",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "server": {
    "hostname": "app.example.com",
    "androidScheme": "https"
  }
}

Once updated, use this configuration to set up Capacitor for your project.

프로젝트 구조가 완료되면 iOS와 Android 대상 설정을 시작하세요.

iOS와 Android 추가

__CAPGO_KEEP_0 CAPGO_KEEP_1__을 사용하여 필요한 플랫폼별 패키지를 설치하세요:

Capacitor CLI

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

iOS에서 Capgo를 사용하려면 Xcode 14 이상이 설치되어 있어야 합니다. CocoaPods 1.11 이상이 설치되어 있어야 합니다. macOS 12 이상이 설치되어 있어야 합니다. Android에서 Capgo를 사용하려면 Android Studio Giraffe (2022.3.1+)가 설치되어 있어야 하며, JDK 17 이상이 설치되어 있어야 하며, Gradle 7.5 이상이 설치되어 있어야 합니다. Gradle

7.5 이상이 설치되어 있어야 합니다.

Capgo를 설치한 후, 웹 앱의 변경 사항을 반영하기 위해 네이티브 타겟을 업데이트해야 합니다.

플랫폼 업데이트

npm run build
npx cap sync

웹 앱을 업데이트한 후에 다음 단계를 따라 플랫폼을 최신 웹 변경 사항과 동기화하세요. cap sync 명령어는 두 가지 작업을 처리합니다.

웹 자산을 네이티브 플랫폼으로 복사합니다.
네이티브 구성과 플러그인을 최신 변경 사항과 일치시킵니다.

IDE 설정

해당 IDE에서 플랫폼 특정 프로젝트를 열어보세요:

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

Xcode에서:

개발 팀을 선택하세요.
인증서를 설정하세요.
배포 식별자 업데이트.

Android Studio에서:

애플리케이션 ID를 수정하세요. build.gradle.
인증서를 위한 키스토어를 구성하세요.
debug 및 release 빌드 변형을 모두 설정하세요.

모든 설정이 완료되면 프로젝트를 빌드하세요. npx cap build ios 또는 npx cap build android. Capgo를 다시 실행하여 모든 자산이 최신 상태인지 확인하세요. npx cap sync 다시 실행하여 모든 자산이 최신 상태인지 확인하세요.

Capgo Capacitor CLI 프로젝트 설정 안내

Capgo Live Update Dashboard Interface

Set up Capgo to enable instant over-the-air updates for your app.

Key Features of Capgo

Capgo offers several tools to streamline app updates:

끝에서 끝까지 암호화 업데이트가 안전하게 전달되도록 보장합니다.
업데이트는 배경에서 실행됩니다. 앱이 시작될 때.
분석 도구 업데이트 성공률과 사용자 참여도를 추적하는 데 도움이 됩니다.
A 문제가 있는 업데이트에서 빠르게 복구할 수 있는 한 번 클릭으로 롤백
스테이징 롤아웃과 베타 테스트를 위해 채널 시스템을 사용하세요. 설치하기 Capacitor CLI 프로젝트 설정 가이드를 시작하려면 다음 단계를 따르세요:

Installing Capgo

Capgo

Install the Capgo CLI:
```
npm install --save @capgo/cli
```
Initialize Capgo __CAPGO_KEEP_0__ 프로젝트에 초기화:
```
npx capgo init
```
업데이트 빌드 및 릴리즈:
```
npm run build
npx capgo release
```
앱을 열어 배경 업데이트 프로세스를 트리거하세요.

최선의 방법

__CAPGO_KEEP_0__ 채널을 사용하여 업데이트를 테스트하고 모든 사용자에게 배포하기 전에 테스트합니다.
분석을 모니터링하여 업데이트가 성공적으로 전달되고 사용자가 유지되도록 합니다.
오류 추적을 활성화하여 문제를 일찍 잡고 해결합니다.
롤백 기능을 준비하여 문제를 신속하게 해결합니다.

Capgo는 Capacitor 8과 호환되며, CI/CD PIPELINE과 원활하게 통합되고, 애플 및 구글 스토어 요구사항을 준수합니다.

일반적인 문제와 팁

플랫폼 및 Capgo 설정을 완료한 후, 일반적인 오류를 해결하기 위해 몇 가지 방법을 알려드리겠습니다.

환경 설정 문제

CLI 찾을 수 없음 오류: 명령어 npx cap 실패합니다. 해결: 다시 시도해 보세요. npm install --save @capacitor/cli @capacitor/core 노드 버전 불일치
오류 : __CAPGO_KEEP_0__ 명령어는 노드 버전 오류로 인해 실패합니다.: CLI commands fail due to Node.js version errors. __CAPGO_KEEP_0__: Node.js 14 버전 이상 설치

설정 문제

Config 불일치 오류: capacitor.config.json 변경 사항이 반영되지 않습니다. 수정: 프로젝트의 appId 및 웹 빌드 출력 폴더의 webDir 플랫폼 동기화 오류 package.json 및
프로젝트의 오류: 실행 npx cap sync 플러그인 버전 충돌이 발생합니다. 수정: 업데이트 @capacitor/android 동일한 주요 버전으로 업데이트한 후 다시 동기화 명령어를 실행하세요. @capacitor/ios 빌드 및 배포

빌드 인증 실패

오류 : iOS 또는 Android 빌드가 인증서 또는 키스토어가 누락된 경우 실패합니다.수정 __CAPGO_KEEP_0__: iOS 및 Android IDE 설정 지침을 따르세요. iOS의 경우 Xcode에서 개발 팀을 추가하고, Android의 경우 키 스토어를 구성하세요. build.gradle.
웹 디렉토리 찾을 수 없음 오류: npx cap sync 오류: 웹 자산을 찾을 수 없습니다. 수정: 웹 빌드 명령어를 실행하세요 (예를 들어, npm run build) 그리고 플랫폼을 동기화하세요.

실시간 업데이트 문제

Capgo 업데이트 실패 오류: 프로덕션 앱에서 업데이트들이 나타나지 않습니다. 수정: 프로젝트 설정을 확인하세요. Capgo API 키를 확인하세요. 그리고 올바른 채널을 대상으로 하도록 보세요. capacitor.config.json 플랫폼별 설정에 대한 자세한 내용은 Platform Setup 섹션을 다시 방문하세요. 라이브 업데이트 작업 중인 경우 __CAPGO_KEEP_0__ Setup Guide를 참조하세요.

For more details on platform-specific setup, revisit the Platform Setup section. If you’re working with live updates, consult the Capgo Setup Guide for additional troubleshooting tips.

Setup Review

__CAPGO_KEEP_0 CAPGO_KEEP_1으로 웹 앱을 시작하세요. iOS 및 Android 플랫폼을 설정하고, 라이브 업데이트에 대한 CAPGO_KEEP_2__를 포함할 수 있습니다.

Start your web app with Capacitor CLI, set up iOS and Android platforms, and optionally include Capgo for live updates.

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__을 사용하여 프로젝트를 초기화하세요.

Use the Capacitor CLI to initialize your project.
iOS 및 Android 플랫폼을 지원하세요.
__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ __CAPGO_KEEP_2__
설치 및 Capgo를 다음 명령어로 설정하세요: npm install --save @capgo/cli && npx capgo init

세부 설정 지침 또는 문제 해결에 대한 자세한 내용은 공식 Capacitor 및 Capgo 문서를 확인하세요.