클라우드 빌드 Capgo을 소개합니다 - 네이티브 앱을 편리하게 빌드하세요

우리는 __CAPGO_KEEP_0__ Cloud Build를 소개합니다. Capgo Cloud Build Capacitor Cloud Build는 네이티브 앱을 iOS와 Android용으로 클라우드에서 빌드할 수 있는 새로운 방법입니다. 로컬 개발 환경이나 CI/CD 인프라가 필요하지 않습니다.

해결하고자 하는 문제

웹 개발자라면 모바일 앱을 개발하는 게 항상 고통스러웠습니다.

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, 인증서를 환경에 따라 최신 상태로 유지해야 합니다.

그 모든 것을 생략하고 단일 명령어만 실행할 수 있다면?

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

That’s it. No Xcode, no Android Studio, no complex CI/CD setup. Just one command that:

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

How It Works

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

하지만 우리가 다른 점은: 우리는 3년 동안 이 일을 해 왔습니다.. Capgo의 시작부터 우리의 고객에게 내장된 네이티브 앱을 빌드해 왔으며, Capacitor 앱을 신뢰할 수 있게 빌드하는 데 필요한 정확한 것을 배웠습니다.

우리의 전문 지식

지난 3년 동안 우리는:

Fastlane 시스템을 자체 구축했습니다 - Capacitor 앱을 위한 최적화된 Fastlane 구성이 생성되었습니다
Capacitor 빌드를 마스터했습니다 - Capacitor 빌드에 대한 지식이 깊습니다. 플러그인 구성부터 네이티브 의존성까지
네이티브만 집중했습니다 - iOS와 Android의 네이티브 부분만 빌드합니다. 자바스크립트는 당신의 편입니다. 우리는 웹 code에 손을 대지 않습니다
인프라스트럭처를 개선했습니다 - 수천 개의 내부 빌드는 우리가 서비스로 제공하기 전에 빌드 시스템을 완벽하게 만들었습니다

이것은 실험이 아닙니다. 몇 년 동안 의존해 왔던 검증된 인프라스트럭처입니다.

Android

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

iOS 빌드

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

실시간 로그

다른 솔루션과 달리, 우리는 로그 빌드가 발생하는 즉시 터미널로 스트리밍합니다. 당신은 다음과 같은 것을 관찰할 수 있습니다:

의존성 설치
빌드 컴파일
Code 서명
앱 스토어 제출
오류 또는 경고

그것은 중요한 부분입니다: 우리는 로그를 저장하지 않습니다.그것들은 빌드 중에만 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
업로드: Capgo의 빌드 서버로 HTTPS를 통해 안전하게 인증 정보가 전송됩니다.
빌드: 빌드 프로세스가 활성화된 동안만 인증 정보가 사용됩니다.
정리: 빌드가 완료된 후 Capgo 서버에서 인증 정보가 자동으로 삭제됩니다.

보안 보장

인증 정보에 대한 보장:

✅ 영구적으로 저장되지 않음 - 빌드 프로세스가 활성화된 동안 Capgo 서버에만 인증 정보가 존재합니다.
✅ 자동 삭제 - 빌드가 완료된 즉시 삭제 (빌드 실패 시 최대 24시간)
✅ 로그, 아티팩트 없음 - __CAPGO_KEEP_0__에서 인증 정보 추적을 포함한 빌드 로그나 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 파일)
선택 사항: App Store Connect API 키 (자동 제출을 위한)

안드로이드용:

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

자세한 설정 지침을 보려면 인증 정보 문서 개인 정보 보호 및 보안 우선

인증 정보 외에도, 우리는 개인 정보 보호 및 보안을 고려하여 전체 빌드 시스템을 설계했습니다:

로그 저장이 없음

Privacy & Security First: __CAPGO_KEEP_0__ 로그는 실시간으로 터미널에 스트리밍되며 디스크나 데이터베이스에 저장되지 않습니다.
No Artifact Storage: 빌드된 IPA/APK 파일은 Capgo의 저장소에 저장되지 않고 App Store/Play Store 서버로 직접 전송됩니다.
Automatic Cleanup:
- Android: 빌드 샌드박스가 완료 후 즉시 삭제됩니다.
- iOS: Mac 사용자 계정이 빌드 후 24시간 후에 삭제됩니다.
Isolated Builds: 각 iOS 빌드는 완전히 별도의 macOS 사용자 계정과 키체인과 함께 실행됩니다.
Code의 개인 정보 보호: 우리는 네이티브 부분만 빌드합니다 - __CAPGO_KEEP_0__의 서버에 접근하지 않습니다.
No Build History: __CAPGO_KEEP_0__은 빌드, 버전, 또는 빌드 메타데이터의 데이터베이스를 유지하지 않습니다.

