본문 바로가기
2026 AI 지원 마이그레이션

AI 지원 Cordova에서 Capacitor로 마이그레이션 (2026)

AI 코딩 에이전트가 따라갈 수 있는 계획을 주세요: Capgo의 cordova-to-capacitor 스킬을 설치하고, 아래 프롬프트에 플러그인 목록을 붙여넣고, 플러그인 맵을 확인한 후 Capgo MCP 서버를 연결해 번들을 업로드하고 빌드를 요청하세요. 모든 변경 사항은 직접 검토합니다.

마지막 업데이트:

Martin이 직접 제공하는 지원

작동 방식

AI 에이전트로 마이그레이션 실행하기

하나의 스킬, 하나의 인벤토리, 검토된 작은 단계, 그리고 릴리스 전 실제 디바이스 테스트.

  1. Capgo 스킬 설치

    코딩 에이전트에 cordova-to-capacitor 스킬을 추가하세요. 에이전트가 마이그레이션 순서와 Capacitor 플러그인 선택지를 알게 됩니다.

    npx skills add https://github.com/Cap-go/capgo-skills --skill cordova-to-capacitor
    AI 에이전트용 Capacitor Skills
  2. code 대신 플러그인 맵부터 시작하세요

    에이전트에게 Cordova 프로젝트를 읽고 플러그인 교체 테이블을 먼저 만들어 달라고 요청하세요. 파일을 변경하기 전에 검토하세요.

    Use the cordova-to-capacitor skill from Cap-go/capgo-skills to migrate this Cordova app to Capacitor. Start with a plugin replacement table and wait for my review before changing files.
    전체 프롬프트 복사하기
  3. 각 단계 검토 및 디바이스 테스트

    에이전트가 Capacitor를 추가하고, config.xml 설정을 옮기며, 작은 단위의 커밋으로 플러그인을 교체하도록 하세요. 권한, 딥 링크, 현재 스토어 버전에서의 업그레이드를 실제 디바이스에서 테스트하세요.

    bunx cap sync
    bunx cap run ios
    bunx cap run android
    마이그레이션 체크리스트
  4. Capgo MCP 서버를 연결해 배포하기

    MCP 서버가 실행 중이면 에이전트가 번들을 업로드하고, 채널을 관리하고, Native Build를 요청할 수 있습니다. 플러그인 변경 사항은 여전히 스토어 출시가 필요합니다.

    npx @capgo/cli@latest login YOUR_API_KEY
    npx @capgo/cli@latest mcp
    MCP 명령어 레퍼런스

Cordova를 떠나면 달라지는 것

Capacitor는 웹 앱을 호스팅하는 네이티브 앱입니다. 실제 Xcode와 Android Studio 프로젝트를 커밋하고, 기존 웹 code를 유지하며, Cordova 플러그인을 Capacitor 플러그인으로 교체합니다. 이를 통해 에이전트가 처리하고 여러분이 검토할 수 있는 작은 단계로 작업을 나누기 쉬워집니다.

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

1) Cordova 앱 점검

현재 가진 것을 내보내 마이그레이션 입력으로 보관하세요:

# In your Cordova project
cordova plugin list
cordova platform ls
  • config.xml 설정 (화면 방향, 상태 표시줄 등)
  • 플러그인 변수 (API 키, 매니페스트 플레이스홀더, URL 스킴)
  • 의존하는 커스텀 훅/스크립트
  • 내부의 수동 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 플랜에서 플러그인 버그 리포트가 우선 처리됩니다.

사용 사례 Cordova 플러그인 (예시) 추천 Capacitor 대체 플러그인
카메라 캡처 cordova-plugin-camera @capacitor/camera + @capgo/camera-preview
인앱 브라우저 cordova-plugin-inappbrowser @capgo/capacitor-inappbrowser
백그라운드 위치 @transistorsoft/cordova-background-geolocation-lt / cordova-plugin-geolocation @capgo/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 @capgo/capacitor-data-storage-sqlite / @capgo/capacitor-fast-sql
인앱 결제 cordova-plugin-purchase @capgo/native-purchases
문서 스캔 cordova-plugin-document-scanner @capgo/capacitor-document-scanner
OTA / 라이브 업데이트 Ionic Appflow 배포 @capgo/capacitor-updater ( @capgo/cordova-updater Cordova를 계속 쓰면서)

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 서버

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

올인원 옵션이 필요하신가요?

앱 스토어 차단 요인, 플러그인 회귀, 기존 사용자의 업그레이드 경로가 걱정된다면 저희 팀이 마이그레이션을 처음부터 끝까지 진행해 드릴 수 있습니다.

