Capgo 클라우드 빌드 소개 - 네이티브 앱 빌드의 어려움을 없애세요

우리는 __CAPGO_KEEP_0__ 클라우드 빌드를 발표합니다. Capgo 클라우드 빌드 - Capacitor 앱을 iOS 및 Android로 직접 클라우드에서 빌드하는 새로운 방법입니다. 로컬 개발 환경이나 CI/CD 인프라가 필요하지 않습니다.

The Problem We’re Solving

웹 개발자라면 모바일 앱을 빌드하는 것이 항상 고통스러운 문제였습니다.

Local Development Tools: 로컬 머신에 Xcode (30+ GB)와 Android Studio를 설치하고 유지해야 합니다.
Mac Hardware: iOS 빌드는 Mac이 필요하며, Linux/Windows CI 러너에서 비용이 많이 들거나 불가능할 수 있습니다.
CI/CD Configuration: 복잡한 GitHub Actions 또는 다른 CI/CD 워크플로우를 설정해야 하며 빌드 캐싱, 자격 증명 관리 및 더 많은 기능이 필요합니다.
Dependency Management: 빌드 도구, SDK 및 인증서를 환경 간에 최신 상태로 유지해야 합니다.

What if you could skip all of that and just run a single command?

Cloud Build 소개

Capgo Cloud Build을 사용하면 앱을 빌드하는 것이 다음과 같이 간단합니다:

# First time: Save your credentials locally
npx @capgo/cli@latest build credentials save --platform ios
npx @capgo/cli@latest build credentials save --platform android

# Then build
npx @capgo/cli@latest build com.example.app

그것이 전부입니다. Xcode, Android Studio, 복잡한 CI/CD 설정이 필요하지 않습니다. 단 하나의 명령어만 필요합니다:

프로젝트를 지역적으로 압축합니다
Capgo의 클라우드 인프라에 업로드합니다
저장된 자격 증명을 사용하여 전용 인프라에서 앱을 빌드합니다
실시간으로 터미널에 로그를 스트리밍합니다
설정된 경우 앱 스토어와 플레이 스토어에 제출합니다

작동 방식

Capgo Cloud Build은 Expo EAS Build와 동일한 접근 방식을 사용하여 개발되었습니다 - 전용 클라우드 인프라가 모든 복잡성을 처리합니다.

그러나 우리가 다른 점은 다음과 같습니다: 우리는 3년 동안 이 작업을 수행했습니다. 우리는 Capgo의 시작부터 고객을 위해 내장 앱을 개발해 왔으며, Capacitor 앱을 신뢰할 수 있게 개발하는 데 필요한 모든 것을 배웠습니다.

Our Expertise

지난 3년 동안 우리는:

Built our own Fastlane system - 우리는 Capacitor 앱을 위해 특별히 최적화된 커스텀 Fastlane 설정을 만들었습니다.
Mastered Capacitor builds - 우리는 Capacitor에 대한 빌드에 중요한 요소인 플러그인 설정부터 네이티브 의존성까지에 대한 깊은 지식을 가지고 있습니다.
Focused on native-only - 우리는 iOS와 Android의 네이티브 부분만 개발합니다. JavaScript는 항상 당신의 편입니다 - 우리는 웹 code에 손을 대거나 저장하지 않습니다.
Refined our infrastructure - 수천 개의 내부 빌드는 우리가 서비스로 제공하기 전에 빌드 시스템을 완벽하게 만들 수 있도록 도왔습니다.

이것은 실험의 새로운 시도가 아닙니다. 그것은 몇 년 동안 우리가 믿고 의지한 배틀 테스트된 인프라스트럭처입니다.

For Android

안드로이드 빌드는 보안 Cloudflare sandbox에서 즉시 완료 후 청소됩니다. 앱은 Gradle을 사용하여 Capacitor 최적화된 빌드 스크립트로 컴파일되고, 서명되고, Play 스토어에 제출할 준비가 됩니다.

