본 콘텐츠로 바로 가기
제품

Capgo 클라우드 빌드 소개 - 빌드 네이티브 앱에 대한 스트레스를 줄여보세요

Build your Capacitor apps for iOS and Android in the cloud, just like Expo. No need for local Xcode or Android Studio - submit directly to app stores from your CLI.

기사 기여자

마틴 도나디우

작가

발레리아

리뷰어

조던

개발자

Capgo Cloud Build - Native 앱을 만들기 위한 번거로움 없이

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

해결해야 할 문제

네이티브 모바일 앱을 개발하는 것은 웹 개발자에게 항상 고통의 지점입니다. 다음이 필요합니다.

  • 로컬 개발 도구: Xcode (30+ GB)를 설치하고 유지 관리하는 것
  • 맥 하드웨어: iOS 빌드는 맥을 필요로 하며, 이는 Linux/Windows CI 러너에서 비용이 많이 들거나 불가능할 수 있습니다.
  • CI/CD 구성: GitHub 설정을 위해 복잡한 CI/CD 워크플로우를 구성하거나 다른 빌드 캐싱, 자격 증명 관리, 등과 같은 기능을 사용할 수 있습니다.
  • 의존성 관리: 빌드 도구, 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

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

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

Capgo의 작동 방식

Capgo Cloud Build을 만들 때는 Expo EAS Build과 같은 접근 방식을 사용했습니다. - 전용 클라우드 인프라가 모든 복잡성을 처리합니다.

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

Capgo의 전문성

지난 3년 동안 우리는:

  • 자체 Fastlane 시스템을 구축했습니다 - 우리는 Capacitor 앱을 위해 특별히 최적화된 커스텀 Fastlane 구성이 있습니다
  • Capacitor 빌드를 마스터했습니다 - 우리는 Capacitor 빌드에 중요한 것을 깊이 이해하고 있습니다. 플러그인 구성부터 네이티브 종속성까지
  • __CAPGO_KEEP_0__에만 집중했습니다 - iOS와 Android의 네이티브 부분만 빌드합니다. (JavaScript는) 당신의 쪽에 남겨두고, 우리는 웹 code에 손을 대거나 저장하지 않습니다.
  • 인프라스트럭처를 개선했습니다. - 수천 개의 내부 빌드는 우리가 이 빌드 시스템을 당신에게 제공하기 전에 완벽하게 만들도록 도왔습니다.

이것은 새로운 실험이 아닙니다. 우리는 몇 년 동안 의존해 왔던, 이제 서비스로 제공되는 검증된 인프라스트럭처입니다.

안드로이드

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

iOS

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

실시간 로그

다른 솔루션과 달리, 우리는 빌드 로그를 당신의 터미널로 직접 스트리밍합니다. 당신은 다음과 같은 것을 관찰할 수 있습니다:

  • 의존성 설치
  • 빌드 컴파일
  • Code 인증
  • 애플리케이션 스토어 제출
  • 오류 또는 경고

그리고 여기 중요한 부분입니다: 우리는 로그를 저장하지 않습니다.. 이들은 빌드 중에만 사용할 수 있으며, CLI 세션을 통해 개인정보 보호를 보장합니다.

인증 정보의 작동 방식

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

지역 저장소에 인증 정보 저장

인증 정보는 ~/.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_KEEP_0__에 업로드되지 않습니다. Capgo 요청을 할 때까지 안전하게 머신에 저장됩니다.

빌드 과정

빌드 명령어를 실행할 때:

  1. Local: CLI은 ~/.capgo/credentials.json
  2. Upload: Capgo의 빌드 서버로 HTTPS를 통해 안전하게 인증서를 전송하고 프로젝트와 함께 전송됩니다.
  3. Build: 빌드 프로세스 동안만 인증서가 사용됩니다.
  4. Cleanup: 빌드가 완료되면 Capgo 서버에서 인증서가 자동으로 삭제됩니다.

보안 보장

이것은 우리가 여러분의 자격 증명에 대해 약속하는 것입니다:

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

자격 증명 관리

__CAPGO_KEEP_0__

# 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

  • iOS에서 빌드할 때 필요한 인증서:
  • iOS 빌드 인증서 (.p12 파일 및 암호)
  • Optional: App Store Connect API key (for automated submission)

iOS 빌드에 대한 옵션: App Store Connect __CAPGO_KEEP_0__ 키(자동 제출을 위해)

  • Android
  • Android에서 빌드할 때 필요한 키스토어:
  • Android 키스토어 파일(.jks 또는 .keystore)
  • Android 키스토어 별칭
  • Android 키스토어 키 암호화 키(암호화 키라고도 함.)

See our 인증 정보 문서 세부 설정 지침을 참조하세요.

