메인 콘텐츠로 건너뛰기

Capacitor 앱 가이드

Capacitor 앱이란 무엇인가?

Capacitor 앱은 실제 네이티브 iOS 및 Android 프로젝트 내에 배포되는 웹 앱입니다. 인터페이스는 WebView 내에서 HTML, CSS, JavaScript가 실행되며, Capacitor 플러그인은 웹 code를 네이티브 장치 API와 연결합니다. 예를 들어 카메라, 저장소, 푸시 알림, 생체 인식, 파일, 위치와 같은 API입니다. Capgo는 이러한 아키텍처를 릴리스 장점으로 변환하여 실시간 업데이트, 유지 관리되는 플러그인, 네이티브 클라우드 빌드를 제공합니다.

iOS, 웹 프레임워크 및 Android를 포함한 크로스 플랫폼 모바일 앱 개발

작동 방식

Capacitor는 UI 프레임워크가 아닙니다. 앱 내부의 네이티브 런타임입니다. Ionic, React, Vue, Angular, Svelte, Tailwind, 또는 자신의 디자인 시스템이 WebView 내에서 UI를 렌더링할 수 있습니다.

1. 웹 앱

제품을 일반 웹 도구로 빌드한 다음 정적 자산을 출력합니다. Capgo는 승인 후에 이러한 자산을 업데이트할 수 있습니다.

2. 네이티브 셸

Capacitor는 iOS 및 Android 프로젝트 내에 이러한 자산을 배치합니다. Capgo 빌드는 이러한 바이너리가 다시 빌드될 때 도움이 됩니다.

3. 플러그인 브릿지

JavaScript는 플러그인을 호출하고, 플러그인은 Swift, Kotlin, Java, Objective-C, 또는 웹 fallback을 호출합니다. Capgo은 일반적인 네이티브 필요에 대한 플러그인을 유지합니다.

Positive parts

  • 웹 코드베이스 하나로 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 플러그인, 라이브 업데이트 채널, 롤백, 및 클라우드 빌드를 Capacitor 런타임 위에 추가합니다.

Negative parts

  • 모바일 퍼포먼스가 저하되는 이유는 웹뷰 내에서 UI가 작동하기 때문입니다.
  • 대형 또는 빈번한 데이터 전송은 JavaScript-to-native bridge에서 부하를 추가합니다.
  • 팀들은 여전히 서명, 스토어 리뷰, 권한, Gradle, Xcode, 그리고 SDK 업그레이드와 같은 네이티브 앱 지식이 필요합니다.
  • 자연스러운 업그레이드는 수동으로 주의 깊게 변경할 수 있는 원본 파일들입니다.
  • 플러그인 생태계는 넓지만, 모든 커뮤니티 플러그인의 유지 보수 품질이 동일하지는 않습니다. 따라서 유지 보수된 Capgo 플러그인은 프로덕션 앱에서 중요합니다.
  • 완전한 네이티브 UI, 고급 게임, AR-heavy 앱, 또는 지속적인 저주파 네이티브 데이터 흐름이 있는 앱에는 적합하지 않습니다.

최적의 맞춤, 최악의 맞춤

Capacitor이 가장 잘 맞을 때입니다.

  • SaaS, 금융 기술, 의료, 교육, 마켓 플레이스, 그리고 강력한 웹 제품이 필요한 내부 도구.
  • 현재 웹 앱이 앱 스토어 배포를 위해 전체 네이티브 리팩토링 없이 필요한 경우.
  • 웹, iOS, 그리고 Android를 주로 동일한 frontend 팀이 처리하는 팀이 있습니다.
  • 일반 네이티브 요구를 가진 앱: 카메라, 푸시 알림, 인증, 파일, 생체 인식, 결제, 위치, 그리고 깊은 링크.
  • __CAPGO_KEEP_0__ 제품이 스토어 승인 후 라이브 웹 번들 업데이트를 받는 제품입니다.
  • Capgo 빌드를 사용하여 반복 가능한 iOS 및 Android 빌드, 서명, 및 릴리즈 아티팩트를 관리하지 않고 CI 네이티브 세부 사항을 유지할 수 있는 팀.

다른 스택을 선택하세요.

  • 고성능 3D 게임, 비디오 편집기, AR-첫 번째 제품, 또는 실시간 네이티브 렌더링에 의존하는 앱.
  • Swift, Kotlin, Java, 또는 Dart를만 쓰고 싶은 팀.
  • 모든 화면이 플랫폼-네이티브 컨트롤에서 빌드되어야 하는 제품.
  • 유니크한 네이티브 SDK에 의존하는 앱이 있을 때, 유지 관리할 수 있는 플러그인도 없고 팀도 유지 관리할 수 없는 경우.
  • Teams that expect native-code, permission, entitlement, or store-policy changes to bypass app review. Capgo live updates are for the web bundle, not native binary changes.

Capgo의 중요성

