메인 콘텐츠로 건너뛰기

Capacitor 앱 초기화: 단계별 안내

모바일 앱을 효율적으로 설정하고 배포하는 방법을 배워보세요. Capacitor을 사용하여 설치부터 플랫폼별 설정까지 모든 것을 다룹니다.

Martin Donadieu

Martin Donadieu

컨텐츠 마케터

Capacitor 앱 초기화: 단계별 가이드

단일 코드베이스를 사용하여 모바일 앱을 빌드하고 싶으신가요? Capacitor __CAPGO_KEEP_0__은 React, Angular, 또는 Vue와 같은 프레임워크를 사용하여 iOS, Android, 및 웹 앱을 쉽게 만들 수 있도록 도와줍니다. Martin Donadieu, Content MarketerCapacitor App Initialization: Step-by-Step Guide Want to build mobile apps with a single codebase?이 안내서에서는 __CAPGO_KEEP_0__ 설정 Capacitor, 플랫폼 설정, 및 업데이트 효율적으로 배포하는 방법을 설명합니다.

시작하기 위한 주요 단계:

  • 도구 설치: Node.js, npm, Git, 및 code 편집기처럼 Code.
  • Set Up CapacitorCapacitor CLI 설치하고 프로젝트를 초기화하세요.
  • 플랫폼 설정: iOS 및 Android 지원 추가, 설정 조정, 및 code 동기화.
  • 테스트 및 배포: 기기에서 실행하고, 라이브 업데이트 도구인 Capgo __CAPGO_KEEP_0__

Capacitor

5 가지 단계로 네이티브 앱 만들기 CAPACITOR | 이온 리리즈 가이드

CAPACITOR

필수 도구 및 설정

개발 환경을 설정하는 데 필요한 필수 도구에 대해 알아보세요.

개발 도구 설치

Capacitor과 함께 작업하려면 다음 도구가 필요합니다:

도구목적최소 버전
Node.js자바스크립트 런타임 환경14.0.0 이상
npm패키지 매니저6.0.0 이상
IDE/Code 에디터개발 환경최신 안정 버전
Git버전 관리2.0.0 이상

다음 단계를 따라 설치하세요:

  • Node.js 및 npm: 공식 홈페이지에서 다운로드 및 설치하세요. Node.js 홈페이지.
  • Code 에디터: VS Code와 같은 에디터를 선택하세요. WebStorm, 또는 Sublime Text 최신 안정 버전을 설치하세요.
  • Git: __CAPGO_KEEP_0__에서 가져오세요. git-scm.com.
  • 플랫폼별 도구: __CAPGO_KEEP_0__에서 __CAPGO_KEEP_1__에 맞는 도구를 설치하세요. Xcode macOS Android Studio Android 개발

설치가 완료되면 Capacitor 및 CLI을 설정하는 단계로 넘어가실 수 있습니다.

Capacitor CLI 설정

Capacitor CLI을 시작하기 위해 다음 단계를 따르세요:

  1. Capacitor CLI를 글로벌로 설치하세요

    터미널을 열고 다음 명령어를 실행하세요:

    npm install -g @capacitor/cli
  2. Capgo 플러그인을 초기화합니다.

    아직 하지 않았다면 다음을 실행하세요:

    npx @capgo/cli init

    이 설정을 구성하여 업데이트 관리 효과적으로 [1]앱을 빌드, 테스트 및 배포하는 과정을 단순화합니다.

Starting a New Capacitor Project

설치된 도구가 필요하면 첫 번째 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).
  • appId: 앱의 역방향 도메인 식별자 (예: com.example.app).
  • appDisplayName: 앱에 표시되는 이름 (예: 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"
  }
}

설정

목적예시 값appId
앱의 고유 식별자appNamecom.example.app
앱의 표시 이름The file is where you define the key settings for your project.My Capacitor App
__CAPGO_KEEP_0__빌드 출력 디렉토리dist
배포된 웹 런타임 포함 여부Whether to include Capacitor runtimefalse
안드로이드 URL 스킴iOS URL 스킴app.example.com
설치하는 의존성설정을 완료하려면 다음 명령어를 사용하여 필요한 의존성을 설치하고 프로젝트를 초기화하세요.https
설정 완료배포된 웹 런타임 포함 여부https

서버 호스트 이름

안드로이드 URL 스킴

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

After adding the platforms, sync your web code with:

npx cap sync

이 명령어를 실행하기 전에 웹 애플리케이션을 빌드하고 webDir 가 올바르게 설정되어 있는지 확인하세요. 그 후 각 플랫폼의 설정을 앱의 요구에 맞게 조정하세요. capacitor.config.json 플랫폼별 설정

iOS

iOS 프로젝트를 다음 명령어로 열어주세요.

Capacitor CLI를 사용하여 iOS 프로젝트를 열어주세요.

npx cap open ios

그 다음으로 다음 설정을 구성하세요:

  • Bundle Identifier: 앱 ID와 일치하는지 확인하세요.
  • 개발 팀: code에 대한 적절한 팀을 Assign하세요.
  • 배포 대상: 최소 iOS 버전을 설정하세요.
  • 디바이스 오리엔테이션: 필요에 따라 조정하세요.
  • privacidade 설명: 필요로하는 설명을 추가하세요. Info.plist.

