ionic-team/capacitor

어떤 프로젝트인가요?

핵심 기능

• 01하나의 웹 코드베이스를 iOS, Android, 웹에서 네이티브로 실행합니다.
• 02JavaScript에서 네이티브 SDK를 호출할 수 있는 크로스 플랫폼 API를 제공합니다.
• 03Swift, Kotlin 또는 Java로 네이티브 플러그인을 작성할 수 있는 Plugin API를 포함합니다.
• 04네이티브 프로젝트를 생성된 빌드 산출물이 아닌 직접 수정할 수 있는 소스로 취급합니다.
• 05대부분의 Cordova 플러그인과의 하위 호환성을 제공합니다.

활용 사례

• 기존 웹 앱을 App Store와 Google Play에 출시하기.
• JavaScript 프런트엔드에서 네이티브 기기 기능에 접근하기.
• 재사용 가능한 네이티브 플러그인을 작성해 npm 패키지로 배포하기.
• 하나의 앱을 네이티브 앱 스토어와 모바일 웹에 모두 배포하기.

빠른 시작

1. 1

   기존 웹 앱에 core 및 CLI 패키지를 설치합니다

   npm install @capacitor/core @capacitor/cli
2. 2

   앱에서 Capacitor를 초기화합니다

   npx cap init
3. 3

   Android 플랫폼을 설치합니다

   npm install @capacitor/android
4. 4

   Android 네이티브 프로젝트를 추가합니다

   npx cap add android

사용 전 알아둘 점

• !iOS 네이티브 빌드에는 Xcode가 설치된 Mac이 필요하며, README에서는 이 설정 방법을 다루지 않습니다.

토픽

자주 묻는 질문

capacitor은(는) 무엇인가요?

Capacitor는 하나의 코드베이스로 웹 앱을 iOS, Android, 웹에서 네이티브로 실행할 수 있게 해주는 크로스 플랫폼 런타임입니다. Capacitor는 기존 웹 앱을 감싸 iOS, Android, 웹에서 네이티브로 실행할 수 있게 합니다. 웹 코드에서 네이티브 SDK를 호출할 수 있도록 크로스 플랫폼 API와 실행 계층을 제공하며, Swift(iOS) 또는 Kotlin/Java(Android)로 커스텀 네이티브 플러그인을 작성할 수 있는 Plugin API도 제공합니다.

capacitor은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

capacitor은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

capacitor은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. capacitor의 마지막 커밋은 2026년 10월 21일입니다.

capacitor은(는) 어디에 사용할 수 있나요?

기존 웹 앱을 App Store와 Google Play에 출시하기. JavaScript 프런트엔드에서 네이티브 기기 기능에 접근하기. 재사용 가능한 네이티브 플러그인을 작성해 npm 패키지로 배포하기. 하나의 앱을 네이티브 앱 스토어와 모바일 웹에 모두 배포하기.

capacitor는 어떻게 설치하나요?

기존 웹 앱에 core 및 CLI 패키지를 설치합니다: npm install @capacitor/core @capacitor/cli 앱에서 Capacitor를 초기화합니다: npx cap init Android 플랫폼을 설치합니다: npm install @capacitor/android Android 네이티브 프로젝트를 추가합니다: npx cap add android

capacitor은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ionic-team/capacitor