싱글 코드베이스로 모바일 앱을 만들고 싶으신가요? Capacitor iOS, Android, 및 웹 앱을 만들기 위해 프레임워크처럼 React, Angular, 또는 Vue. 이 안내서에서는 Capacitor을 설정하고 플랫폼을 구성하고 업데이트를 효율적으로 배포하는 방법을 설명합니다.
시작하기 위한 주요 단계:
- 도구 설치: Node.js, npm, Git, 및 code 에디터와 같은 VS Code.
- Capacitor 설정: Capacitor CLI 설치 및 프로젝트 초기화
- 플랫폼 구성: iOS 및 Android 지원 추가, 설정 조정, code 동기화
- 테스트 및 배포: 기기에서 빌드, 실행, __CAPGO_KEEP_0__와 같은 라이브 업데이트 도구 사용 Capgo __CAPGO_KEEP_0__는 웹 앱과 네이티브 디바이스 기능을 연결하여 플랫폼 간에 smooth한 성능을 보장합니다. 이 가이드를 따라해 앱 개발 과정을 단순화하세요!
Capacitor bridges web apps with native device features, ensuring smooth performance across platforms. Follow this guide to simplify your app development process!
__CAPGO_KEEP_0__ CAPACITOR | Ionic Release Guide

필수 도구 및 설정
개발 환경을 설정하는 방법입니다. 개발에 필요한 필수 도구를 설치하는 방법을 알려드립니다.
개발 도구 설치
Capacitor를 사용하기 위해서는 다음 도구가 필요합니다.
| 도구 | 목적 | 최소 버전 |
|---|---|---|
| Node.js | 자바스크립트 런타임 환경 | 14.0.0 이상 |
| npm | 패키지 매니저 | 6.0.0 이상 |
| IDE/ Code 에디터 | 개발 환경 | 최신 안정 버전 |
| Git | 버전 관리 | 2.0.0 이상 |
다음 단계를 따라서 설치하세요:
- Node.js 및 npm: Node.js 공식 홈페이지에서 다운로드 및 설치하세요. Node.js 공식 홈페이지.
- : Code 에디터를 다운로드 및 설치하세요.: VS Code WebStorm, 또는 Sublime Text 를 선택하고 최신 안정 버전을 설치하세요.
- Git: git-scm.com에서 다운로드하세요. 플랫폼별 도구.
- __CAPGO_KEEP_0__: 플랫폼에 맞는 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__를 설치하세요. Xcode macOS를 위한 Android Studio Android 개발을 위한
이러한 Capacitor CLI가 설치되면 Capacitor CLI 설정을 위해 넘어가실 수 있습니다.
Capacitor CLI 설정
Capacitor CLI를 다음 단계로 설정하세요:
-
Capacitor CLI를 전역으로 설치하세요
터미널을 열고 다음 명령어를 실행하세요:
npm install -g @capacitor/cli -
Capgo 플러그인을 초기화하세요
아직 하지 않은 경우에만 실행하세요:
npx @capgo/cli init이것은 업데이트를 관리하는 데 필요한 설정을 구성합니다. 업데이트 관리 효과적으로 [1]. 앱을 빌드, 테스트 및 배포하는 과정을 단순화합니다.
Starting a New Capacitor Project
Once you’ve installed the necessary tools, you’re ready to set up your first Capacitor project. Here’s how to get started.
프로젝트 만들기
To create a new Capacitor project, open your terminal and use this command:
npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]
예를 들어:
npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"
각 매개변수는 다음과 같은 의미를 가지고 있습니다:
- projectDirectory: 프로젝트 폴더 이름 (예:
my-cap-app). - appId: 앱 ID (역방향 도메인 식별자, 예:
com.example.app). - appDisplayName: 앱 이름 (예:
My Capacitor App).
After running this command, you’ll need to adjust your project settings in the capacitor.config.json file.
Configuring capacitor.config.json
The capacitor.config.json file is where you define the key settings for your project. Below is an example of a basic configuration:
{
"appId": "com.example.app",
"appName": "My Capacitor App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https",
"iosScheme": "https"
}
}
Here’s a breakdown of the key options:
| 설정 | 목적 | 예시 값 |
|---|---|---|
| 앱 ID | 앱의 고유 식별자 | com.example.app |
| 앱 이름 | 앱의 표시 이름 | My Capacitor App |
| 웹 디렉토리 | 빌드 출력의 디렉토리 | dist |
| 포장된 웹 런타임 | Capacitor 런타임을 포함할지 여부 | false |
| 개발 서버의 호스트 이름 | 개발 서버의 호스트 이름 | app.example.com |
| 개발 서버의 Android 스키마 | URL scheme for Android | https |
| 서버.iosScheme | URL scheme for iOS | https |
의존성 설치
설정을 완료하려면 다음 명령어를 사용하여 필요한 의존성을 설치하고 프로젝트를 초기화하세요:
npm install @capacitor/core
npm install @capacitor/cli --save-dev
npx cap init
이 단계를 완료하면 플랫폼에 따라 설정 및 개발을 위해 프로젝트가 준비되었습니다.
모바일 플랫폼 설정
Once your Capacitor project is initialized, the next step is to add and configure the iOS and Android platforms so your app can run natively on mobile devices.
iOS 및 Android 설정
다음 명령어를 사용하여 플랫폼 지원을 추가하세요:
npx cap add ios
npx cap add android
플랫폼을 추가한 후 웹 code를 동기화하세요:
npx cap sync
이 명령어를 실행하기 전에 웹 애플리케이션을 빌드하고 webDir in capacitor.config.json is correctly set. Once that’s done, customize each platform’s settings to align with your app’s needs.
Platform-Specific Settings
iOS
Open the iOS project with:
npx cap open ios
Then, configure the following settings:
- Bundle Identifier: Ensure it matches your appId.
- Development Team: Assign the appropriate team for code signing.
- Deployment Target: Set the minimum iOS version.
- 장치 방향: 필요에 따라 조정하세요.
- 개인 정보 설명: 다음에 필요한 설명을 추가하세요.
Info.plist.
안드로이드
안드로이드 프로젝트를 열 때:
npx cap open android
그런 다음 다음 설정을 업데이트하세요:
- 패키지 이름: 앱 ID와 일치하도록 확인하세요.
- 권한: 다음에 필요한 권한을 정의하세요.
AndroidManifest.xml. - 화면 방향: 이 설정을
AndroidManifest.xml. - Target SDK: 적절한 버전을
android/app/build.gradle.
Asset and Configuration Locations
앱 아이콘, 스플래시 화면, 깊이 링크 및 권한과 관련된 주요 파일을 찾을 수 있는 곳입니다:
| 설정 | iOS 위치 | Android 위치 |
|---|---|---|
| 앱 아이콘 | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| 스플래시 화면 | ios/App/App/Assets.xcassets |
android/app/src/main/res |
| 깊이 링크 | ios/App/App/Info.plist |
AndroidManifest.xml |
| 권한 | Info.plist |
AndroidManifest.xml |
이러한 설정을 완료하면 모바일 장치에서 앱을 빌드하고 테스트할 준비가 되었습니다.
빌드 및 테스트
이전의 설정을 사용하여 이제는 Capacitor 앱 컨텍스트: Capgo 솔루션 마케팅 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보는 곳: 페이지 솔루션/화이트 레이블.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하십시오.
다양한 장치에서 올바르게 작동하도록 보장하기 위해.
빌드 및 실행 명령
npm run build
npx cap sync
모바일 플랫폼에 대한 앱을 구성한 후, 이제는 빌드 및 테스트를 시작할 차례입니다. 웹 자산을 업데이트하기 위해 시작하십시오:
다음으로, 대상 플랫폼에 맞는 명령어를 사용하십시오:
npx cap run ios
iOS:
npx cap run android
Android:
Adding Capacitor Plugins
Capacitor 플러그인 앱에 원시 기능을 추가할 수 있도록 합니다. 예를 들어 카메라, 위치 정보, 저장소 기능을 포함하려면 다음 명령어를 실행하세요:
npm install @capacitor/camera @capacitor/geolocation @capacitor/storage
npx cap sync
설치 후 플러그인을 native 프로젝트에서 설정하세요. 설정 요구 사항에 대한 빠른 개요입니다:
| 플러그인 | iOS 설정 | Android 설정 |
|---|---|---|
| 카메라 | 추가 privacité 설명 | Android 매니페스트에 권한 추가 |
| 위치 정보 | 위치 사용 설명 추가 | 권한 설정 추가 |
| 저장소 | 권한 설정 추가 | 추가 설정이 필요하지 않습니다 |
추가 설정이 필요하지 않습니다 Capgo

