Getting Started

__CAPGO_KEEP_4__

1. __CAPGO_KEEP_6__

   npm install @capacitor-plus/core @capacitor-plus/cli

2. __CAPGO_KEEP_9__

   npm install @capacitor-plus/android  # for Android
   npm install @capacitor-plus/ios      # for iOS

3. Capacitor 초기화

   npm

   npx cap init

   pnpm

   pnpm cap init

   yarn

   yarn cap init

   bun

   bunx cap init

4. 플랫폼 추가

   npm

   npx cap add android

   pnpm

   pnpm cap add android

   yarn

   yarn cap add android

   bun

   bunx cap add android

   npm

   npx cap add ios

   pnpm

   pnpm cap add ios

   yarn

   yarn cap add ios

   bun

   bunx cap add ios

공식 Capacitor에서 마이그레이션

기존 Capacitor 프로젝트가 있다면 Capacitor+로 마이그레이션하는 것은 간단합니다.

1. 공식 패키지 제거

   npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios

2. Capacitor+ 패키지 설치

   npm install @capacitor-plus/core @capacitor-plus/cli
   npm install @capacitor-plus/android  # if using Android
   npm install @capacitor-plus/ios      # if using iOS

3. 프로젝트 동기화

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

주의

code의 변경이 필요하지 않습니다! Capacitor+는 공식 Capacitor와 동일한 API를 가지고 있습니다. import 및 code는 동일하게 유지됩니다.

사용

Capacitor+는 API-compatible이므로 기존 code는 변경없이 작동합니다.

import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';

// Check platform
const platform = Capacitor.getPlatform();
console.log('Running on:', platform);

// Check if native
if (Capacitor.isNativePlatform()) {
  console.log('Running on native platform');
}

// Register a custom plugin
const MyPlugin = registerPlugin('MyPlugin');

공식 Capacitor 플러그인과 함께

공식 Capacitor 플러그인은 순수하게 작동합니다.

import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
import { Storage } from '@capacitor/preferences';

// Camera
const photo = await Camera.getPhoto({
  quality: 90,
  resultType: CameraResultType.Uri
});

// Geolocation
const position = await Geolocation.getCurrentPosition();

// Storage
await Storage.set({ key: 'name', value: 'John' });

Capgo 플러그인과 함께

Capgo 플러그인은 Capacitor+와 완벽하게 작동합니다.

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
import { CapacitorFlash } from '@capgo/capacitor-flash';

// Live updates
await CapacitorUpdater.notifyAppReady();

// Screen orientation
await ScreenOrientation.lock({ orientation: 'portrait' });

// Flashlight
await CapacitorFlash.toggle();

Sync 방법

┌─────────────────────┐     ┌──────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  ionic-team/        │     │  CI/CD           │     │  Claude Code     │     │  npm publish    │
│  capacitor          │────▶│  Pipeline        │────▶│  Security Review │────▶│  @capacitor-plus│
│  (upstream)         │     │  (daily sync)    │     │  (AI analysis)   │     │  packages       │
└─────────────────────┘     └──────────────────┘     └──────────────────┘     └─────────────────┘

1. 일일 SyncGitHub Sync는 GitHub Actions에서 최신 변경 사항을 ionic-team/capacitor
2. PR 생성__CAPGO_KEEP_0__ Actions는 변경 사항을 plus branch
3. CI 검증: 전체 테스트 스위트 실행 (lint, 단위 테스트, iOS 빌드, Android 빌드)
4. 보안 검토: 취약점 및 깨진 변경 사항을 검사하는 인공지능 분석
5. 자동 병합: CI가 통과하고 보안 검토가 승인되면만
6. 자동 배포: 새로운 버전이 npm에 배포 @capacitor-plus/*

보안 검토 세부 정보

모든 업스트림 싱크는 다음을 분석합니다:

체크	어떤 것을 잡아내는가?
보안	명령어 주입, XSS, 경로 탐색, 고정된 비밀
변경 사항	삭제/이름이 변경된 API, 서명 변경, 구성 변경
안정성	Null 참조, 예외 처리되지 않은 경우, 경쟁 조건, 메모리 누수
데이터 안전	데이터 손실 시나리오, 개인 정보 침해, 안전하지 않은 저장
Code完整성	code를 암호화한 경우, 수상한 네트워크 호출, 백도어

주의

If any issues are detected, the PR is flagged for manual review and will NOT be auto-merged. This ensures you always get stable, secure releases.

__CAPGO_KEEP_0__ 제출

Capacitor+ repo에 PR이 걸려있는 경우 Capacitor+:

1. __CAPGO_KEEP_0__+ repo에 이슈 열기 __CAPGO_KEEP_0__+ repo Capacitor+ repo에 PR을 제출하는 링크 __CAPGO_KEEP_0__+ repo에 PR을 직접 제출

2. branch에 PR을 제출 팀은 리뷰, CI를 실행하고, 통과하면 병합합니다. plus __CAPGO_KEEP_0__+ repo에 이슈를 열고 upstream PR에 링크합니다.

3. __CAPGO_KEEP_0__+ repo에 PR을 제출합니다.

이 방법으로 당신과 다른 사람들이 당신의 작업에서 즉시 이익을 얻을 수 있습니다. 업스트림 릴리스 사이클을 기다리지 않고.

FAQ

이것은 프로덕션 준비가 되었나요?

네. Capacitor+는 프로덕션 앱에서 사용됩니다. 모든 릴리스는 공식 Capacitor와 동일한 테스트 스위트를 통과하며 추가 보안 분석도 수행됩니다.

내 공식 플러그인은 작동할까요?

네. 모든 플러그인은 __CAPGO_KEEP_0__+와 함께 기본적으로 작동합니다. @capacitor/* plugins work with Capacitor+ out of the box.

업스트림이 브레이킹 변경을 릴리스하면 어떻게 하나요?

The AI security review flags breaking changes for manual review. You’ll see the changes documented before they’re merged.

__CAPGO_KEEP_0__

File issues on the Capacitor + GitHub. For issues that also affect official Capacitor, we’ll help coordinate upstream.

Can I contribute?

Absolutely! PRs are welcome. You can submit fixes directly or request that specific upstream PRs be merged.

__CAPGO_KEEP_0__ from Getting Started

If you are using __CAPGO_KEEP_0__ Getting Started __CAPGO_KEEP_0__을 연결하여 Using Capacitor+ (@capacitor-plus) Packages Capacitor+ (@capacitor-plus) Packages를 사용하여 Capacitor native 기능을 사용할 수 있습니다. Capgo Plugin Directory Capgo Plugin Directory를 사용하여 제품 워크플로를 관리합니다. Capacitor Plugins by Capgo Capacitor Plugins by Capgo에서 구현 세부 정보를 확인합니다. Adding or Updating Plugins Adding or Updating Plugins에서 구현 세부 정보를 확인합니다. Ionic Enterprise Plugin Alternatives Ionic Enterprise Plugin Alternatives에서 제품 워크플로를 관리합니다.