싱글 코드베이스로 모바일 앱을 만들고 싶으신가요? Capacitor iOS, Android, 및 웹 앱을 만들기 위해 프레임워크와 같은 React, Angular, or Vue. 이 안내서에서는 Capacitor, 플랫폼을 구성하고 업데이트를 효율적으로 배포하는 방법을 설명합니다.
시작하기 위한 주요 단계:
- 도구 설치: Node.js, npm, Git, 및 code 에디터와 같은 VS Code.
- Capacitor 설정: Capacitor CLI을 설치하고 프로젝트를 초기화하세요.
- 플랫폼 설정: iOS와 Android 지원을 추가하고 설정을 조정한 후 code을 동기화하세요.
- 테스트 및 배포: 기기에서 실행하고 __CAPGO_KEEP_0__과 같은 라이브 업데이트 도구를 사용하여 빌드하세요. Capgo 웹 앱과 네이티브 장치 기능을 연결하는 __CAPGO_KEEP_0__은 플랫폼 간에 smooth한 성능을 보장합니다. Capgo의 이 안내서를 따라 앱 개발 과정을 단순화하세요!
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은 웹 앱과 네이티브 장치 기능을 연결하여 플랫폼 간에 smooth한 성능을 보장합니다. | Ionic Release Guide

필수 도구 및 설정
개발 도구 설치
__CAPGO_KEEP_0__와 함께 작업하려면 다음 도구가 필요합니다.
To work with Capacitor, you’ll need the following tools:
| 목적 | 버전 | Node.js |
|---|---|---|
| 자바스크립트 런타임 환경 | __CAPGO_KEEP_0__ | 14.0.0 이상 |
| npm | 패키지 매니저 | 6.0.0 이상 |
| IDE/ Code 에디터 | 개발 환경 | 최신 안정 버전 |
| Git | 버전 관리 | 2.0.0 이상 |
다음 단계를 따라서 설치하세요:
- Node.js 및 npm: Node.js 공식 홈페이지에서 다운로드 및 설치하세요. Node.js 공식 홈페이지.
- : Code 에디터를 다운로드 및 설치하세요.Code 에디터 Visual Studio CodeWebStorm , 또는 Sublime Text
- 최신 안정 버전을 설치하세요.Git : git-scm.com에서 다운로드하세요..
- git-scm.com: __PLATFORM__ 설치 tool을 설치하세요. Xcode macOS용 Android Studio Android 개발을 위해
이러한 tool들이 설치되면, Capacitor CLI 설정을 위해 넘어가실 수 있습니다.
Capacitor CLI 설정
Capacitor CLI을 사용하기 위해 다음 단계를 따라하세요:
-
Capacitor CLI을 글로벌로 설치하세요
터미널을 열고 다음 명령어를 실행하세요:
npm install -g @capacitor/cli -
Capgo 플러그인을 초기화하세요
아직 하지 않은 경우, 다음 명령어를 실행하세요:
npx @capgo/cli init이 설정은 업데이트를 관리하기 위한 필수 설정을 구성합니다. 업데이트 관리 효과적으로 [1]. 앱을 빌드, 테스트 및 배포하는 과정을 단순화합니다.
Starting a New Capacitor Project
Capacitor 프로젝트를 설정하기 위해 필요한 도구를 설치한 후, 첫 번째 Capacitor 프로젝트를 설정하는 방법을 알아보겠습니다.
프로젝트 만들기
새로운 Capacitor 프로젝트를 만들려면 터미널을 열고 다음 명령어를 사용하세요:
npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]
예시:
npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"
각 매개변수는 다음과 같은 의미를 가지고 있습니다:
- projectDirectory: 프로젝트 폴더 이름 (예:
my-cap-app). - 앱 ID: 앱의 역방향 도메인 식별자 (예:
com.example.app). - 앱 이름: 앱에 표시되는 이름 (예:
My Capacitor App).
이 명령어를 실행한 후에, capacitor.config.json 파일에서 프로젝트 설정을 조정해야 합니다.
capacitor.config.json
파일은 프로젝트의 기본 설정을 정의하는 곳입니다. 아래는 기본적인 설정 예시입니다. capacitor.config.json 기본 설정
{
"appId": "com.example.app",
"appName": "My Capacitor App",
"webDir": "dist",
"bundledWebRuntime": false,
"server": {
"hostname": "app.example.com",
"androidScheme": "https",
"iosScheme": "https"
}
}
설정
| 목적 | context | 예시 값 |
|---|---|---|
| 앱 아이디 | 앱의 고유 식별자 | com.example.app |
| 앱 이름 | 앱의 표시 이름 | My Capacitor App |
| 웹 디렉토리 | 빌드 출력의 디렉토리 | dist |
| 압축된 웹 런타임 | Capacitor 런타임을 포함할지 여부 | false |
| 개발 서버 호스트 이름 | 개발 서버의 호스트 이름 | app.example.com |
| 개발 서버의 안드로이드 스키마 | Android용 URL 스키마 | https |
| 서버.iosScheme | iOS용 URL 스키마 | 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 안에 capacitor.config.json 는 정확히 설정되어 있습니다. 그 이후로, 각 플랫폼의 설정을 앱의 요구에 맞게 조정하세요.
플랫폼별 설정
iOS
iOS 프로젝트를 열 때:
npx cap open ios
그 다음, 다음 설정을 구성하세요:
- 아이디: 앱 아이디와 일치하는지 확인하세요.
- 개발 팀: code에 대한 서명에 적합한 팀을 Assign하세요.
- 배포 대상: 최소 iOS 버전을 설정하세요.
- 장치 방향: 필요에 따라 조정하세요.
- 개인 정보 설명: 다음에 필요한 설명을 추가하세요.
Info.plist.
안드로이드
아래의 안드로이드 프로젝트를 열어보세요:
npx cap open android
그 다음, 다음 설정을 업데이트하세요:
- 패키지 이름: 앱 ID와 일치하는지 확인하세요.
- 권한: 다음에 필요한 권한을 정의하세요.
AndroidManifest.xml. - 화면 방향: __CAPGO_KEEP_0__ 설정을 하세요.
AndroidManifest.xml. - : 적절한 버전을 SDK에 설정하세요.: __CAPGO_KEEP_0__의 위치
android/app/build.gradle.
자산 및 설정 위치
앱 아이콘, 스플래시 화면, 깊이 링크 및 권한과 같은 중요한 파일을 찾을 수 있는 곳입니다.
| 설정 | 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 앱 다양한 기기에서 올바르게 작동하는지 확인하기 위해.
빌드 및 실행 명령
모바일 플랫폼에 대한 앱을 구성한 후에는 테스트를 위해 빌드 및 실행해야 합니다. 웹 자산을 업데이트하기 위해 시작하세요:
npm run build
npx cap sync
다음으로, 대상 플랫폼에 맞는 명령어를 사용하세요:
iOS:
npx cap run ios
Android:
npx cap run android
이 명령어는 시뮬레이터 또는 연결된 기기에서 앱을 빌드하고 실행합니다. 실제 기기와 시뮬레이터에서 테스트하는 것은 플랫폼별 문제를 식별하는 데 중요합니다.
Capacitor 플러그인 추가
Capacitor 플러그인 앱에 원시 기능을 추가할 수 있게 해줍니다. 예를 들어 카메라, 위치 정보, 저장소 기능을 포함하려면 다음 명령어를 실행하세요:
npm install @capacitor/camera @capacitor/geolocation @capacitor/storage
npx cap sync
설치 후 플러그인을 native 프로젝트에서 설정하세요. 설정 요구 사항에 대한 빠른 개요입니다:
| 플러그인 | iOS 설정 | Android 설정 |
|---|---|---|
| 카메라 | 추가 privacynote | Android 매니페스트에 권한 추가 |
| 위치 정보 | 위치 사용 설명 추가 | 위치 권한 추가 |
| 저장소 | 추가 설정이 필요하지 않습니다 | 추가 설정이 필요하지 않습니다 |
__CAPGO_KEEP_0__ Capgo