Android

Android 프로젝트를 열기 위해:

npx cap open android

그 다음, 다음 설정을 업데이트하세요:

  • 패키지 이름: 자신의 appId와 일치하는지 확인하세요.
  • 권한: 필요한 권한을 AndroidManifest.xml.
  • 화면 방향: AndroidManifest.xml.
  • 대상 SDK: 적절한 버전을 설정하세요. android/app/build.gradle.

자산 및 구성 위치

앱 아이콘, 스플래시 화면, 깊이 링크 및 권한과 같은 중요한 파일을 찾을 곳입니다.

설정iOS 위치Android 위치
앱 아이콘ios/App/App/Assets.xcassetsandroid/app/src/main/res
스플래시 화면ios/App/App/Assets.xcassetsandroid/app/src/main/res
깊이 링크ios/App/App/Info.plistAndroidManifest.xml
권한Info.plistAndroidManifest.xml

__CAPGO_KEEP_0__ 앱을 빌드하고 테스트하기 위해 준비되었습니다.

빌드 및 테스트

__CAPGO_KEEP_0__ 앱을 빌드하고 테스트하기 위해 준비되었습니다. Capacitor 앱 다양한 기기에서 올바르게 작동하는지 확인하기 위해 __CAPGO_KEEP_0__ 앱을 빌드하고 테스트하세요.

모바일 플랫폼을 위한 앱을 구성한 후, 테스트를 위해 빌드하고 실행하세요. 웹 자산을 업데이트하기 위해 시작하세요:

모바일 플랫폼에 대한 설정이 완료되면, 테스트를 위해 빌드하고 실행하세요. 웹 자산을 업데이트하기 위해 시작하세요:

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

설치 후, 네이티브 프로젝트에서 플러그인을 구성하세요. 설정 요구 사항에 대한 빠른 개요는 다음과 같습니다:

플러그인iOS 구성안드로이드 설정
카메라추가 개인 정보 보호 설명매니페스트에 권한 추가
위치 정보위치 사용 설명 추가위치 권한 추가
저장소추가 설정이 필요하지 않습니다.추가 설정이 필요하지 않습니다.

실시간 업데이트와 함께 Capgo

Capgo Live Update Dashboard Interface

배포 및 테스트를 간소화하기 위해 Capgo와 같은 라이브 업데이트 도구를 통합할 수 있습니다. 이 서비스는 이미 2,350만 개의 업데이트 Delivery를 완료했으며, 24시간 이내에 95%의 사용자가 업데이트 받았으며 글로벌 성공률은 82%입니다. [1].

앱에 Capgo을 추가하려면:

npm install @capgo/capacitor-updater
npx cap sync

Capgo은 테스트 시 여러 이점을 제공합니다:

  • 개발, 스테이징, 및 운영 환경을 위한 별도의 채널을 생성합니다.
  • 테스트 중에 즉시 버그 픽스를 푸시합니다.
  • 업데이트 성공률을 built-in 분석과 함께 추적합니다.
  • 문제가 발생하면 업데이트를 쉽게 롤백할 수 있습니다.

Capgo은 또한 end-to-end 암호화로 안전한 업데이트 전송을 보장하며, 채널 시스템은 사용자 그룹을 선택적으로 테스트할 수 있도록 허용하여 모든 사용자에게 배포하기 전에 업데이트를 테스트할 수 있습니다.

요약

이 가이드는 Capacitor 앱을 설정하고 배포하는 모든 단계를 다루며, 시작과 운영을 위한 모든 필수 단계를 다룹니다.

주요 점

Capacitor 앱을 만들기 위해서는 설정, 구성, 플랫폼에 특화된 조정에 주의를 기울여야 합니다. 개발 환경을 설정하는 것 - Node.js와 같은 도구를 포함하여 -는 중요한 시작점입니다. iOS와 Android와 같은 플랫폼을 구성하여 앱이 원시 시스템에서 원활하게 작동하도록 합니다. __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Node.js Capacitor CLI __CAPGO_KEEP_0__

업데이트 시스템 Capgo 주요 단계 [1].

Phase

단계__CAPGO_KEEP_0__
초기 설정도구를 설치하고, CLI 설정최신 안정적인 버전을 사용하세요
설정플랫폼 설정을 조정하고 플러그인을 추가하세요플랫폼에 따라 지침을 따르세요
테스트장치에서 빌드하고 테스트실제 장치에서 테스트를 우선하세요
배포업데이트 관리, 버전 관리효율성을 위해 자동화 pipeline을 사용하세요
Capacitor 앱에 대한 실시간 업데이트

웹层 버그가 실시간으로 발생하면 Capgo를 통해 픽스 배포를 기다리지 않고 앱 스토어 승인까지 며칠 기다리지 않아도 됩니다. 사용자는 배경에서 업데이트를 받으면서 네이티브 변경 사항은 일반적인 검토 경로에 남아 있습니다.

시작하기

블로그에서 최신 뉴스

Capgo는 전문적인 모바일 앱을 만들기 위해 필요한 최고의洞察력을 제공합니다.