시작하기

새 프로젝트 설치

1. 핵심 패키지 설치

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

2. 플랫폼 패키지 추가

   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

Migrating from Official Capacitor

기존 Capacitor 프로젝트가 있는 경우 Capacitor+로의 이주는 간단합니다:

1. official 패키지를 제거하십시오

   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 - 호환되므로, 기존 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 공식 플러그인과 함께

All official Capacitor plugins work seamlessly:

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_KEEP_1__ +와 완벽하게 호환됩니다.

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. 일일 Sync: GitHub Actions 최신 변경 사항을 ionic-team/capacitor
2. PR 생성: 변경 사항이 Pull Request로 제안됩니다. plus branch
3. CI 검증: 전체 테스트 스위트가 실행됩니다. (lint, 단위 테스트, iOS 빌드, Android 빌드)
4. 보안 검토: AI-powered 분석이 취약점 및 깨지는 변경 사항을 확인합니다.
5. 자동 병합: CI가 통과하고 보안 검토가 승인하면만
6. 자동 배포: 새로운 버전이 npm 하위에 @capacitor-plus/*

보안 검토 세부 정보

모든 업스트림 동기화는 다음을 분석합니다:

검사	검사하는 것
보안	명령어 주입, XSS, 경로 탐색, 고정 비밀
파괴적인 변경	Removed/renamed APIs, changed signatures, config changes
안정성	Null dereferences, unhandled exceptions, race conditions, memory leaks
데이터 안전	데이터 손실 시나리오, 개인 정보 침해, 안전하지 않은 저장
Code의完整성	code를 암호화한 경우, 수상한 네트워크 호출, 백도어

주의

PR에 문제가 발견되면, 자동 병합이 아닌 수동 검토를 위해 PR이 표시됩니다. 항상 안정적이고 안전한 릴리즈를 받을 수 있도록 합니다.

PR 제출

공식 Capacitor 저장소에 PR이 걸려있는 경우 Capacitor+:에 머지하세요.

1. 이슈 열기 공식 Capacitor+ 저장소 업스트림 PR에 대한 링크를 포함하여

2. 또는 직접 branch로 PR 제출 plus 팀은 검토, CI를 실행하고, 통과하면 머지합니다.

3. 이러한 방식으로, 당신과 다른 사람들은 업스트림 릴리즈 사이클을 기다리지 않고 즉시 당신의 작업의 이점을 누릴 수 있습니다.

FAQ

FAQ

이것은 프로덕션에 적합한가요?

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

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

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

제목: 업스트림이 브레이킹 체인지를 릴리스할 경우 어떻게 해야 하나요?

이슈를 보고하려면 어떻게 해야 하나요?

제목: 이슈를 보고하려면 어떻게 해야 하나요?

이슈를 제출하세요. Capacitor + GitHub 저장소. 공식 Capacitor도 영향을 받는 경우, 우리는 업스트림을 조율해 드릴 것입니다.

제가 참여할 수 있나요?

물론! PR은 환영합니다. 직접 수정하거나 특정 업스트림 PR을 병합 요청할 수 있습니다.

Getting Started

native 플러그인 작업을 계획 중이라면 Getting Started Getting Started Using Capacitor+ (@capacitor-plus) Packages 자연스러운 기능을 위해 Capacitor+ (@capacitor-plus) 패키지에 대한 원시 기능에 대해 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에 대한 제품 워크플로우에 대해 Capacitor 플러그인에 의해 Capgo Capacitor 플러그인에 의해 Capgo의 구현 세부 사항에 대해 플러그인을 추가하거나 업데이트하는 구현 세부 사항에 대해 Ionic Enterprise 플러그인 대체품에 대한 구현 세부 사항 Ionic Enterprise 플러그인 대체품에 대한 제품 워크플로우 편집 페이지