For iOS

iOS 빌드는 Scaleway Mac mini를 사용하여 on-demand로 프로비전된 전용 Mac 머신에서 실행됩니다. 우리는 여러 해 동안 Capacitor 빌드를 통해 개선된 커스텀 Fastlane 설정을 사용하여 앱을 빌드, 서명, TestFlight에 제출합니다. 각 빌드는 보안을 위해 격리된 macOS 사용자 계정에서 실행되고, 머신은 자동으로 24시간 후에 청소됩니다.

Real-Time Logs

다른 솔루션과 달리, 우리는 빌드 로그를 직접 터미널로 스트리밍합니다.

Dependency installation
Build compilation
Code signing
App store submission
Any errors or warnings

그리고 여기서 중요한 점은: 로그를 저장하지 않습니다.그들은 빌드 동안만 CLI 세션을 통해 사용할 수 있으며, 개인 정보를 보호하기 위해.

인증 정보는 어떻게 작동하는가

빌드를 하기 전에, 인증 정보를 제공해야 합니다. Capgo는 보안을 최우선으로 생각하여 처리합니다.

인증 정보를 로컬로 저장

인증 정보는 __CAPGO_KEEP_0__에서 로컬로 저장됩니다. ~/.capgo/credentials.json:

# For iOS - provide certificates and provisioning profiles
npx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./path/to/cert.p12 \
  --p12-password "your-password" \
  --provisioning-profile ./path/to/profile.mobileprovision

# For Android - provide keystore and passwords
npx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password"

이 인증 정보는 Capgo에 업로드되지 않습니다. 빌드를 요청할 때까지, 안전하게 머신에 저장됩니다.

빌드 중에 무슨 일이 일어나는가

빌드 명령어를 실행할 때:

로컬: CLI는 인증 정보를 읽습니다. ~/.capgo/credentials.json
업로드: 인증 정보는 HTTPS를 통해 Capgo의 빌드 서버와 함께 프로젝트와 함께 안전하게 전송됩니다.
빌드: 인증 정보는 빌드 프로세스가 활성화된 동안만 사용됩니다.
정리: 빌드가 완료된 후 Capgo 서버에서 인증 정보가 자동으로 삭제됩니다.

보안 보장

다음과 같은 보장을 제공합니다.

✅ 영구적으로 저장되지 않음 - 빌드가 활성화된 동안 Capgo 서버에만 인증 정보가 존재합니다.
✅ 자동 삭제 - 삭제 후 빌드 완료 (빌드 실패 시 최대 24시간)
✅ 로그, 아티팩트 없음 - 빌드 로그나 IPA/APK 파일을 포함한 자격 증명 추적을 저장하지 않습니다.
✅ 임시 환경 - 사용 후 빌드 환경이 완전히 삭제됩니다.
✅ 직접 스토어 - 앱은 App Store/Play Store로 직접 전달되며 Capgo는 그들을 보관하지 않습니다.

인증 정보 관리

저장된 인증 정보에 대한 완전한 제어권을 가지고 있습니다.

# List saved credentials (passwords masked)
npx @capgo/cli@latest build credentials list

# Clear credentials for a specific platform
npx @capgo/cli@latest build credentials clear --platform ios

# Clear all credentials
npx @capgo/cli@latest build credentials clear

필요한 인증 정보는 무엇입니까?

iOS의 경우:

빌드 인증서 (.p12 파일 및 암호)
설정 프로파일( .mobileprovision 파일)
선택적: 애플 스토어 연결 API 키(자동 제출을위한)

안드로이드:

Keystore 파일( .jks 또는 .keystore)
Keystore 별칭
Keystore 키 비밀번호
Keystore 저장소 비밀번호
선택적: Google Play 서비스 계정 JSON(자동 제출을위한)

자세한 설정 지침을위한 我们的 개인 정보 및 보안 우선

첫 번째

