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

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

빠른 설정: Capacitor를 CLI로 설치하고 프로젝트를 몇 분 만에 초기화하세요.
플랫폼 통합: 간단한 명령어로 iOS 및 Android 지원을 추가하세요.
실시간 업데이트: __CAPGO_KEEP_0__를 사용하여 즉시 오버 더 에어 업데이트. Capgo : 동기화 오류나 빌드 실패와 같은 문제를 해결하세요.
시작하기 위한 주요 단계:iOS 및 Android 앱을 만들기 위한 __CAPGO_KEEP_0__의 주요 기능은 다음과 같습니다.

iOS 및 Android 앱을 만들기 위한 __CAPGO_KEEP_0__의 주요 기능은 다음과 같습니다.

설치 Node.jsnpm JDKXcode 및.
Android Studio npm install @capacitor/core @capacitor/cli 실행하고 프로젝트를 초기화하세요.
iOS 및 Android 플랫폼을 추가하세요. npx cap add ios 및 npx cap add android.
선택 사항: 라이브 앱 업데이트를 위해 Capgo를 설정하세요. app updates.

이 안내서에서는 Capacitor CLI을 설정하는 방법, 플랫폼을 구성하는 방법, 그리고 앱을 배포하는 방법에 대해 다룹니다. 시작해 보세요!

소개 Capacitor __CAPGO_KEEP_0__ 프레임워크 문서 사이트

Capacitor Framework Documentation Website

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

Node.js

(버전 14 이상) 및 __CAPGO_KEEP_0__ npm
__CAPGO_KEEP_1__ (11 이상의 버전)
Xcode (12 이상의 iOS 빌드용)
Android Studio (Android 빌드용)
Capacitor CLI (6 또는 7 버전)

선택 사항: 실시간 업데이트 활성화하려면 "Capgo 설정 가이드"" 아래를 참조하세요.

CLI 설치 단계

__CAPGO_KEEP_0__ Node.js, npm, __CAPGO_KEEP_1__, CloudflareCapacitor GitHub set up. Once ready, you can install the Capacitor CLI by running:

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

This command installs Capacitor and sets up its core components.

API SDK CLI

새로운 프로젝트 만들기

프로젝트를 시작하기 위해 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

For iOS, __CAPGO_KEEP_0__ Xcode 14 이상이 있어야 합니다. CocoaPods 1.11 이상, 그리고 macOS 12 이상이 필요합니다. For Android, Android Studio Giraffe (2022.3.1+)가 필요하며, JDK 17 이상, 그리고 Gradle 7.5 이상이 필요합니다. 설치 후, 웹 앱의 변경 사항을 반영하기 위해 네이티브 타겟을 최신 상태로 유지해야 합니다.

플랫폼 업데이트

웹 앱을 업데이트 한 후에 다음 단계를 따라 플랫폼을 최신 웹 변경 사항과 동기화하세요.

명령어는 두 가지 작업을 처리합니다.

npm run build
npx cap sync

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

__CAPGO_KEEP_0__
__CAPGO_KEEP_0__

IDE 설정

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

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

Xcode에서:

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

Android Studio에서:

애플리케이션 ID를 수정하세요. build.gradle.
인증서를 위한 키스토어를 구성하세요.
디버그 및 릴리스 빌드 버전을 모두 설정하세요.

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

Capgo 설치 가이드

Capgo Live Update Dashboard Interface

Capgo을 설정하여 앱에 대한 즉시 OTA 업데이트를 활성화하세요.

Capgo의 주요 기능

Capgo은 앱 업데이트를 단순화하는 여러 도구를 제공합니다.

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

Capgo __CAPGO_KEEP_1__를 설치하세요.

Capgo

Install the Capgo CLI:
```
npm install --save @capgo/cli
```
Capgo을 초기화하세요. __CAPGO_KEEP_0__을 프로젝트에 추가하세요:
```
npx capgo init
```
업데이트를 빌드하고 배포하세요:
```
npm run build
npx capgo release
```
앱을 열면 배경 업데이트 프로세스를 트리거합니다.

최선의 방법

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

Capgo은 Capacitor 8과 호환되며 CI/CD pipeline과 원활하게 통합되고 Apple 및 Google 스토어 요구 사항을 준수합니다.

일반적인 문제와 팁

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

환경 설정 문제

CLI이(가) 없습니다 오류: 명령어 npx cap 실패했습니다. 해결: 다시 시도해 보세요. npm install --save @capacitor/cli @capacitor/core Node 버전 불일치
오류 : __CAPGO_KEEP_0__ 명령어는 Node.js 버전 오류로 실패합니다.: CLI commands fail due to Node.js version errors. Node.js 버전이 맞지 않습니다. __CAPGO_KEEP_0__ 명령어를 실행하려면 Node.js 버전을 업데이트하거나 변경해야 합니다.: __CAPGO_KEEP_0__ 버전 14 이상을 설치하십시오. (설정 요구 사항을 참조하십시오.)

설정 문제

구성 불일치 오류: __CAPGO_KEEP_0__에 대한 변경 사항이 capacitor.config.json 적용되지 않습니다. 수정: 프로젝트의 __CAPGO_KEEP_0__과 웹 빌드 출력 폴더의 __CAPGO_KEEP_1__이 일치하는지 확인하십시오. appId 플랫폼 동기화 오류 webDir Fix package.json Error
Config Mismatch 오류: 실행 npx cap sync 는 플러그인 버전 충돌로 발생합니다. 수정: 동일한 주요 버전으로 업데이트 한 후 다시 동기화 명령을 실행하세요. @capacitor/android 빌드 및 배포 @capacitor/ios 빌드 인증 실패

오류

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

실시간 업데이트 문제

Capgo 업데이트 실패 오류: 프로덕션 앱에서 업데이트들이 나타나지 않습니다. 수정: 확인해 보세요. Capgo API 키 에서 capacitor.config.json 그리고 올바른 채널을 대상으로 확인하세요.

플랫폼별 설정에 대한 자세한 내용은 Platform Setup 섹션을 다시 방문하세요. 라이브 업데이트와 관련된 작업을 하는 경우 Capgo Setup Guide를 참조하여 추가적인 문제 해결 팁을 확인하세요.

요약

설정 검토

Capacitor CLI을 사용하여 웹 앱을 시작하세요. iOS 및 Android 플랫폼을 설정하고, 라이브 업데이트를 포함하기 위해 Capgo를 선택적으로 추가하세요.

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

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

Capacitor 공식 문서나 문제 해결에 대한 자세한 설명은 공식 Capacitor 및 Capgo 문서를 확인하세요.