개인 정보 보호 및 보안 우선

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

  • 로그 저장 없음context: Capgo Builder / native cloud build product page. Role: Section or page heading. Message key `native_build_security_feature4_title` (Native Build Security Feature4 Title).
  • : 빌드 로그는 실시간으로 터미널을 통해 Server-Sent Events (SSE)로 스트리밍되지만 디스크 또는 데이터베이스에 저장되지 않습니다: Your built IPA/APK files go directly from our build machines to App Store/Play Store servers - Capgo never stores them
  • : 빌드된 IPA/APK 파일은 App Store/Play Store 서버로 직접 전송되며 __CAPGO_KEEP_0__는 그들을 저장하지 않습니다:
    • 자동 정리
    • Android: 빌드 샌드박스가 완료 후 즉시 삭제됩니다. iOS: Mac 사용자 계정이 빌드 후 정리되고 24시간 후에 기계가 해제됩니다
  • 분리된 빌드: iOS 빌드가 macOS 사용자 계정에 완전히 분리되어 각자의 키 체인
  • Your Code Privacy: 우리는 네이티브 부분만 빌드합니다 - JavaScript / HTML / CSS는 우리 서버에 접근하지 않습니다
  • 빌드 기록 없음: 우리는 빌드, 버전, 또는 빌드 메타데이터의 데이터베이스를 유지하지 않습니다. 활성 빌드에 필요한 것만 유지합니다

어디서든 사용

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: inline 인증 정보 제공 (고급 사용 사례)

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

No need to configure Mac runners, manage build caches, or install SDKs in your CI environment. Capgo handles all of that in the cloud.

__CAPGO_KEEP_0__

는 클라우드에서 모든 것을 처리합니다.

  • 간단하고 투명한 요금제실제 사용한 빌드 시간에 따라 요금을 청구합니다:
  • iOS 빌드: 2배의 곱셈 계수 (dedicated Mac 하드웨어 비용으로 인해)

사용한 만큼만 지불하므로 예상 수수료가 없으며 최소 계약이 없습니다.

Code

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

JavaScript, HTML 및 CSS는 당신의 편입니다. 우리는 웹 code를 처리, 검사 또는 저장하지 않습니다. 당신은 웹 자산을 로컬에서 빌드하는 책임이 있습니다 ( npm run build 또는 당신이 선호하는 빌드 도구를 사용하여) 그리고 우리는 자연스럽게 컴파일합니다.

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

  • 보안이 더 좋습니다. - 당신의 애플리케이션 로직은 당신의 통제 밖으로 나가지 않습니다.
  • 빠른 빌드 - code을 다시 구축하는 시간을浪費하지 않습니다.
  • 명확한 책임 - 웹 빌드 프로세스를 제어하고 native 복잡성을 처리합니다.

실시간 업데이트에 대해 어떻게 하나요?

Cloud Build는 우리의 기존 실시간 업데이트 시스템을 보완합니다.

  • 다음은 그들이 어떻게 함께 작동하는지 설명합니다.: For native app changes (plugins, permissions, native code) that require App Store/Play Store review
  • : native 앱 변경 (플러그인, 권한, native __CAPGO_KEEP_0__)이 App Store/Play Store 검토를 필요로 할 때: For web code changes (HTML, CSS, JavaScript) that can be deployed instantly without review

context":"페이지/영역: 홈페이지 문제/해결 섹션. 역할: 섹션 또는 페이지 제목. 보이는 곳: 페이지 프리미엄-서포트.astro. 메시지 키 `ps_help_updates_title` (Ps Help Updates Title)."

현재 상태: 완전 출시

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

시작하는 데 도움이 필요하신가요? 우리 Discord에 가입하세요 우리는 당신의 첫 번째 빌드를 실행하는 데 도움이 되고 싶습니다.

시작하기

힘들게 빌드하지 않으려면 준비되셨나요? Cloud Build 문서를 확인하세요 더 많은 정보를 얻기 위해 설정하는 자격 증명

다음 단계

현재 진행 중:

  • iOS 빌드 속도 향상: 빌드 시간을 줄이기 위해 빌드 간 의존성 캐싱
  • 빌드_artifacts_저장소: 수동 배포를 위해 IPA/APK 파일 다운로드
  • 사용자 지정 빌드 스크립트: 빌드 전/후 스크립트 및 사용자 지정 Fastlane 경로 지원
  • 빌드 로그 히스토리: 디버깅 및 감사 기록을 위한 로그 저장

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

빌드하기 좋은 하루!


더 알아보기

Keep going from Introducing Capgo Cloud Build - Build Native Apps Without the Hassle

Capgo의 Capawesome과 함께 시작하는 방법은 무엇입니까? Capgo의 Capawesome과 함께 시작하는 방법은 무엇입니까? Introducing Capgo Cloud Build - Build Native Apps Without the Hassle Capgo Cloud Build를 사용하는 경우 Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds, Capgo 통합 Capgo Capgo Native Builds를 위한 제품 워크플로우에 대해 CI/CD 통합 GitHub Actions Integration for the implementation detail in GitHub Actions Integration.

Capacitor 앱에 대한 즉각적인 업데이트

웹-layer 버그가 활성화되면 Capgo을 통해修정을 배포하는 대신 앱 스토어 승인까지 며칠 기다리지 않도록합니다. 사용자는 배경에서 업데이트를 받으면서 네이티브 변경 사항은 일반적인 검토 경로를 유지합니다.

마틴의 인간 지원

시작하기

최신 블로그 게시물

Capgo은 전문적인 모바일 앱을 만들기 위해 필요한 최고의 통찰력을 제공합니다.