개인 정보 보호와 보안을 위해 전체 빌드 시스템을 설계했습니다:

로그 저장 없음: 빌드 로그는 서버 SENT 이벤트 (SSE)를 통해 실시간으로 터미널에 스트리밍되지만 디스크나 데이터베이스에 영구적으로 저장되지 않습니다
아티팩트 저장 없음: 빌드된 IPA/APK 파일은 앱 스토어/플레이 스토어 서버로 직접 이동되며 Capgo는 그들을 저장하지 않습니다
자동 정리:
- Android: 빌드 샌드박스는 완료 후 즉시 삭제됩니다
- iOS: 빌드 후 24시간 후에 Mac 사용자 계정이 정리되고 기계가 해제됩니다
분리된 빌드: 각 iOS 빌드는 완전히 별도의 macOS 사용자 계정에서 실행되며 자신의 키 체인도 있습니다
Code의 개인 정보 보호: 우리는 네이티브 부분만 빌드합니다 - JavaScript/HTML/CSS는 우리 서버에 접근하지 않습니다
빌드 기록 없음: __CAPGO_KEEP_0__에서 수행하는 모든 빌드, 버전, 또는 빌드 메타데이터를 유지하지 않습니다.

어디서든 사용하세요

Cloud Build는 GitHub Actions, GitLab CI, 또는 CI/CD 플랫폼 어디서든 작동합니다.

로컬 개발

로컬 머신에서 한번만 인증 정보를 저장하고, 언제든지 빌드할 수 있습니다:

# One-time credential setup
npx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./certs/dist.p12 \
  --p12-password "$P12_PASSWORD" \
  --provisioning-profile ./certs/profile.mobileprovision

# Build anytime
npx @capgo/cli@latest build com.example.app --platform ios

CI/CD 통합

CI 환경에서 다음 중 하나를 선택할 수 있습니다:

Option 1: CI에서 인증 정보 저장 (간단함을 위해 추천)

# GitHub Actions example
- name: Save credentials and build
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
    P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
  run: |
    # Decode base64-encoded credentials from secrets
    echo "${{ secrets.IOS_CERTIFICATE_BASE64 }}" | base64 -d > cert.p12
    echo "${{ secrets.PROVISIONING_PROFILE_BASE64 }}" | base64 -d > profile.mobileprovision

    # Save credentials
    npx @capgo/cli@latest build credentials save --platform ios \
      --certificate ./cert.p12 \
      --p12-password "$P12_PASSWORD" \
      --provisioning-profile ./profile.mobileprovision

    # Build
    npx @capgo/cli@latest build com.example.app --platform ios

Option 2: 인라인으로 인증 정보 제공 (고급 사용 사례를 위해)

직접 환경 변수를 통해 자격 증명을 전달할 수도 있습니다. - 자세한 내용은 자격 증명 문서 에서 확인하십시오.

CI 환경에서 Mac 실행기를 구성할 필요가 없습니다. Capgo가 클라우드에서 모든 것을 처리합니다.

간단하고 투명한 요금제

실제 사용한 빌드 시간에 따라 요금을 청구합니다.

안드로이드 빌드: 1배율
iOS 빌드: 2배율 (dedicated Mac 하드웨어 비용으로 인해)

놀랍게도 요금이 없으며 최소 계약이 없습니다. 사용한 만큼만 요금을 지불합니다.

Code, 당신의 책임입니다.

Cloud Build의 중요한 원칙 중 하나는 Capgo: 우리는 네이티브 부분만 빌드합니다..

JavaScript, HTML, 및 CSS는 당신의 편입니다. 우리는 웹 code를 처리, 검사, 또는 저장하지 않습니다. 당신은 웹 자산을 로컬에서 빌드하거나(사용하는 npm run build 또는 당신이 선호하는 빌드 도구), 우리는 네이티브 컴파일을 처리합니다.

이 분리는 의도적으로 이루어졌습니다.:

