Getting Started

새 프로젝트 설치

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

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

다음 명령어를 사용하여 __CAPGO_KEEP_1__ 스킬을 AI 도구에 추가하세요:

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. Core 패키지 설치

   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에서 __CAPGO_KEEP_1__+로 이동하기

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

보안 검토 세부 정보

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

검사	검사하는 것
보안	명령어 주입, XSS, 경로 탐색, 고정 비밀
변경 사항	제거/이름이 변경된 API, 서명이 변경된 API, 구성 변경
안정성	Null dereferences, unhandled exceptions, race conditions, memory leaks
데이터 안전	데이터 손실 시나리오, 개인 정보 침해, 안전하지 않은 저장
Code의完整성	code의 가려진 부분, 수상한 네트워크 호출, 백도어

주의

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

PR 제출

PR이 공식 Capacitor 저장소에 걸리게 되면? Capacitor+:에서 병합하세요.

1. 이슈 열기 __CAPGO_KEEP_0__ Capacitor+ repo 업스트림 PR에 연결

2. 직접 PR 제출 업스트림 PR plus branch

3. 팀은 리뷰, CI를 실행, 그리고 통과하면 병합합니다.

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

FAQ

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

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

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

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

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

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

문제를 어떻게 보고할까요?

파일 __CAPGO_KEEP_0__+ __CAPGO_KEEP_1__ 리포지토리에 이슈를 제출하세요. Capacitor+ GitHub. 공식 Capacitor에 영향을 미치는 문제들에 대해서도, 우리는 업스트림을 조정하는 데 도움을 줄 것입니다.

contribue할 수 있나요?

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

Getting Started에서 계속하기

native plugin 작업을 계획하고 있으면 Getting Started __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) 패키지를 사용하여 Capacitor+ (@capacitor-plus) 패키지를 사용하여 native 기능을 연결합니다. for the native capability in Using Capacitor+ (@capacitor-plus) Packages, Capgo 플러그인 디렉토리 Capgo 제품 워크플로우 디렉토리에서 제품 워크플로우를 위한 Capgo에 의해 Capacitor 플러그인 Capacitor 플러그인에 의해 Capgo의 구현 세부 사항 플러그인을 추가하거나 업데이트 __CAPGO_KEEP_0__ 플러그인에 의해 __CAPGO_KEEP_1__의 구현 세부 사항, 그리고 아이오닉 엔터프라이즈 플러그인 대체 __CAPGO_KEEP_0__ 제품 워크플로우 디렉토리에서 아이오닉 엔터프라이즈 플러그인 대체