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

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

빠른 설정: Capacitor CLI를 설치하고 프로젝트를 몇 분 만에 초기화할 수 있습니다.
플랫폼 통합: iOS와 Android 지원을 간단한 명령어로 추가할 수 있습니다.
__CAPGO_KEEP_0__: Use Capgo __CAPGO_KEEP_1__
일반적인 해결책: Sync 오류 또는 빌드 실패와 같은 문제를 해결하세요.

시작하기 위한 주요 단계:

설치 Node.js, npm, JDK Xcode, 그리고 안드로이드 스튜디오.
실행 npm install @capacitor/core @capacitor/cli iOS 및 Android 플랫폼을 사용하여 프로젝트를 초기화하세요.
프로젝트를 초기화하고 npx cap add ios 및 npx cap add android.
Optional: Capgo를 위한 Live Update 설정 앱 업데이트.

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

소개 Capacitor 설정

Capacitor 프레임워크 문서

설정 요구 사항

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

Node.js 14 이상의 버전)과 npm
자바 JDK 11 이상의 버전)
Xcode iOS 빌드용으로는 12 이상의 버전)
안드로이드 스튜디오 Android 빌드용)
Capacitor CLI 6 또는 7 버전)

선택사항: 실시간 업데이트 기능을 활성화하려면 "Capgo Capgo 가이드” below.

Capgo CLI 설치 단계

__CAPGO_KEEP_0__를 시작하기 전에 Node.js, npm, JDK, Xcode, 그리고 안드로이드 스튜디오 준비가 되면 Capacitor CLI를 설치할 수 있습니다.

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

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

이 단계를 완료한 후 다음 단계로 이동하세요. 새로운 프로젝트 만들기 애플리케이션을 구축하기 위해

새로운 프로젝트 만들기

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__을 사용하여 프로젝트를 시작하려면 다음 단계를 따르세요. Capacitor CLI파일을 편집하여 다음 설정을 포함하세요.

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

업데이트가 완료되면 __CAPGO_KEEP_0__을 프로젝트에 설정하기 위해 이 설정을 사용하세요.

플랫폼 설정 capacitor.config.json 파일을 포함하는 설정을 포함하는 파일

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

Capacitor은 __CAPGO_KEEP_1__을 사용하여 프로젝트를 시작하는 데 도움이 됩니다.

__CAPGO_KEEP_0은 CAPGO_KEEP_1__을 사용하여 프로젝트를 시작하는 데 도움이 됩니다.

이제 프로젝트의 기본 구조가 완성되었습니다. iOS와 Android 대상 설정 시간입니다.

iOS와 Android 추가

Capacitor CLI을 사용하여 필요한 플랫폼별 패키지를 설치하세요.

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

iOS에서 사용하려면 Xcode 14 이상이 설치되어야 합니다. Xcode 14 이상 CocoaPods 1.11 이상 macOS 12 이상

Android Studio Giraffe (2022.3.1+)

JDK 17 이상

Gradle

npm run build
npx cap sync

7.5 이상 cap sync 명령어는 두 가지 작업을 처리합니다:

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

IDE 설정

적절한 IDE에서 플랫폼별 프로젝트를 열어보세요:

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

Xcode에서:

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

Android Studio에서:

응용 프로그램 ID를 수정하세요. build.gradle.
인증서를 위한 키 스토어를 구성하세요.
설정 BOTH debug 및 release 빌드 변형.

모든 것이 구성되면 프로젝트를 사용하여 npx cap build ios 또는 npx cap build androidCapacitor Live Update 대안 npx cap sync 모든 것이 구성되면 프로젝트를 사용하여

Capgo 설정 가이드

Capgo Live Update 대시보드 인터페이스

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

Capgo의 주요 기능

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

끝에서 끝까지 암호화 업데이트를 안전하게 전달합니다.
업데이트는 배경에서 실행됩니다. 앱이 시작될 때
분석 도구는 업데이트 성공률과 사용자 참여도를 추적하는 데 도움이 됩니다.
A 문제가 있는 업데이트에서 빠르게 복구할 수 있는 옵션입니다. 채널 시스템을 사용하여
Capacitor CLI 업데이트는 배경에서 실행됩니다. 앱이 시작될 때

Capgo

Capgo CLI:
```
npm install --save @capgo/cli
```
Capgo __CAPGO_KEEP_0__
```
npx capgo init
```
__CAPGO_KEEP_0__
```
npm run build
npx capgo release
```
__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__

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

일반적인 문제와 팁

플랫폼과 Capgo 설정을 완료한 후, 일반적인 오류를 마주칠 수 있습니다. 이들을 빠르게 해결하는 방법을 알려드리겠습니다.

환경 설정 오류

CLI 찾을 수 없음 오류: 명령어 npx cap 실패합니다. 해결책: Run npm install --save @capacitor/cli @capacitor/core 및 다시 시도해 보세요.
Node 버전 불일치 오류: CLI 명령이 Node.js 버전 오류로 실패합니다. 수정: Node.js 버전 14 이상을 설치하십시오. 자세한 설치 요구 사항은 아래를 참조하십시오.

설정 문제

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

빌드 인증 실패

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

Live Update 문제

Capgo 업데이트 실패 오류: 프로덕션 앱에서 업데이트가 나타나지 않는다. 수정: __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 키를 확인하고 올바른 채널을 대상으로 하도록 하시오. Capgo API 키 요약 capacitor.config.json 설정 검토

웹 앱을 Capgo __CAPGO_KEEP_1__으로 시작하고 iOS 및 Android 플랫폼을 설정하고, 라이브 업데이트 기능을 포함하고 싶으시면 __CAPGO_KEEP_2__를 추가하시기 바랍니다.

Summary

오류

웹 앱을 시작하세요. Capacitor CLI을 사용하여 iOS 및 Android 플랫폼을 설정하고, 옵션적으로 Capgo를 포함하여 실시간 업데이트 기능을 활성화하세요.

수정

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

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