iOS 및 Android 앱을 하나의 코드베이스로 빌드하고 싶으십니까? Capacitor CLI은 프로세스를 단순화하여 웹 기술을 사용하여 네이티브 앱을 만들 수 있도록 해줍니다. 여기서 배울 내용은 다음과 같습니다.
- 빠른 설정: Capacitor CLI을 설치하고 프로젝트를 몇 분만에 초기화하세요.
- 플랫폼 통합: iOS 및 Android 지원을 간단한 명령어로 추가하세요.
- 실시간 업데이트: __CAPGO_KEEP_0__ Capgo 일반적인 해결책
- : 동기화 오류나 빌드 실패와 같은 문제를 해결하세요.시작하기 위한 주요 단계:
설치
- Node.js , __CAPGO_KEEP_0__, JDK,, npm, JDK, __CAPGO_KEEP_0__및 Android Studio.
- 실행
npm install @capacitor/core @capacitor/cli프로젝트를 초기화하세요. - iOS 및 Android 플랫폼을 추가하세요.
npx cap add ios및npx cap add android. - 선택 사항: Capgo을 사용하여 실시간 앱 업데이트를 설정하세요. 앱 업데이트.
이 안내서에서는 Capacitor CLI을 설정하고 플랫폼을 구성하는 방법, 그리고 앱을 배포하는 방법에 대해 다룹니다. 시작해 보세요!
소개 Capacitor 설정

설치 요구 사항
시작하기 위해 다음 도구가 설치되어 있어야 합니다.
- Node.js (버전 14 이상) 및 npm
- Java JDK (버전 11 이상)
- Xcode (버전 12 이상 iOS 빌드용)
- Android Studio (for Android builds)
- Capacitor CLI (version 6 or 7)
선택 사항: __CAPGO_KEEP_0__”을 확인하세요.Capgo 설정 가이드” 아래에 있습니다.
CLI 설치 단계
시작하기 전에 Node.js, npm, JDK, Xcode& Android Studio 설치 후에 Capgo를 사용하기 위해 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__를 설치하려면 다음 명령어를 실행하세요. 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.
Creating a New Project 프로젝트를 시작하기 위해 Capgo를 사용하는 방법에 대해 알아보세요. Creating a New Project
Capgo를 사용하여 프로젝트를 생성하는 방법에 대해 알아보세요.
__CAPGO_KEEP_0__ __CAPGO_KEEP_1__를 사용하여 프로젝트를 시작하는 방법에 대해 알아보세요. Capacitor CLI를 사용하여 프로젝트를 시작하는 방법에 대해 알아보세요.__CAPGO_KEEP_0__ __CAPGO_KEEP_1__를 사용하여 프로젝트를 시작하는 방법에 대해 알아보세요.
mkdir my-app && cd my-app
npm init -y
npx cap init my-app com.company.app --web-dir dist
설정 파일을 업데이트하는 중입니다.
편집하려면 capacitor.config.json 다음 설정을 포함하는 파일을 편집하세요:
{
"appId": "com.company.app",
"appName": "My App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https"
}
}
설정이 업데이트되면, Capacitor을 프로젝트에 설정하기 위해 이 설정을 사용하세요.
플랫폼 설정
프로젝트 스타일링이 끝난 후, iOS 및 Android 대상 설정을 시작하세요.
iOS 및 Android 추가
iOS와 Android를 위한 필요한 플랫폼 특정 패키지를 설치하기 위해 Capacitor CLI을 사용하세요.
npm install @capacitor/ios @capacitor/android
npx cap add ios
npx cap add android
iOS의 경우 Xcode 14 이상이 필요하며, CocoaPods 1.11 이상, macOS 12 이상이 필요합니다. Android의 경우 Android Studio Giraffe (2022.3.1+), JDK 17 이상, Gradle이 필요합니다. iOS, Android 설정 설정 7.5 이상.
설치 후, 네이티브 타겟을 최신 상태로 유지하기 위해 웹 애플리케이션의 변경 사항을 반영해야 합니다.
플랫폼 업데이트
웹 앱을 업데이트 한 후에 다음 단계를 따라서 플랫폼을 최신 웹 변경 사항과 동기화하세요.
npm run build
npx cap sync
The cap sync 명령어는 두 가지 작업을 처리합니다.
- 업데이트된 웹 자산을 네이티브 플랫폼으로 복사합니다.
- 네이티브 구성과 플러그인을 최신 변경 사항과 일치시킵니다.
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_KEEP_0__