Capacitor로 빌드된 앱

복잡한 앱일수록 숨겨진 마이그레이션 체크리스트가 드러납니다

마켓플레이스, 뱅킹, 티켓팅 앱은 검색, 계정, 미디어, 위치 및 트랜잭션 플로우가 결합되어 있습니다. AI 지원 마이그레이션은 이 기능 범위를 Capacitor 플러그인 맵, 테스트 플랜, 단계적 롤아웃 체크리스트로 전환하는 데 도움이 됩니다.

Cars.co.za 앱 아이콘 자동차 및 차량

Cars.co.za

매물 리스팅, 검색, 사진 및 계정 플로우를 갖춘 자동차 마켓플레이스 앱입니다.

Google Play 설치 수
190만
스토어 평점
4.4
Vyom - Union Bank of India 앱 아이콘 금융

Vyom - 인도 유나이티드 뱅크

결제 및 계좌 화면을 포함한 Union Bank of India의 모바일 뱅킹 앱.

Google Play 설치 수
2,800만
스토어 평점
3.7
KAI Access: 기차 예약 앱 아이콘 여행 및 지역 정보

KAI Access: 기차 예약 앱

열차 예약, 일정 변경, 운행 상태 확인을 위한 인도네시아 철도 앱.

Google Play 설치 수
1,350만
스토어 평점
3.6

고객 사례

Capgo로 배포하는 팀들의 이야기

5.0/5 개발 팀 평점 9,400+ 팀 리뷰 보기
Mikołaj Wilczek의 사진

미코와이 윌체크

Tellent 수석 모바일 플랫폼 엔지니어

&ldquo;처음에는 플러그인을 통해 Capgo를 알게 됐고, 그게 저희 팀의 릴리스 프로세스를 훨씬 더 효율적으로 만드는 좋은 계기가 됐습니다.&rdquo;

Michael Haberler의 인물 사진

Michael Haberler

데이터 지표

&ldquo;업데이터 플러그인 정말 잘 만드셨네요. 제 환경에서는 완벽하게 동작하고, 라이브 업데이트 덕분에 테스트 주기가 훨씬 빨라졌습니다.&rdquo;

Sergiu S의 사진

Sergiu S

drivolino GmbH 리드 개발자

&ldquo;Capgo Capacitor Updater 플러그인 덕분에 업데이트 배포 방식이 완전히 바뀌었습니다. 며칠씩 걸리던 작업이 이제는 단 몇 분 만에 끝납니다.&rdquo;

자주 묻는 질문

AI 마이그레이션 관련 질문

팀들이 Cordova 마이그레이션을 에이전트에게 맡기기 전에 묻는 것들.

AI 에이전트가 Cordova 앱을 스스로 마이그레이션할 수 있나요?

Capacitor 추가, config.xml 설정 이전, 플러그인 교체 같은 단순 작업은 대부분 처리할 수 있습니다. 그래도 변경 사항 검토, 실제 기기 테스트, 서명 및 스토어 출시는 직접 해야 합니다.

AI 에이전트용 Capacitor Skills

어떤 Capgo 스킬을 설치해야 하나요?

cordova-to-capacitor로 시작하세요. 플러그인 선택을 위해 capacitor-plugins를 추가하고, 마이그레이션 후 Live Updates를 설정할 때는 capgo-live-updates를 추가하세요. 원한다면 명령어 하나로 전체 세트를 설치할 수도 있습니다.

AI 에이전트용 Capacitor Skills

Capgo MCP 서버는 어떤 기능을 제공하나요?

로컬 서버에서는 앱 목록 조회 및 생성, 번들 업로드 및 목록 조회, 채널 관리, 네이티브 호환성 확인, 통계 조회, Native Build 요청을 할 수 있습니다. 사용자의 Capgo CLI 로그인을 사용합니다.

MCP 명령어 레퍼런스

맵에 표시된 Capgo 플러그인들은 유료인가요?

아니요. Capgo 플러그인은 MPL-2.0 라이선스의 오픈 소스입니다. Capgo 플랜에는 Live Updates, Native Build, 플러그인 버그 리포트 우선 처리가 포함됩니다.

Capgo 플러그인 둘러보기

에이전트가 작업을 멈추면 어떻게 하나요?

어려운 부분은 저희 팀에 맡기세요. Cordova에서 Capacitor로의 마이그레이션을 고정 가격 프로젝트로 진행하며, Premium Support를 이용하면 Capacitor 엔지니어와 직접 연결됩니다.

Cordova에서 Capacitor로의 마이그레이션 서비스