네이티브 앱만 새로운 바이너리, 서명, 롤아웃, 및 앱 리뷰를 기다려야 하는데, Capacitor은 네이티브 앱 내부에 웹 번들을 제공합니다. Capgo은 그 번들을 더 빠른 릴리즈 경로로 변환시키며, 여전히 네이티브-code 변경을 올바른 앱 스토어 리뷰 흐름에 유지합니다.

리뷰 큐를 피하는 라이브 업데이트.

Capgo은 네이티브 앱이 승인된 후 사용자에게 허용된 웹 번들 변경을 직접 전송하여, 복사본 수정, UI 수정, 자바스크립트 패치, 및 원격 구성이 앱 스토어 또는 플레이 스토어 리뷰를 기다리지 않고 바로 적용됩니다.

롤백, 채널, 및 제어된 출시

Capgo은 팀이 베타 사용자, 백분율, 채널, 또는 특정 버전으로 출시하고, 웹 업데이트가 나쁠 때 즉시 롤백할 수 있도록 해줍니다.

Capacitor 플러그인 관리

Capgo은 프로덕션 Capacitor 앱을 위한 대형 플러그인 카탈로그를 유지합니다. 이에는 인증, 저장소, 구매, 미디어, 장치 API, 및 기업 마이그레이션과 같은 일반적인 네이티브 요구 사항이 포함됩니다.

Capgo 네이티브 릴리스 빌드

네이티브 code이 정말로 변경되었을 때, Capgo 빌드는 iOS 및 Android 빌드를 생성, 서명 관리, 로그 추적, 및 같은 Capacitor 프로젝트에서 스토어 준비된 아티팩트를 배포하는 데 도움을 줍니다.

역사 및 계보

Capacitor은 Ionic 팀에서 왔습니다. Ionic Framework의 같은 회사입니다. Cordova 및 PhoneGap의 핵심 WebView 및 네이티브 플러그인 패턴을继承하지만 TypeScript, Swift, Kotlin, 커밋된 네이티브 프로젝트, 및 PWA 지원과 같은 npm 패키지에 대한 개발자 경험을 현대화합니다.

Cordova 및 PhoneGap

Capacitor은 하이브리드 앱의 아이디어를继承합니다: 네이티브 셸, WebView, 및 JavaScript에서 네이티브 API로의 브리지

__CAPGO_KEEP_0__는 2017년 말에 출시되었습니다.

Ionic 팀은 Cordova의 현대적인 대안을 탐색하기 시작했으며 Ionic이 모바일 UI 외에도 확장되었습니다.

2019

Capacitor는 iOS, Android, 데스크톱 및 PWAs를 위한 웹 기반 런타임으로 이동하는 동안 Ionic이 처음으로 출시되었습니다.

2022

Ionic은 OutSystems에 합류했습니다. Ionic은 OutSystems의 모바일 작업과 오픈 소스 지원에서 Capacitor가 중심에 남아 있다고 말했습니다.

2023-2026

Ionic은 Capacitor를 더 예측 가능한 릴리스 일정으로 옮기고 공개 백로그 건강 리셋을 시작했습니다.

유지 및 건강

Capacitor는 Ionic 팀이 유지하며 커뮤니티 컨트리뷰터가 생태계 전체에서 있습니다. 프로젝트는 건강하지만 완벽하지 않습니다: Ionic은 2026년 2월에 백로그 부채를 공개적으로 인정하고 오래된 이슈와 풀 요청을 정리하기 시작했습니다.

__CAPGO_KEEP_0__의 최신 안정 버전

__CAPGO_KEEP_0__의 GitHub 스타

8.3.1

15.6k

GitHub의 릴리스 일정

__CAPGO_KEEP_0__의 릴리스 기록

ionic-team/capacitor

Forks

1.2k

공개 GitHub 저장소

월간 다운로드

9.6M

@capacitor/core, 2026년 4월 6일 - 5월 5일

실용적인 읽기

웹이 우선이고 모바일이 중요할 때 제품이 웹-첫 번째로 Capacitor을 강력한 기본값으로 다루세요. Capgo을 사용할 때 릴리스 속도가 중요합니다: 웹 수정 사항에 대한 실시간 업데이트, 나쁜 릴리스에 대한 롤백, 채널을 통해 단계별 롤아웃, 유지 관리되는 플러그인으로 네이티브 기능, Capgo 빌드할 때 실제 네이티브 바이너리 생성이 필요합니다. 네이티브 전용 앱은 실시간 업데이트 경로를 얻지 못합니다; 모든 수정은 새로운 빌드와 스토어 검토를 기다립니다.

Capacitor 앱 가이드에서 계속하세요.

Capacitor 앱으로 웹 앱을 변환하고 있다면 이 페이지를 연결하세요. Capgo 퀵스타트 실시간 업데이트 위해 Capgo 플러그인 디렉토리 자연스러운 네이티브 기능 위해 Capgo 네이티브 빌드 앱 바이너리 위해 Capgo 라이브 업데이트 리뷰 후 수정을 위해, 그리고 Next.js와 Capacitor를 사용하여 네이티브 모바일 앱을 빌드하는 방법 프레임워크에 특화된 경로를 위해.