To simplify deployment and testing, you can integrate live update tools like Capgo. This service has already delivered over 23.5 million updates, with 95% of users receiving updates within 24 hours and an 82% global success rate [1].
To add Capgo to your app:
npm install @capgo/capacitor-updater
npx cap sync
앱에 Capgo을 추가하려면:
- __CAPGO_KEEP_0__은 테스트 중에 다음과 같은 이점을 제공합니다:
- 개발, 스테이징 및 프로덕션 환경을 위한 별도의 채널을 생성합니다.
- 업데이트 성공률을 내장 분석을 통해 추적하세요.
- 업데이트 문제가 발생하면 빠르게 롤백할 수 있습니다.
Capgo은 또한 업데이트를 안전하게 전달하기 위해 끝에서 끝까지 암호화합니다. 채널 시스템은 업데이트를 선택한 사용자 그룹과 테스트하고 모든 사용자에게 배포하기 전에 업데이트를 테스트할 수 있도록합니다.
요약
이 안내서에서는 Capacitor 앱을 설정하고 배포하는 모든 단계를 다루었습니다. Capacitor 앱을 시작하고 smooth한 운영을 보장하기 위해 필요한 모든 필수 단계를 다룹니다.
주요 내용
Capacitor 앱을 만들려면 설정, 구성 및 플랫폼에 대한 조정에 주의를 기울여야합니다. 개발 환경을 설정하는 것 - Node.js와 같은 Capacitor __CAPGO_KEEP_1__를 포함하여 -은 시작점입니다. iOS와 Android와 같은 플랫폼을 구성하면 앱이 원활하게 네이티브 시스템에서 작동하도록합니다. 업데이트 시스템을 사용하여 __CAPGO_KEEP_0__은 __CAPGO_KEEP_1__입니다. Capacitor은 CLI입니다. __CAPGO_KEEP_0__은 __CAPGO_KEEP_1__입니다.
__CAPGO_KEEP_0__은 __CAPGO_KEEP_1__입니다. Capgo 릴리즈 관리를 단순화하고 앱 안정성을 유지할 수 있도록 도와줍니다. [1].
여기서부터는 주요 단계를 살펴보겠습니다.
| 단계 | 팁 | 초기 설정 |
|---|---|---|
| __CAPGO_KEEP_0__ 설치, 도구 설치 | Install tools, CLI setup | 설정 |
| 플랫폼 설정 조정, 플러그인 추가 | 플랫폼에 따라 지침을 따르세요. | __CAPGO_KEEP_0__ |
| 테스트 | 장치에서 빌드 및 테스트 | 실제 장치에서 테스트를 우선순위로 |
| 배포 | 업데이트 관리 및 버전 관리 | 자동화 pipeline을 사용하여 효율성을 높여 |
Capacitor 앱 초기화: 단계별 안내서에서 계속
__CAPGO_KEEP_0__ 앱 초기화: 단계별 안내서를 사용 중이라면 Capacitor 앱 초기화: 단계별 안내서를 사용하여 CI/CD 자동화 계획을 세우고 __CAPGO_KEEP_0__ CI/CD와 연결하여 Capgo CI/CD를 사용하여 제품 워크플로우 Capgo CI/CD Capgo Native Builds Capgo Native Builds Capgo Integrations Capgo Integrations CI/CD 연동 __CAPGO_KEEP_0__ 액션 연동 GitHub 액션 연동 for the implementation detail in GitHub Actions Integration.