더 나은 보안 - 당신의 애플리케이션 로직은 당신의 통제 밖으로 나가지 않습니다.
빠른 빌드 - 우리는 웹 code를 다시 빌드하는 시간을浪費하지 않습니다.
rõ한 책임 - 당신은 웹 빌드 프로세스를 통제하고; 우리는 네이티브 복잡성을 처리합니다.

Live Updates에 대해 무엇인가요?

Cloud Build는 우리의 기존 실시간 업데이트 시스템과 함께 작동하는 방법은 다음과 같습니다:

Cloud Build: 네이티브 앱 변경 (플러그인, 권한, 네이티브 code)이 App Store/Play Store 검토를 필요로 할 때
Live Updates: 웹 code 변경 (HTML, CSS, JavaScript) 이 즉시 배포할 수 있는 검토 없이

Cloud Build를 사용할 때는 새로운 플러그인을 추가하거나 네이티브 구성 변경을 하세요. Live Updates를 사용하세요.

이 두 가지를 사용하면 가장 빠른 배포 워크플로를 제공합니다.

Cloud Build has been fully released since January 2026 and is available to all Capgo users. We’re continuing to improve the experience based on production feedback.

Cloud Build는 2026년 1월에 완전 출시되었으며 모든 __CAPGO_KEEP_0__ 사용자에게 사용 가능합니다. 우리는 생산 환경에서 받은 feedback를 기반으로 경험을 개선하고 있습니다. 시작하는 데 도움이 필요하세요? 우리가 도와드릴 수 있도록 알려주세요 - 우리는 당신의 첫 번째 빌드를 실행하는 것을 도와드릴 것입니다.

Getting Started

힘들게 빌드하지 않으려면 준비되셨나요? Cloud Build 문서를 확인하세요. 더 알아보기 위해:

인증 설정 - iOS 인증서 및 Android 키 스토어
시작하는 방법 - 5분 이내에 첫 번째 빌드
iOS 전용 설정 - 인증서, 배포 프로파일, App Store Connect
Android 전용 설정 - 키스토어 및 플레이 스토어 설정
CI/CD 통합 - pipeline에서 빌드를 자동화
문제 해결 - 일반적인 문제와 해결책

다음 단계

현재 작업 중:

iOS 빌드 속도 향상: 빌드 시간을 줄이기 위해 의존성 캐싱
빌드 아티팩트 저장소: 수동 배포를 위해 IPA/APK 파일 다운로드
사용자 정의 빌드 스크립트: __CAPGO_KEEP_0__에 대한 지원을 위한 전/후 빌드 훅 및 커스텀 Fastlane 레인
빌드 로그 히스토리: 디버깅 및 감사 기록을 위한 옵션 로그 저장

우리는 Capgo Cloud Build를 개발자 친화적인 빌드 모바일 앱의 가장 단순한 방법으로 만들고자 합니다. 피드백이나 기능 요청이 있으시면 우리의 Discord 커뮤니티에서 알려주십시오. 빌드에 즐거움!.

더 알아보기

Cloud Build 개요

Capgo Cloud Build을 소개하며 Native 앱을 만들기 위한 Cloud Build - 불편함 없이 Native 앱을 만들기

__CAPGO_KEEP_0__를 사용 중이라면 Capgo Cloud Build을 소개하며 Native 앱을 만들기 위한 Cloud Build - 불편함 없이 Native 앱을 만들기 CI/CD 자동화 계획을 세우기 위해 연결할 수 있는 대상입니다. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우 Capgo Native Builds Capgo Native Builds에서 제품 워크플로우 Capgo Integrations Capgo Integrations에서 제품 워크플로우 CI/CD 통합 CI/CD 통합 구현 세부 정보에 대해, GitHub 액션 통합 CI/CD 통합 구현 세부 정보에 대해 GitHub 액션 통합

Capgo 클라우드 빌드 소개 - 번거로움 없이 네이티브 앱 빌드