메인 콘텐츠로 건너뛰기

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

Capacitor CLI을 사용하여 네이티브 iOS 및 Android 앱을 웹 기술을 사용하여 몇 가지 쉬운 단계로 빌드하는 방법을 배웁니다.

마틴 도나디유

마틴 도나디유

콘텐츠 마케터

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

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

  • 빠른 설정: Capacitor CLI을 설치하고 프로젝트를 몇 분만에 초기화하세요.
  • 플랫폼 통합: iOS 및 Android 지원을 간단한 명령어로 추가하세요.
  • 실시간 업데이트: __CAPGO_KEEP_0__ Capgo 일반적인 해결책
  • : 동기화 오류나 빌드 실패와 같은 문제를 해결하세요.시작하기 위한 주요 단계:

설치

  1. Node.js , __CAPGO_KEEP_0__, JDK,, npm, JDK, __CAPGO_KEEP_0__Android Studio.
  2. 실행 npm install @capacitor/core @capacitor/cli 프로젝트를 초기화하세요.
  3. iOS 및 Android 플랫폼을 추가하세요. npx cap add iosnpx cap add android.
  4. 선택 사항: Capgo을 사용하여 실시간 앱 업데이트를 설정하세요. 앱 업데이트.

이 안내서에서는 Capacitor CLI을 설정하고 플랫폼을 구성하는 방법, 그리고 앱을 배포하는 방법에 대해 다룹니다. 시작해 보세요!

소개 Capacitor 설정

Capacitor Framework Documentation Website

설치 요구 사항

시작하기 위해 다음 도구가 설치되어 있어야 합니다.

  • 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에서:

  1. 개발 팀을 선택하세요.
  2. 설치 서명 인증서를 설정하세요.
  3. 빌드 식별자를 업데이트하세요.

Android Studio에서:

  1. 애플리케이션 ID를 build.gradle.
  2. 서명 키스토어를 구성하세요.
  3. 디버그 및 릴리스 빌드 버전을 모두 설정하세요.

모든 설정이 완료되면 npx cap build ios 또는 npx cap build android를 사용하여 프로젝트를 빌드하세요. npx cap sync 모든 자산이 최신 상태인지 확인하려면

Capgo __CAPGO_KEEP_0__

Capgo Live Update Dashboard Interface

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

Capgo의 주요 기능

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

  • 엔드 투 엔드 암호화 업데이트 전달을 보장하는 보안 방법입니다.
  • 업데이트는 앱이 시작될 때 배경에서 실행됩니다.
  • 분석 도구 업데이트 성공률과 사용자 참여도를 추적하는 도구입니다.
  • A one-click rollback 업데이트 문제로 인해 빠르게 복구할 수 있는 옵션입니다.
  • Use the __CAPGO_KEEP_0__ channel system

Installing Capgo

Installing Capgo

  1. Install the Capgo CLI:

    npm install --save @capgo/cli
  2. Install the Capgo __CAPGO_KEEP_1__ Initialize __CAPGO_KEEP_0__

    npx capgo init
  3. in your project:

    npm run build
    npx capgo release
  4. 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 변경 사항이 적용되지 않습니다. 수정: 프로젝트의 appIdwebDir 값이 프로젝트의 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 키에서 구현 세부 정보를 확인하세요. 장치 장치에서 구현 세부 정보를 확인하세요. 배포 패키지 배포 패키지에서 구현 세부 정보를 확인하세요.

Capacitor 앱에 대한 실시간 업데이트

웹-layer 버그가 실시간으로 존재할 때, 앱 스토어 승인 대기 없이 Capgo를 통해 픽스를 배포하세요. 사용자는 배경에서 업데이트를 받으면서 네이티브 변경 사항은 일반적인 검토 경로에 남아 있습니다.

시작하기

블로그에서 최신 소식

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