안내서
Capacitor+ 코어를 Capacitor에서 사용하는 방법
Capacitor+ (@capacitor-plus) 패키지를 사용하는 방법
Capacitor+는 항상 동기화된 자동화된 Capacitor의 분기입니다. Capacitor __CAPGO_KEEP_0__를 유지합니다. CapgoCapacitor __CAPGO_KEEP_0__.
Capacitor
Capacitor
Capacitor
- __CAPGO_KEEP_0__ __CAPGO_KEEP_0__
- __CAPGO_KEEP_0__ Capacitor
- __CAPGO_KEEP_0__ npm
@capacitor-plus범위 - 커뮤니티-중심 - 여러분의 기여가 중요하고 우선순위로 처리됩니다
- 보안 검토 - 모든 변경 사항은 AI를 통해 보안 취약점, 깨진 변경 사항 및 안정성 위험을 분석합니다
사용 가능한 패키지
| 패키지 | 설명 |
|---|---|
@capacitor-plus/core |
코어 런타임 라이브러리 |
@capacitor-plus/cli |
명령줄 인터페이스 |
@capacitor-plus/android |
안드로이드 런타임 |
@capacitor-plus/ios |
iOS 런타임 |
설치
새 프로젝트
새 프로젝트를 시작하려면 공식 Capacitor 패키스 대신 Capacitor+ 패키스를 사용하세요:
npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android # for Android
npm install @capacitor-plus/ios # for iOS
그 다음에 프로젝트를 초기화하세요:
npx cap init
npx cap add android
npx cap add ios
공식 Capacitor에서 __CAPGO_KEEP_1__+로 이전하기
Capacitor+는 공식 Capacitor와 동일한 Capacitor을 사용하므로 __CAPGO_KEEP_2__ 변경이 필요하지 않습니다. import 문은 동일합니다:
# Remove official packages
npm uninstall @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios
# Install Capacitor+ packages
npm install @capacitor-plus/core @capacitor-plus/cli
npm install @capacitor-plus/android # if using Android
npm install @capacitor-plus/ios # if using iOS
Capacitor+는 동일한 API를 사용하는 대체품이므로 code 변경이 필요하지 않습니다. import 문은 동일하게 유지됩니다.
// These imports work the same with Capacitor+
import { Capacitor } from '@capacitor/core';
import { registerPlugin } from '@capacitor/core';
컨텍스트: Capgo 빌더 / 네이티브 클라우드 빌드 제품 페이지. 역할: 섹션 또는 페이지 제목. 메시지 키 `native_build_how_it_works_title` (네이티브 빌드 작동 방식 제목). | 홈 페이지 문제/해결 섹션. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 페이지 프리미엄-서포트.아스트로에서 보입니다. 메시지 키 `ps_how_it_works` (PS 작동 방식). | 라이브 업데이트 제품 페이지. 역할: 섹션 또는 페이지 제목. 메시지 키 `live_update_how_it_works_title` (라이브 업데이트 작동 방식 제목).
┌─────────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ ionic-team/ │ │ CI/CD │ │ Claude Code │ │ npm publish │
│ capacitor │────▶│ Pipeline │────▶│ Security Review │────▶│ @capacitor-plus│
│ (upstream) │ │ (daily sync) │ │ (AI analysis) │ │ packages │
└─────────────────────┘ └──────────────────┘ └──────────────────┘ └─────────────────┘
- 일일 동기화: GitHub 액션은 최신 변경 사항을 GitHub에서 가져옵니다
ionic-team/capacitor - PR 생성: 변경 사항은 Pull Request로 제안됩니다
plusbranch - CI 검증전체 테스트 스위트 실행 (lint, 단위 테스트, iOS 빌드, Android 빌드)
- Claude Code Review: AI-기반의 종합 보안 분석을 위한 검사입니다.
- 보안 취약점 (인젝션, XSS 등)
- 업데이트 API를 위한 중요한 변경
- 안정성 이슈
- 데이터 무결성 및 개인 정보 보호
- Malicious code patterns
- Auto-Merge: CI가 통과하고 Claude가 승인 (이슈 없음)
- 자동 배포: 새로운 버전이 npm 에서
@capacitor-plus/*
보안 검토
모든 업스트림 동기화가 분석됩니다:
| 확인 | 설명 |
|---|---|
| 보안 | 명령어 주입, XSS, 경로 탐색, 고정 비밀, 등 |
| 변경 사항 | 제거/이름 변경된 API, 서명 변경, 구성 형식 변경 |
| 안정성 | null 참조, 예외 처리되지 않은 예외, 경쟁 조건, 메모리 누수 |
| 데이터 안전 | 데이터 손실 시나리오, 개인 정보 침해, 안전하지 않은 저장 |
| Code의完整성 | code의 가려진 버전, 수상한 네트워크 호출, 백도어 |
이러한 문제가 발견되면 PR은 수동 검토를 위해 표시되고 자동 병합되지 않습니다.
PR을 병합하고 싶으세요?
Capacitor 공식 저장소에 PR이 걸리게 되면 어떻게 해야 하나요? Capacitor+에 넣으려면 어떻게 해야 하나요?
- 이슈를 열어보세요 in the Capacitor+ 저장소 __CAPGO_KEEP_0__+ 저장소에 링크된 upstream PR
- PR을 직접 제출하세요 Capacitor Plus
plusbranch - 팀은 검토하고 CI를 실행한 후 통과하면 병합합니다.
이 방식으로, 당신과 다른 사람들은 당신의 작업에서 즉시 이익을 얻을 수 있으며, 업스트림 릴리스 사이클을 기다리지 않아도 됩니다.
Benefits
- 현재 PR을 지금 확인하세요: 업스트림으로 기다리는 커뮤니티.fixes 및 기능이 병합됩니다.
- 최신 버전 유지: Live Update를 통해 CI가 통과한 즉시 업스트림 수정 사항을 받습니다.
- 안전성 최우선: 모든 변경 사항은 취약점 및 안정성 위험을 검토합니다.
- 인증된 릴리스: CI 테스트와 AI 보안 검토 모두 통과한 변경 사항만 게시됩니다.
- Drop-in Replacement: API와 Capacitor은 동일한 기능을 하지만 패키지 범위만 다른 것입니다.
- 당신의 목소리가 중요합니다.: 자신의 PR를 제출하거나 특정 업스트림 PR를 병합 요청하세요
예시: Capacitor+ 플러그인을 사용하는 방법
All official Capacitor plugins work seamlessly with Capacitor+:
import { Capacitor } from '@capacitor/core';
import { Camera, CameraResultType } from '@capacitor/camera';
import { Geolocation } from '@capacitor/geolocation';
// Everything works exactly the same
const platform = Capacitor.getPlatform();
const photo = await Camera.getPhoto({
resultType: CameraResultType.Uri
});
const position = await Geolocation.getCurrentPosition();
Capgo 플러그인은 Capacitor+와 완벽하게 호환됩니다.
import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { ScreenOrientation } from '@capgo/capacitor-screen-orientation';
// Use Capgo plugins with Capacitor+
await CapacitorUpdater.notifyAppReady();
await ScreenOrientation.lock({ orientation: 'portrait' });
그것이 다입니다! 이제 Capacitor의 커뮤니티 개선 사항이 더 빠르게 병합된 __CAPGO_KEEP_1__+ 버전을 사용할 수 있습니다. 앱은 버그 수정 및 기능을 공식 릴리스 주기 기다리지 않고 누릴 수 있습니다.
Capacitor+ (@capacitor-plus) 패키지에서 계속 사용하세요.
만약 __CAPGO_KEEP_0__+ (@__CAPGO_KEEP_1__-plus) Packages를 사용하고 있다면 Capacitor+ (@capacitor-plus) 패키지 native 플러그인 작업을 계획하기 위해, 그것을 연결하세요. Capacitor+ implementation 세부 사항에 대해 Capacitor+에서 Capgo 플러그인 디렉토리 제품 워크플로우에 대해 Capgo 플러그인 디렉토리에서 Capacitor 플러그인들에 의해 Capgo implementation 세부 사항에 대해 Capacitor 플러그인들에 의해 Capgo에서 플러그인 추가 또는 업데이트 implementation 세부 사항에 대해 플러그인 추가 또는 업데이트, 그리고 Ionic Enterprise 플러그인 대체 제품 워크플로우에 대해 Ionic Enterprise 플러그인 대체에서