본문 바로가기
Replit 로고

Replit에서 Capgo로 모바일 앱 배포하기

Replit은 Capacitor 앱을 빌드하고 배포하며 라이브 업데이트합니다: Mac 없이도 iOS 및 Android 빌드, 몇 분 안에 OTA 수정, 원클릭 롤백.

  • 앱 빌더
  • Capacitor로 export
  • 호스팅 MCP
  • CLI

Replit에서 Capgo 설정하기

3단계 이하로 끝납니다. 각 블록을 그대로 복사하세요.

  1. 1단계

    Replit Shell에서 앱 열기

    Replit에서 제공하는 Shell을 사용하여 다음 단계를 진행하세요. 또는 Replit에서 GitHub로 push한 뒤 로컬 컴퓨터에서 clone하여 사용할 수도 있습니다.

    Shell
    $ npm install $ npm run build

  2. 2단계

    Capacitor 및 Capgo로 래핑하기

    iOS 및 Android용 Capacitor를 추가한 후, Capgo CLI를 통해 Live Update를 설정하세요. Replit 앱의 build 폴더를 webDir로 지정하면 됩니다 (Vite의 경우 dist).

    Terminal
    $ npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android $ npx cap init "Your App" com.company.app --web-dir dist $ npx cap add ios && npx cap add android $ npx @capgo/cli@latest init

  3. 3단계

    클라우드에서 빌드하고 업데이트를 배포하세요

    Capgo Build는 Mac 없이도 iOS 및 Android 앱을 서명하고 빌드합니다. 이후 모든 웹 변경 사항은 live update로 배포됩니다.

    터미널
    $ npx @capgo/cli@latest build init $ npx @capgo/cli@latest build request --platform ios $ npx @capgo/cli@latest bundle upload --channel production

Replit에 요청할 수 있는 내용

프롬프트를 복사하여 Replit에 붙여넣으세요. 앱 ID와 버전을 본인의 것으로 변경하면 됩니다.

  • 빌드

    “이 앱을 Capacitor에 맞게 준비해 줘: 라우팅은 클라이언트 사이드에서 유지하고, 정적 파일은 dist 폴더로 빌드해 줘.”

  • 빌드

    “@capgo/capacitor-updater를 설치하고 앱이 시작될 때 notifyAppReady를 호출하세요.”

  • 업데이트

    “main 브랜치에 push할 때마다 Capgo 번들을 production 채널로 upload하는 GitHub Actions 워크플로우를 추가하세요.”

  • 빌드

    “Capgo에서 진행한 마지막 iOS build 상태가 어때?”

  • 롤백

    “프로덕션 채널을 이전 bundle로 롤백해줘.”

  • Observe

    “지난 7일 동안 v2.3.0의 업데이트 통계를 보여줘.”

  • Publish

    “Android release build를 요청하고 Google Play 내부 트랙으로 전송해줘.”

전체 릴리스 루프

첫 build부터 다음 라이브 수정까지, 하나의 계정으로 모든 단계를 커버합니다.

  1. 1

    빌드

    클라우드에서 서명된 iOS 및 Android build. Mac이나 Xcode는 필요 없습니다.

    Capgo 네이티브 앱 빌드
  2. 2

    배포하기

    빌드를 TestFlight 및 Google Play로 전송하거나 스토어 심사를 위해 제출하세요.

    Mac 없이 iOS 앱 빌드 및 배포하기
  3. 3

    업데이트

    JavaScript, HTML, CSS 수정 사항을 몇 분 만에 채널에 반영하세요. 클릭 한 번으로 롤백도 가능합니다.

    Capgo Live Update 사용하기
  4. 4

    Observe

    업데이트 대상, 실패 원인, 그리고 각 릴리스의 성능을 확인하세요.

    Capgo Observe 시작하기

Replit 참고 사항 및 제한 사항

  • Replit Agent는 원격 MCP 서버를 지원합니다. replit.com/integrations로 이동하여 MCP Servers 항목에 https://api.capgo.app/mcp를 추가하고 OAuth로 로그인하세요.
  • Replit Shell에서 Capgo CLI을 실행할 수 있으므로, 브라우저에서 바로 build와 upload가 가능합니다. 해당 환경에서 Capgo API 키를 사용하여 npx @capgo/cli@latest login를 한 번 실행하세요.
  • Replit Agent는 로컬 MCP 서버를 시작하지 않습니다. 호스팅된 MCP와 Shell의 CLI를 사용하세요.

자주 묻는 질문

Capgo 및 Replit: 자주 묻는 질문

Mac 없이 Replit으로 iOS 앱을 빌드할 수 있나요?

네, code를 export한 후 가능합니다. 웹 앱을 Capacitor로 래핑한 다음 npx @capgo/cli@latest build request를 실행하세요. Capgo가 클라우드에서 iOS 및 Android 앱을 서명하고 빌드합니다.

Native Build 문서

Replit 사용을 위해 Capgo API 키가 필요한가요?

호스팅 MCP에는 API 키가 필요 없습니다. OAuth로 로그인하기 때문입니다. 로컬 CLI MCP와 CLI는 npx @capgo/cli@latest login로 한 번만 저장하면 되는 API 키를 사용합니다. 키는 Capgo 콘솔의 Settings > Organization > API keys에서 생성하세요.

Capgo API 키 생성하기

Replit에서 잘못된 업데이트를 롤백할 수 있나요?

네. Replit이 채널을 이전 bundle로 다시 가리키도록 요청하면 됩니다. 기기는 다음 업데이트 확인 시점에 전환됩니다. 또한 Capgo updater는 새 bundle 실행에 실패할 경우 자체적으로 롤백을 수행합니다.

Live update 문서

App Store와 Google Play에서 Live Updates가 허용되나요?

네, 웹 레이어(JavaScript, HTML, CSS, 에셋)는 가능합니다. Native code, 새 권한, 새 플러그인은 여전히 스토어 출시가 필요하며, Capgo Build로 처리할 수 있습니다.

Replit에서 Capgo를 사용하는 비용은 얼마인가요?

MCP 서버와 스킬, CLI 모두 무료로 사용할 수 있습니다. Capgo 플랜이 필요하며, 모든 플랜은 신용카드 없이 14일 무료 체험으로 시작합니다. Build, Live Updates, Observe는 모든 플랜에 포함됩니다.

요금제

Replit에서 다음 릴리스를 배포하세요

Capgo 계정을 생성하고 Replit을 연결하여, 오늘 바로 첫 번째 build 또는 live update을 푸시해 보세요.

문서

관련 페이지