Capacitor app guide
What is a Capacitor app?
A Capacitor app is a web app shipped inside real native iOS and Android projects. Your interface is HTML, CSS, and JavaScript running in a WebView, while Capacitor plugins bridge that web code to native device APIs like camera, storage, push notifications, biometrics, files, and location. Capgo turns that architecture into a release advantage with live updates, maintained plugins, and native cloud builds.
마틴의 인간 지원
작동 방식
Capacitor is not a UI framework. It is the native runtime under the app. Ionic, React, Vue, Angular, Svelte, Tailwind, or your own design system can render the UI inside the WebView.
1. 웹 앱
You build the product with normal web tooling, then output static assets. Capgo can update those assets after approval.
__CAPGO_KEEP_0__
Capacitor iOS 및 Android 프로젝트 내에 해당 자산을 넣습니다. Capgo 빌드는 이 바이너리가 다시 빌드될 때 도움이 됩니다.
3. 플러그인 브릿지
JavaScript는 플러그인을 호출하고 플러그인은 Swift, Kotlin, Java, Objective-C, 또는 웹 fallback을 호출합니다. Capgo는 일반적인 네이티브 필요에 대한 플러그인을 유지합니다.
긍정적인 부분
- 웹 코드베이스는 iOS, Android, 및 웹으로 배포할 수 있습니다.
- Capgo 라이브 업데이트 기능으로 인해 허용된 HTML, CSS, 및 JavaScript 수정 사항은 네이티브 앱이 승인된 후 스토어 리뷰 큐를 피할 수 있습니다.
- 팀은 React, Vue, Angular, Svelte, 또는 평범한 웹 도구를 유지할 수 있습니다. Swift 및 Kotlin으로 다시 작성할 필요가 없습니다.
- 네이티브 접근은 플러그인을 통해 이루어지며, 사용자 지정 Swift, Kotlin, Java, 또는 Objective-C code를 추가할 수 있습니다.
- 기존의 현대적인 웹 앱은 UI 프레임워크를 변경하지 않고 Capacitor를 채택할 수 있습니다.
- Capacitor는 네이티브 iOS 및 Android 프로젝트를 리포지토리에 유지하여 플랫폼 디버깅 및 SDK 작업이 더 명확해집니다.
- 대부분의 Cordova 플러그인은 여전히 작동하여, 이전의 Ionic 및 Cordova 팀이 점진적으로 마이그레이션하는 데 도움이 됩니다.
- Capgo는 유지 관리되는 Capacitor 플러그인, 라이브 업데이트 채널, 롤백, 및 Cloudflare의 Capacitor 런타임 위에 추가됩니다.
부정적인 부분
- UI는 WebView에서 실행되므로 웹 성능이 좋지 않으면 모바일 성능도 좋지 않습니다.
- JavaScript-to-native bridge를 통해 자주 발생하는 데이터 전송은 오버헤드를 추가합니다.
- 팀은 서명, 스토어 리뷰, 권한, Gradle, Xcode, 및 SDK 업그레이드와 같은 네이티브 앱 지식이 필요합니다.
- 네이티브 프로젝트는 소스 파일이므로 주요 업그레이드는 주의 깊게 수동으로 변경해야 합니다.
- 플러그인 생태계는 광범위하지만, 모든 커뮤니티 플러그인의 유지 보수 품질이 동일하지 않습니다. 따라서 유지 보수된 Capgo 플러그인이 프로덕션 앱에 중요합니다.
- 완전한 네이티브 UI, 고급 게임, AR-heavy 앱, 또는 낮은 지연 시간 네이티브 데이터 흐름이 있는 앱에는 적합하지 않습니다.
최적의 적합성, 최악의 적합성
Capacitor은
- __CAPGO_KEEP_0__이 가장 잘 맞는 경우
- SaaS, 금융, 의료, 교육, 마켓플레이스, 및 내부 도구와 강력한 웹 제품 요구가 있는 경우
- 기존 웹 앱이 앱 스토어 배포를 위해 네이티브 리뷰 없이 앱 스토어 배포를 원하는 경우
- 카메라, 푸시, 인증, 파일, 생체 인식, 결제, 위치, 그리고 깊은 링크를 위한 일반 네이티브 앱:
- 스토어 승인 후 라이브 웹 번들 업데이트를 받는 제품:
- Capgo 빌드를 통해 반복 가능한 iOS 및 Android 빌드, 서명, 및 릴리즈 아티팩트를 관리하지 않고 네이티브 CI 세부 사항을 유지하지 않으려는 팀:
__CAPGO_KEEP_0__를 선택하지 않으면
- 고성능 3D 게임, 비디오 편집기, AR-첫 번째 제품, 또는 실시간 네이티브 렌더링에 의존하는 앱:
- Swift, Kotlin, Java, 또는 Dart만 작성하려는 팀:
- 모든 화면이 플랫폼 네이티브 컨트롤에서 빌드되어야 하는 제품:
- 유니크 네이티브 SDK에 의존하는 앱이 있고 유지 관리 플러그인이 없으며 팀이 유지 관리 플러그인을 유지할 수 없는 경우:
- 네이티브-code, 권한, 특권, 또는 스토어 정책 변경이 앱 리뷰를 피할 수 있는 팀: Capgo 라이브 업데이트는 네이티브 바이너리 변경이 아닌 웹 번들의 경우입니다.
Capgo의 중요성:
네이티브 앱만 새로운 바이너리, 서명, 배포, 및 앱 리뷰를 기다리며 모든 보이는 변경에 대해: Capacitor는 네이티브 앱 내부에 웹 번들을 제공합니다. Capgo은 그 번들을 더 빠른 릴리즈 경로로 변환시키며 여전히 네이티브-code 변경을 올바른 앱 스토어 리뷰 흐름에 유지합니다.
__CAPGO_KEEP_1__ 리뷰 큐를 건너뜀으로써 라이브 업데이트:
Capgo은 네이티브 앱이 승인되면 사용자에게 직접 웹 번들 변경을 전송하여, 복사 수정, UI 수정, 자바스크립트 패치 및 원격 구성은 앱 스토어 또는 플레이 스토어 리뷰를 기다리지 않고 즉시 적용됩니다.
롤백, 채널 및 제어된 롤아웃
Capgo은 팀이 베타 사용자, 백분율, 채널 또는 특정 버전으로 출시하고, 웹 업데이트 문제가 발생하면 즉시 롤백할 수 있도록 해줍니다.
유지 관리되는 Capacitor 플러그인
Capgo은 프로덕션 Capacitor 앱에 대규모 플러그인 카탈로그를 유지 관리하여, 인증, 저장소, 구매, 미디어, 장치 API 및 기업 마이그레이션과 같은 일반적인 네이티브 요구 사항을 충족합니다.
Capgo 빌드
네이티브 code이 실제로 변경되면 Capgo 빌드는 iOS 및 Android 빌드를 생성하고, 서명 관리, 로그 추적 및 스토어 준비된 아티팩트를 동일한 Capacitor 프로젝트에서 배포하는 데 도움을 줍니다.
마틴의 인간 지원
역사 및 계보
Capacitor은 Ionic 팀에서 왔으며, Ionic 프레임워크의 동일한 회사에 의해 개발되었습니다. Cordova 및 PhoneGap에서 WebView 및 네이티브 플러그인 패턴을继承하지만, npm 패키지, TypeScript, Swift, Kotlin, 커밋된 네이티브 프로젝트 및 PWA 지원과 같은 개발자 경험을 현대화합니다.
Cordova 및 PhoneGap
Capacitor은 하이브리드 앱 아이디어를 상속합니다: 네이티브 셸, WebView, 자바스크립트에서 네이티브 API로의 브리지.
2017년 말
아이콘 팀은 Ionic이 모바일 UI만으로 확장되지 않도록 Cordova의 현대적인 대안을 탐색하기 시작했습니다.
2019
Capacitor은 iOS, Android, 데스크톱 및 PWAs용 웹 네이티브 런타임으로 이동하는 동안 아이콘이 처음으로 출시되었습니다.
2022
아이콘 팀은 Ionic이 모바일 작업과 오픈 소스 지원에 Capacitor을 중심으로 유지한다고 말했습니다.
2023-2026
Capacitor은 아이콘이 예측 가능한 릴리스 일정으로 이동하고 공개 백로그 헬스 리셋을 시작했습니다.
유지보수 및 건강
Capacitor은 아이콘 팀이 유지보수하고 커뮤니티 컨트리뷰터가 생태계를 둘러싸고 있습니다. 프로젝트는 건강하지만 완벽하지 않습니다: 아이콘 팀은 2026년 2월에 백로그 부채를 공개적으로 인정하고 오래된 이슈와 Pull Request를 청소하기 시작했습니다.
2026년 5월 6일까지 스냅샷이 확인되었습니다. 카운트는 시간과 함께 움직입니다.
최신 안정 버전
8.3.1
2026년 4월 16일 배포
GitHub 별점
15.6k
ionic-team/capacitor
분기
1.2k
공개 GitHub 저장소
월간 다운로드
9.6M
@capacitor/core, 2026년 4월 6일 - 5월 5일
실용적인 읽기
Capacitor을 웹-첫 번째 제품의 경우 강력한 기본값으로 다루면 좋습니다. 모바일이 중요할 때 Capgo을 사용하세요: 웹 수정 사항에 대한 즉각적인 업데이트, 나쁜 릴리스의 롤백, 채널을 통해 단계적인 론칭, 유지 관리되는 플러그인으로 인한 네이티브 기능, 그리고 Capgo 빌드가 실제 네이티브 바이너리가 생성될 때 필요합니다. 네이티브 전용 앱은 즉각적인 업데이트 경로를 얻지 못합니다; 모든 수정은 새로운 빌드와 스토어 리뷰를 기다려야 합니다.
Capacitor 앱 가이드에서 계속
Capacitor 앱을 웹 앱에서 변환하는 경우 이 페이지를 연결하세요. Capgo 퀵 스타트 __CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__ Next.js와 Capacitor을 사용하여 Native 모바일 앱을 빌드하세요. 프레임워크에 따라 특정 경로를 사용합니다.