Getting Started

새 프로젝트 설치

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

Migrating from Official 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-호환 제품으로, 기존 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();

How the Sync Works

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

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

보안 검토 세부 정보

업스트림 동기화마다 분석되는 항목

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

주의

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

PR 제출

공식 Capacitor 저장소에 PR이 걸려있는 경우 Capacitor+에서 병합하세요:

1. 이슈 열기 __CAPGO_KEEP_0__+ 저장소에서 Capacitor+ repo 또는 __CAPGO_KEEP_0__+ 저장소로 직접 제출하세요

2. branch 팀은 검토, CI를 실행하고 통과하면 병합합니다 plus 이러한 방식으로 업스트림 릴리스 주기 동안 기다리지 않고 즉시 작업의 이점을 누릴 수 있습니다.

3. FAQ

Capgo Builder / 네이티브 클라우드 빌드 제품 페이지. 역할: 섹션 서브 타이틀 또는 태그 라인. page native-build.astro에서 볼 수 있습니다. 메시지 키 `native_build_builder_faq_eyebrow` (네이티브 빌드 빌더 FAQ Eyebrow). | Capgo 솔루션 마케팅 페이지. 역할: 섹션 또는 페이지 제목. page solutions/cordova-to-capacitor.astro에서 볼 수 있습니다. 메시지 키 `solutions_cordova_to_capacitor_faq_title` (솔루션 Cordova To Capacitor FAQ Title).

FAQ 섹션

이것은 프로덕션에 사용할 수 있나요?

Yes. Capacitor+ is used in production apps. Every release passes the same test suite as official Capacitor, plus additional security analysis.

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

예. 모든 @capacitor/* plugins work with Capacitor+ out of the box.

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

AI 보안 검토에서 브레이킹 체인지가 수동 검토를 위해 표시됩니다. 변경 사항은 병합되기 전에 문서화됩니다.

문제를 어떻게 신고할 수 있나요?

파일 문제는 __CAPGO_KEEP_0__+ __CAPGO_KEEP_1__ 저장소에서 Capacitor+ GitHub 저장소에서 Capacitor+ GitHub공식 Capacitor도 영향을 받는 문제가 있는 경우, 업스트림을 조정해 줄 것입니다.

제가 참여할 수 있나요?

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

Getting Started에서 계속

Getting Started을 사용하여 네이티브 플러그인 작업을 계획하고 있다면, __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) 패키지를 연결하세요. Getting Started을 사용하여 네이티브 플러그인 작업을 계획하고 있다면, __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) 패키지를 연결하세요. Using __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) Packages Using Capacitor+ (@capacitor-plus) Packages for the native capability in Using Capacitor+ (@capacitor-plus) Packages, Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리의 제품 워크플로우를 위해 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 구현 세부 정보를 위해 플러그인을 추가하거나 업데이트하는 구현 세부 정보를 위해, Ionic Enterprise 플러그인 대체품 Ionic Enterprise 플러그인 대체품의 제품 워크플로우를 위해 페이지 편집