AI 기반 Cordova에서 Capacitor로의 마이그레이션 (2026)

Cordova를 떠나면 무엇이 달라지나요?

Capacitor는 웹 앱을 호스팅하는 native app입니다. 실제 Xcode 및 Android Studio 프로젝트를 커밋하고, 기존 웹 code은 유지하며, Cordova 플러그인을 Capacitor 플러그인으로 교체합니다. 이를 통해 작업을 에이전트가 수행하고 사용자가 검토할 수 있는 작은 단계로 쉽게 나눌 수 있습니다.

마이그레이션 체크리스트 (실무 순서)

1) Cordova 앱 감사

현재 상태를 내보내어 마이그레이션 입력 데이터로 보관하세요:

# In your Cordova project
cordova plugin list
cordova platform ls

• config.xml preferences (orientation, status bar 등)
• 플러그인 변수 (API keys, manifest placeholders, URL schemes)
• 사용 중인 커스텀 hooks/scripts
• 내부의 수동 native 수정 사항은 platforms/

2) 웹 앱에 Capacitor 추가하기

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

다음 설정값 webDir 이 빌드 출력 폴더와 일치하는지 확인하세요 (예: dist, build, www).

3) iOS + Android 프로젝트 추가

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

4) 빌드 + 동기화

bun run build
bunx cap sync

플러그인 교체 맵 (Capgo 우선 적용)

로그인, 결제, 스토리지, 백그라운드 서비스처럼 리스크가 큰 플러그인부터 교체하세요. Capgo 플러그인은 MPL-2.0에 따라 무료 오픈 소스로 제공되며, 모든 Capgo 플랜에서 플러그인 버그 리포트가 우선 처리됩니다.

Capgo의 플러그인 카탈로그와 기능을 확인해 보세요: Capgo 플러그인.

복사해서 바로 쓰는 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/background-geolocation
- @capgo/capacitor-social-login
- @capgo/capacitor-native-biometric
- @capgo/native-purchases
- @capgo/capacitor-inappbrowser
- @capgo/capacitor-updater
4) For each mapping, list migration steps and common pitfalls.
Return a prioritized plan (highest risk first).

프롬프트 2: config.xml 설정을 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.

프롬프트 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.

AI 에이전트를 위한 Capgo Skills

Skills는 에이전트가 추측 대신 검증된 플레이북을 따르게 합니다. cordova-to-capacitor skill은 마이그레이션 순서를 다루고, capacitor-plugins는 플러그인 선택과 설치를 돕으며, capgo-live-updates는 마이그레이션 후 updater를 설정합니다. 모든 skill은 오픈 소스이고 명령어 하나로 설치됩니다.

참고: AI 에이전트용 Capacitor Skills.

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

Capgo MCP Server

Capgo CLI로 로그인한 후 로컬 MCP server를 실행하면, 에이전트가 앱 목록 조회, bundle 업로드, channel 관리, native 호환성 확인 및 Native Build 요청을 수행할 수 있습니다. 로컬 설치 없이 사용하려면 에이전트를 api.capgo.app/mcp에 있는 호스팅 MCP server에 연결해 계정을 관리하고 문서를 검색하세요.

npx @capgo/cli@latest login YOUR_API_KEY
npx @capgo/cli@latest mcp

• MCP 명령어 레퍼런스
• Capgo MCP server 알아보기

올인원 솔루션이 필요하신가요?

App Store 심사 거절, 플러그인 회귀, 기존 사용자의 업그레이드 경로가 걱정된다면, 저희 팀이 마이그레이션을 처음부터 끝까지 직접 수행해 드립니다.

• Cordova에서 Capacitor로의 마이그레이션 서비스
• 지속적인 Native 및 릴리스 지원을 위한 프리미엄 서포트