Capgo Build 소개

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

Capgo Build는 Capacitor 앱을 위한 클라우드 기반 네이티브 앱 컴파일 서비스입니다. 로컬 개발 환경을 유지할 필요 없이 iOS 및 Android 앱을 빌드할 수 있습니다. Xcode, Android Studio, Mac 하드웨어가 필요 없습니다.

Capgo Build의 역할

Capgo Build는 다음을 컴파일합니다: native 파트 클라우드에서 Capacitor 앱의

iOS 빌드

전용 Mac Mini Silicon M4 머신에서 실행되므로, 별도의 Mac이 필요 없습니다.

Android 빌드

Android Studio 2025가 지원되는 동일한 M4 플릿에서 빌드하세요.

자동 Code 서명

인증서, 프로비저닝 프로파일, keystore를 모두 알아서 처리합니다.

스토어 직접 제출

서명된 앱이 App Store Connect와 Google Play로 바로 업로드됩니다.

로컬 머신, GitHub Actions, GitLab CI 또는 모든 CI/CD 파이프라인 어디서든 단 한 번의 CLI 명령으로 빌드를 실행하세요.

Build 머신과 툴체인

Capgo Build는 전용 Mac Mini Silicon M4 머신에서 네이티브 작업을 실행합니다:

구성 요소	사양
머신	Mac Mini Silicon M4
CPU	10코어 M4 CPU (성능 코어 4개, 효율 코어 6개)
GPU	10코어 GPU
Neural Engine	16코어 Neural Engine
메모리	16GB RAM
OS 이미지	macOS Tahoe 26.2

빌드 이미지는 네이티브 빌드 파이프라인을 위해 Xcode 26.2와 Android Studio 2025를 지원합니다.

Capgo Build vs Live Updates, 언제 써야 할까?

Capgo은 앱을 업데이트하기 위한 두 가지 보완 기능을 제공합니다. 각 기능을 언제 사용해야 하는지 확인하세요:

시나리오	Live Update	Capgo 빌드
JavaScript/TypeScript code 버그 수정	✓
UI 변경 사항 (HTML, CSS, 이미지)	✓
웹 의존성 업데이트	✓
Capacitor 플러그인 추가 또는 제거		✓
네이티브 SDK 버전 업데이트		✓
네이티브 권한 변경 (Info.plist, AndroidManifest)		✓
Capacitor 버전 업데이트		✓
네이티브 code 수정 (Swift, Kotlin, Java)		✓
앱 아이콘 또는 스플래시 화면 변경		✓
첫 앱 스토어 제출		✓

Capgo Build를 사용해야 하는 이유

iOS 빌드 시 Mac이 필요 없음

Mac 하드웨어 없이도 iOS 앱을 빌드하고 배포하세요. Windows, Linux 또는 모든 CI/CD 환경에서 iOS 빌드를 실행하고 TestFlight에 게시할 수 있습니다.

로컬 환경 설정 생략

Xcode나 Android Studio를 설치하거나 SDK 버전을 관리할 필요가 없습니다. Capgo Build가 모든 네이티브 툴링을 처리하므로, 여러분은 CLI 명령만 실행하면 됩니다.

중앙 집중식 인증 정보

인증서와 keystore를 CI/CD secrets에 한 번만 저장하세요. 팀원 누구나 로컬 머신에 서명 인증 정보가 없어도 빌드를 실행할 수 있습니다.

모든 CI/CD와 호환

단 하나의 CLI 명령어로 모든 파이프라인과 통합됩니다. GitHub Actions, GitLab CI, Jenkins - 기존 워크플로우의 일부로 빌드를 트리거하세요.

실시간 빌드 로그

터미널에서 빌드 진행 상황을 실시간으로 확인하세요. 로그는 Server-Sent Events를 통해 스트리밍되어 문제가 발생하면 즉시 디버깅할 수 있습니다.

스토어 직접 제출

서명된 앱은 App Store Connect와 Google Play에 직접 업로드됩니다. 빌드 완료부터 스토어 제출까지 수동 단계가 없습니다.

작동 원리

빌드 명령을 실행하면:

업로드 - CLI는 필요한 것만(네이티브 플랫폼 폴더 + 네이티브 의존성) 압축해 보안 클라우드 스토리지에 업로드합니다
빌드 - 앱은 Fastlane을 사용해 전용 인프라에서 컴파일됩니다. 반복 빌드는 기본적으로 앱별 컴파일 캐시를 복원합니다(공용 일반 캐시를 사용하려면 cache_key 생략); 설정하여 --cache-key RC와 프로덕션을 분리하거나, 전달하여 --no-cache 복원 및 저장을 비활성화하세요
서명 - 인증서와 키스토어가 적용됩니다(빌드 중 메모리에만 존재)
제출 - 서명된 앱은 App Store Connect 또는 Google Play에 직접 업로드됩니다
정리 - 모든 빌드 산출물과 자격 증명이 자동으로 삭제됩니다

소스 code는 로컬 머신에 그대로 유지됩니다. 플랫폼별 네이티브 code만 업로드됩니다.

보안 모델

Capgo Build는 자격 증명 저장을 전혀 하지 않도록 설계되었습니다:

런타임 전용 자격 증명 - 인증서와 키스토어는 Capgo에 저장되지 않습니다. 빌드가 완료되면 즉시 업로드 후 삭제됩니다.
일회성 환경 - 각 빌드는 격리된 환경에서 실행되며 완료 후 폐기됩니다
로그 저장 없음 - 빌드 로그는 터미널로만 스트리밍되며, Capgo 서버에 저장되지 않습니다
최소 업로드 - 요청한 네이티브 플랫폼만 업로드되며, 전체 코드베이스는 업로드되지 않습니다. 업로드되는 내용을 정확히 확인하세요

요금제

빌드 시간이 유일한 비용입니다:

빌드 분은 Capgo 플랜에 포함됩니다
추가 분은 크레딧 시스템으로 이용 가능합니다
빌드는 네이티브 툴체인이 이미 설치된 Mac Mini Silicon M4 머신에서 실행됩니다
스토리지 요금 없음

다음 단계

시작하기 첫 빌드를 생성하고 Capgo Build를 직접 확인해 보세요.

자격 증명 설정 iOS용 인증서와 Android용 키스토어를 설정합니다.

자동 OTA 또는 Native 자동으로 live update vs Capgo Build를 선택하는 CI.

CI UI에서 트리거 GitHub, GitLab, Bitbucket 또는 Azure에서 Native Build를 시작하세요.

Build Webhook 관리자 대시보드에서 HTTP로 Capgo Build를 실행하세요.

Prescan 검사 빌드 전 검사 전체 목록과 특정 규칙을 건너뛰거나 경고로 처리하는 방법.

GitHub 작업 Secrets와 릴리스 워크플로우를 포함한 Capgo Build CI 전체 설정.