Cordova를 떠나는 것의 변화

Capacitor는 네이티브 앱을 호스팅하는 웹 앱과 더 가깝습니다. 실제 Xcode와 Android Studio 프로젝트를 배달하고, 기존 웹 code을 유지하고, Capacitor-첫 번째 API를 사용하여 플러그인을 현대화합니다.

이동 체크리스트 (실용적인 순서)

1) Cordova 앱을 감사하세요

현재 상태를 내보내고, 이중으로 사용할 수 있도록 하세요:

# In your Cordova project
cordova plugin list
cordova platform ls

config.xml 기본 설정 (방향, 상태 바 등)
플러그인 변수 (API 키, 매니페스트 홀더, URL 스키마)
사용하는 커스텀 훅/스크립트
웹 앱 내부에 수동으로 네이티브 편집 platforms/

2) Capacitor을 웹 앱에 추가하세요

bun add @capacitor/core @capacitor/cli
bunx cap init

빌드 출력 폴더와 일치하는지 확인하세요 (예: webDir 3) iOS + Android 프로젝트 추가 dist, build, www).

4) 빌드 + Sync

bun add @capacitor/ios @capacitor/android
bunx cap add ios
bunx cap add android

__CAPGO_KEEP_0__-첫 번째 플러그인 대체 매핑

bun run build
bunx cap sync

Plugin Replacement Map (Capgo-First)

사용 사례

Cordova 플러그인 (예시)	권장 __CAPGO_KEEP_0__ 대체	권장 Capacitor 대체
카메라 캡처	`cordova-plugin-camera`	`@capacitor/camera` + `@capgo/capacitor-camera-preview`
인앱 브라우저	`cordova-plugin-inappbrowser`	`@nicholasalx/capacitor-inappbrowser`
배경 위치 추적	`@transistorsoft/cordova-background-geolocation-lt` / `cordova-plugin-geolocation`	`@capgo/capacitor-background-geolocation`
생체 인증	`cordova-plugin-fingerprint-aio` / `cordova-plugin-touch-id`	`@capgo/capacitor-native-biometric`
소셜 로그인	`cordova-plugin-googleplus` / `cordova-plugin-facebook4` / `cordova-plugin-sign-in-with-apple`	`@capgo/capacitor-social-login`
SQLite	`cordova-sqlite-storage`	`@nicholasalx/capacitor-data-storage-sqlite` / `@nicholasalx/capacitor-fast-sql`
인앱 구매	`cordova-plugin-purchase`	`@capgo/capacitor-native-purchases`
문서 스캔	`cordova-plugin-document-scanner`	`@capgo/capacitor-document-scanner`
OTA / 실시간 업데이트	`Ionic Appflow`	`@capgo/capacitor-updater`

Capgo의 플러그인 카탈로그를 기능별로 탐색하세요: Capgo 플러그인.

__CAPGO_KEEP_0__의 AI 프롬프트를 복사/붙여넣기하세요

These prompts are designed to produce usable outputs (tables, checklists, plans), not vague advice.

Prompt 1: Plugin 대체 계획을 작성하세요

You are a senior Capacitor engineer.

I am migrating a Cordova app to Capacitor. Here is my `cordova plugin list` output:
<PASTE HERE>

1) Create a table mapping each Cordova plugin to a recommended Capacitor alternative.
2) Prefer official Capacitor plugins when possible.
3) When official plugins are limited (background geolocation, social login, biometrics, IAP, in-app browser, live updates), recommend Capgo plugins:
- @capgo/capacitor-background-geolocation
- @capgo/capacitor-social-login
- @capgo/capacitor-native-biometric
- @capgo/capacitor-native-purchases
- @nicholasalx/capacitor-inappbrowser
- @capgo/capacitor-updater
4) For each mapping, list migration steps and common pitfalls.
Return a prioritized plan (highest risk first).

Prompt 2: config.xml Preference를 Capacitor + Native 변경으로 변환하세요

You are migrating Cordova to Capacitor.

Here is my Cordova `config.xml`:
<PASTE HERE>

Create a migration checklist:
1) What goes into capacitor.config.ts (appId, appName, webDir, server config for dev only).
2) What must be moved to iOS (Info.plist, entitlements, URL schemes, permissions strings).
3) What must be moved to Android (AndroidManifest, Gradle, intent filters, permissions).
Be explicit about file names and what to change.

Prompt 3: 실제 기기에서 테스트 계획

You are the QA lead for a Cordova -> Capacitor migration.

App description:
<PASTE HERE>

Features that rely on native plugins:
<LIST HERE>

Create a test plan for iOS and Android that includes:
- permission flows (fresh install, denied, restricted, limited)
- background behavior (if any)
- deep links / universal links (if any)
- upgrade path from the existing Cordova app version
Output as a checklist that an engineer can run in 2-3 hours per release candidate.

Capgo AI Agent의 기술 (이주하기 쉬운)

If you're using an AI coding agent (Cursor, Claude Code, etc.), you'll get better results when the agent follows a consistent playbook for Capacitor migrations. Capgo publishes open-source skills for Capacitor: plugins, best practices, debugging, CI/CD, and live updates.

See: Capacitor AI Agent의 기술.

전체 옵션을 원하십니까?

If you're worried about app store blockers, plugin regressions, or upgrade-path risks for existing users, we can run the migration end-to-end.

AI-Assisted Cordova to Capacitor Migration (2026)