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

__CAPGO_KEEP_0__이 올바르게 작동하려면 webDir __CAPGO_KEEP_0__이 빌드 출력 폴더와 일치해야 합니다 (예: dist, build, www).

3) iOS + Android 프로젝트 추가

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

4) 빌드 + Sync

bun run build
bunx cap sync

플러그인 대체 매핑 (Capgo-First)

이주가 시작되면 '어느 정도 작동한다'는 플러그인 동작을 받아들이지 마세요. 위험한 플러그인을 일찍 대체하세요 (인증, 결제, 백그라운드 서비스).

사용 사례	Cordova 플러그인 (예시)	권장 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`

Browse Capgo's plugin catalog and map by capability: Capgo plugins.

AI 복사/붙여넣기 가능한 제안

이 제안은 사용 가능한 출력(표, 체크리스트, 계획)을 생성하기 위해 설계되었습니다. (과격한 조언은 제외합니다.)

제안 1: 플러그인 대체 계획을 작성하세요

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 Preferences를 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: 실제 기기 테스트 계획 (Cutover Test Plan)

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의 기술 (이주 친화적)

AI 코딩 에이전트 (Cursor, Claude Code, 등)를 사용 중이라면, 에이전트가 일관된 플레이북을 따라 Capacitor 이주를 수행할 때 더 좋은 결과를 얻을 수 있습니다. Capgo는 Capacitor: 플러그인, 최적화 방법, 디버깅, CI/CD, 실시간 업데이트와 같은 __CAPGO_KEEP_4__를 위한 오픈 소스 기술을 공개합니다.

참조: Capacitor AI Agent의 기술.

전체 옵션을 원하십니까?

기존 사용자에 대한 업그레이드 경로 위험, 플러그인 회귀, 앱 스토어 차단과 같은 문제에 걱정하실 경우, 이주를 종료까지 진행해드립니다.

AI-assisted Cordova를 Capacitor로 마이그레이션 (2026)