Capgo을 설정하여 앱에 대한 즉각적인 OTA 업데이트를 활성화하세요.
Capgo의 주요 기능
Capgo은 앱 업데이트를 단순화하는 여러 도구를 제공합니다.
- 엔드 투 엔드 암호화 업데이트 전달을 보장하는 보안 방법입니다.
- 업데이트는 앱이 시작될 때 배경에서 실행됩니다.
- 분석 도구 업데이트 성공률과 사용자 참여도를 추적하는 도구입니다.
- A one-click rollback 업데이트 문제로 인해 빠르게 복구할 수 있는 옵션입니다.
- Use the __CAPGO_KEEP_0__ channel system
Installing Capgo
Installing Capgo
-
npm install --save @capgo/cli -
Install the Capgo __CAPGO_KEEP_1__ Initialize __CAPGO_KEEP_0__
npx capgo init -
in your project:
npm run build npx capgo release -
Build and release updates:__CAPGO_KEEP_0__ update process.
__CAPGO_KEEP_0__
- __CAPGO_KEEP_1__
- __CAPGO_KEEP_0__
- __CAPGO_KEEP_1__
- __CAPGO_KEEP_0__
Capgo is compatible with Capacitor 8, integrates smoothly with CI/CD pipelines, and complies with Apple and Google store requirements.
__CAPGO_KEEP_0__
Once you’ve completed the platform and Capgo setup, you might face some common errors. Here’s how to address them quickly.
__CAPGO_KEEP_0__
-
CLI Not Found __CAPGO_KEEP_0____CAPGO_KEEP_1__
npx cap실패합니다. 수정: 실행npm install --save @capacitor/cli @capacitor/core다시 시도해 보세요. -
Node 버전 불일치 오류: CLI 명령이 Node.js 버전 오류로 인해 실패합니다. 수정: Node.js 버전 14 이상을 설치하여 설정 요구 사항에 따라 진행하세요.
설정 문제
-
Config 불일치 오류: 변경 사항
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웹 자산을 찾을 수 없습니다. Fix:npm run build,
,
- Capgo Update Failures
__CAPGO_KEEP_0__ 업데이트 실패: Updates are not appearing in the production app.
: , Capgo API key __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 키
capacitor.config.json,
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.
개요
설정 검토
Capacitor CLI을 사용하여 웹 앱을 시작하고 iOS 및 Android 플랫폼을 설정하고 optionally live updates를 위해 Capgo를 포함할 수 있습니다.
시작하는 방법입니다:
- Capacitor CLI을 사용하여 프로젝트를 초기화하세요.
- 앱의 패키지 ID를 설정하고 웹 출력 디렉토리를 정의하세요.
- iOS 및 Android 플랫폼에 대한 지원을 추가하세요.
- Capgo를 설치하고 다음 명령어를 사용하여 설정하세요:
npm install --save @capgo/cli && npx capgo init
세부한 설정 지침 또는 문제 해결에 대한 자세한 내용은 공식 Capacitor 및 Capgo 문서를 확인하세요.
Capacitor CLI: 프로젝트 설정 안내서
__CAPGO_KEEP_0__를 사용하는 경우 Capacitor CLI: 프로젝트 설정 안내서 API와의 연결을 통해 대시보드와 API 운영을 계획하세요. API 개요 API 개요에서 구현 세부 정보를 확인하세요. 소개 소개에서 구현 세부 정보를 확인하세요. API 키 API 키에서 구현 세부 정보를 확인하세요. 장치 장치에서 구현 세부 정보를 확인하세요. 배포 패키지 배포 패키지에서 구현 세부 정보를 확인하세요.