시작하기

새 프로젝트 설치

AI-Assisted Setup을 사용하여 Capacitor+를 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음과 같은 프롬프트를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capacitor-plus/core`, `@capacitor-plus/cli`, `@capacitor-plus/android`, and `@capacitor-plus/ios` packages in my project.

만약 Manual Setup을 선호한다면, 다음 명령어를 실행하여 패키지를 설치하고 아래의 플랫폼별 지침을 따르세요.

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

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

메모

No code changes required! Capacitor+ has the same API as official Capacitor. Your imports and code remain exactly the same.

사용 방법

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

보안 검토 세부 정보

업스트림 동기화가 분석되며 다음과 같은 항목이 검토됩니다:

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

주의

PR에 문제가 발견되면, 수동 검토를 위해 플래그가 지정되고 자동 병합되지 않습니다. 항상 안정적이고 안전한 릴리즈를 받을 수 있도록 합니다.

PR 제출

공식 Capacitor 저장소에 PR이 걸리셨나요? Capacitor+에서 병합하세요:

1. 이슈 열기 Capgo Capacitor 업스트림 PR

2. 직접 제출 branch plus branch

3. 이러한 방식으로 업스트림 릴리스 주기 동안 기다리지 않고 즉시 작업 결과를 얻을 수 있습니다.

FAQ

FAQ

FAQ

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

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

네. 모든 @capacitor/* Capacitor+은 플러그인이 기본적으로 작동합니다.

업스트림이 버그가 있는 변경 사항을 릴리스할 경우 어떻게 해야 하나요?

AI 보안 검토는 버그가 있는 변경 사항을 수동으로 검토하도록 표시합니다. 변경 사항은 병합되기 전에 문서화됩니다.

이슈를 어떻게 보고 하나요?

파일 __CAPGO_KEEP_0__+ __CAPGO_KEEP_1__ 리포지토리에 이슈를 제출하세요. Capacitor+은 실제 앱에서 사용됩니다. 모든 릴리스는 공식 GitHub과 동일한 테스트 스위트를 통과하며 추가 보안 분석도 수행됩니다.. 공식 Capacitor에도 영향을 미치는 문제에 대해서도, 우리는 업스트림을 조율해 줄 것입니다.

제가 참여할 수 있나요?

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

Getting Started에서 계속

Getting Started를 사용하여 Getting Started native 플러그인 작업을 계획하고 연결하려면 Using Capacitor+ (@capacitor-plus) Packages Using Capacitor+ (@capacitor-plus) Packages Capgo 플러그인 디렉토리 제품 워크플로우에 대한 Capgo 플러그인 디렉토리에서 Capacitor 플러그인에 의해 Capgo Capacitor Plus 플러그인 구현 세부 사항에 대한 정보는 Capacitor 플러그인에 의해 Capgo에 의해 제공됩니다. 플러그인을 추가하거나 업데이트 플러그인을 추가하거나 업데이트, 및 아이오닉 엔터프라이즈 플러그인 대체 __CAPGO_KEEP_0__ 제품 워크플로우