어디서든 사용하세요

GitHub Actions, 로컬 머신, GitLab CI, 또는 CI/CD 플랫폼 중 어디든 Cloud Build가 작동합니다.

로컬 개발

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

# 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 환경에서, 다음 중 하나를 선택할 수 있습니다.

1. CI에서 인증 정보를 저장하세요 (간단함을 위해 추천) 2. 인증 정보를 인라인으로 제공하세요 (고급 사용 사례)

# 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

인증 정보를 환경 변수로 직접 전달할 수도 있습니다 - 인증 정보 문서를 참조하세요 CI/CD 환경에서, 로컬 머신, __CAPGO_KEEP_0__ Actions, GitLab CI, 또는 CI/CD 플랫폼 중 어디든 Cloud Build가 작동합니다.

로컬 머신에서 한번만 인증 정보를 저장하고, 언제든지 빌드할 수 있습니다. CI/CD 통합 세부 정보를 참조하십시오.

Mac 실행자에 대한 구성, 빌드 캐시 관리, CI 환경에서 SDK 설치와 같은 작업이 필요하지 않습니다. Capgo는 클라우드에서 모든 것을 처리합니다.

간단하고 투명한 가격 정책

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

Android 빌드: 1배 곱수
iOS 빌드: 2배 곱수(dedicated Mac 하드웨어 비용으로 인해)

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

Code,Code의 책임

Capgo 클라우드 빌드의 중요한 원칙: 자연스럽게 native 부분만 빌드합니다..

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

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

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

Live 업데이트에 대해 무엇입니까?

Cloud Build는 우리의 존재하는 live 업데이트 시스템을 보완합니다. 이들은 어떻게 함께 작동하는지 알아보세요:

Cloud Build": native 앱 변경사항 (플러그인, 권한, native code)에 대한 App Store/Play Store 검토가 필요합니다.
Live Updates": 웹 code 변경사항 (HTML, CSS, JavaScript)으로 즉시 배포할 수 있습니다. 검토 없이.

Cloud Build를 사용할 때 새로운 플러그인을 추가하거나 native 설정을 변경할 때 사용하세요. Live Updates를 사용하면 나머지 모든 경우에 사용하세요. 그들은 가장 빠른 배포 워크플로를 제공합니다.

현재 상태: 완전 출시

Cloud Build는 2026년 1월부터 완전 출시되었으며 모든 Capgo 사용자에게 사용 가능합니다. 우리는 생산 환경에서 받은 feedback를 바탕으로 경험을 개선하고 있습니다.

도움이 필요하세요. Discord에 가입하세요 우리는 당신이 첫 번째 빌드를 실행하는 것을 도와드릴 수 있도록 도와주세요 - 알려주세요.

Getting Started

빌드의 어려움 없이 시작하세요. Cloud Build 문서를 참조하세요. 더 알아보기:

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

다음 단계

현재 진행 중인 작업

iOS 빌드 속도 향상: 빌드 시간을 줄이기 위해 의존성 캐싱
빌드_artifacts_저장소: 수동 배포를 위해 IPA/APK 파일 다운로드
사용자 지정 빌드 스크립트: 전/후 빌드 훅 및 사용자 지정 Fastlane 경로 지원
빌드 로그 히스토리: Optional log storage for debugging and audit trails

우리는 Capgo Cloud Build를 개발자 친화적인 방법으로 네이티브 모바일 앱을 빌드하는 가장 간단한 방법으로 만들고자 합니다. 의견이나 기능 요청이 있으시면 Discord 커뮤니티에서 알려주십시오. Discord 커뮤니티에 가입하세요.

빌드하기 좋은 하루되세요!

더 알아보기

시작하기 - Capgo Cloud Build 소개 - 빌드가 어려운 일을 하지 마세요

만약에 사용 중이라면 Introducing Capgo Cloud Build - Build Native Apps Without the Hassle CI/CD 자동화 계획을 세우기 위해 연결하세요. Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds, Capgo Integrations for the product workflow in Capgo Integrations, CI/CD 통합 CI/CD 통합 구현 세부 사항 GitHub Actions Integration 구현 세부 정보에 대한 GitHub 액션 통합에 대해.

Capgo Cloud Build 소개 - 번거로움 없이 네이티브 앱 빌드