Capgo [1].
Capgo
npm install @capgo/capacitor-updater
npx cap sync
Capgo
- __CAPGO_KEEP_0__
- __CAPGO_KEEP_0__
- 업데이트 성공률을 내장 분석을 통해 추적하세요.
- 업데이트 문제가 발생하면 빠르게 롤백할 수 있습니다.
Capgo은 업데이트를 안전하게 전달하기 위해 끝에서 끝까지 암호화합니다. 채널 시스템은 업데이트를 테스트하기 위해 선택한 사용자 그룹에 먼저 배포하고 나중에 모든 사용자에게 배포할 수 있습니다.
요약
이 안내서에서는 Capacitor 앱을 설정하고 배포하는 모든 단계를 다룹니다. 앱을 시작하고 smooth한 운영을 보장하기 위해 필요한 모든 필수 단계를 다룹니다.
주요 내용
Capacitor 앱을 만들기 위해서는 설정, 구성, 플랫폼에 대한 조정에 주의를 기울여야 합니다. 개발 환경을 설정하는 것 - Node.js와 같은 Capacitor __CAPGO_KEEP_1__을 포함하여 -은 시작점입니다. iOS와 Android와 같은 플랫폼을 구성하면 앱이 원활하게 네이티브 시스템에서 작동할 수 있습니다. __CAPGO_KEEP_0__ 업데이트 시스템을 사용하면 Node.js Capacitor CLI 업데이트 시스템
업데이트 시스템 Capgo 릴리즈 관리를 단순화하고 앱 안정성을 유지할 수 있습니다. [1].
Capacitor 앱 초기화 단계별 가이드
| Phase | Steps | Tips |
|---|---|---|
| 초기 설정 | 도구 설치, CLI 설정 | 최신 안정 버전 사용 |
| 설정 | 플랫폼 설정 조정, 플러그인 추가 | 플랫폼별 지침 따르기 |
| 테스트 | 장치에서 빌드 및 테스트 | 실제 장치에서 테스트를 우선순위로 |
| 배포 | 업데이트 관리 및 버전 관리 | 자동화 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.