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

우리는 __CAPGO_KEEP_0__ 클라우드 빌드를 발표합니다. Capgo 클라우드 빌드 - a new way to build your Capacitor apps for iOS and Android directly in the cloud, without the need for local development environments or CI/CD infrastructure.

해결해야 할 문제

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

로컬 개발 도구: Xcode (30+ GB)를 설치하고 유지 관리하는 것
맥 하드웨어: iOS 빌드는 맥을 필요로 하며, 이는 윈도우/리눅스 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 설정이 필요하지 않습니다. 단일 명령어만 사용하면:

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

How It Works

우리는 Cloud Build를 Capgo로 Expo EAS Build와 동일한 접근 방식을 사용하여 빌드했습니다 - 전용 클라우드 인프라스트럭처가 모든 복잡성을 처리합니다.

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

Our Expertise

지난 3년 동안 우리는 다음과 같은 것을 수행했습니다.

우리는 Fastlane 시스템을 자체적으로 구축했습니다. - 우리는 Capacitor 앱을 위해 특별히 최적화된 커스텀 Fastlane 구성이 있습니다.
Capacitor 빌드를 마스터했습니다. - 우리는 Capacitor 빌드에 중요한 것을 이해하고 있습니다. 플러그인 구성부터 네이티브 종속성까지.
native-only - 우리는 iOS와 Android의 네이티브 부분만 빌드합니다. - 당신의 자바스크립트는 당신의 편에 있습니다. 우리는 당신의 웹 code를 절대 건드리지 않습니다. 절대 저장하지도 않습니다.
infrastructure - 수천 개의 내부 빌드는 우리가 당신에게 제공할 수 있는 빌드 시스템을 완벽하게 만들기 위해 도움이되었습니다.

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

Android

Android 빌드는 완료 후 즉시 정리되는 안전한 Cloudflare sandbox에서 실행됩니다. 당신의 앱은 Gradle을 사용하여 우리가 Capacitor 최적화된 빌드 스크립트를 사용하여 컴파일하고, 서명하고, Play Store에 제출할 준비가됩니다.

iOS

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

Real-Time Logs

다른 솔루션과 달리, 우리는 빌드 로그를 바로 당신의 터미널로 스트리밍합니다. 당신은:

Dependency installation
빌드 컴파일
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에 업로드하지 않습니다. __CAPGO_KEEP_0__에 업로드하지 않습니다. 빌드 요청할 때까지 안전하게 컴퓨터에 저장됩니다.

빌드 과정

빌드 명령어를 실행할 때:

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

보안 보장

__CAPGO_KEEP_0__에서 제공하는 보안 보장에 대해 알아보세요:

✅ 영구적으로 저장되지 않습니다 - Capgo 서버에서 인증 정보가 영구적으로 저장되지 않습니다. 인증 정보는 활성 빌드 중에만 저장됩니다.
✅ 자동 삭제 - 빌드가 완료되면 즉시 삭제됩니다. 빌드가 실패하더라도 24시간 이내에 삭제됩니다.
✅ 로그, 아티팩트 없음 - 빌드 로그나 IPA/APK 파일이 인증 정보 추적을 포함하고 있더라도 __CAPGO_KEEP_0__에서 저장하지 않습니다.
✅ 임시 환경 - 빌드 환경은 사용 후 완전히 삭제됩니다.
✅ 직접 스토어 - 앱은 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 경우:

빌드 인증서 (.p12 파일 및 암호)
배포 프로파일 (.mobileprovision 파일)
선택 사항: App Store Connect API 키 (자동 제출을 위해)

Android 경우:

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

자세한 설정 지침을 참조하세요. 자격 증명 문서 개인 정보 보호 및 보안 우선

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

로그 저장 없음

: 빌드 로그는 실시간으로 터미널을 통해 Server-Sent Events (SSE)로 스트리밍되지만 디스크 또는 데이터베이스에 영구적으로 저장되지 않습니다.아티팩트 저장 없음
: 빌드된 IPA/APK 파일은 App Store/Play Store 서버로 바로 전송되며 __CAPGO_KEEP_0__는 그들을 저장하지 않습니다.: Your built IPA/APK files go directly from our build machines to App Store/Play Store servers - Capgo never stores them
Android: 빌드 샌드박스는 완료 후 즉시 삭제됩니다.:
- Automatic Cleanup
- iOS: 맥 사용자 계정이 빌드 후 정리되며, 24시간 후 기계가 해제됩니다.
격리된 빌드: 각 iOS 빌드는 완전히 별도의 macOS 사용자 계정과 키체인과 함께 실행됩니다.
당신의 Code 개인 정보: 우리는 네이티브 부분만 빌드합니다 - 당신의 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 인증서를 제공합니다. (고급 사용 사례를 위해)

인증서를 환경 변수를 통해 직접 전달할 수도 있습니다. - 자세한 내용은 인증서 문서를 참조하세요. CI 환경에서 Mac 러너를 구성할 필요가 없으며, 빌드 캐시를 관리하거나 SDK를 설치할 필요가 없습니다. __CAPGO_KEEP_0__는 클라우드에서 모든 것을 처리합니다. 간단하고 투명한 가격 정책

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

Android 빌드

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

Option 1: CI에서 인증서를 저장합니다. (간단성을 위해 추천) Option 2: inline 인증서를 제공합니다. (고급 사용 사례를 위해) 인증서를 환경 변수를 통해 직접 전달할 수도 있습니다. - 자세한 내용은 인증서 문서를 참조하세요. CI 환경에서 Mac 러너를 구성할 필요가 없으며, 빌드 캐시를 관리하거나 SDK를 설치할 필요가 없습니다. __CAPGO_KEEP_0__는 클라우드에서 모든 것을 처리합니다. 간단하고 투명한 가격 정책 실제 사용한 빌드 시간에 따라 요금을 청구합니다: Android 빌드 : 1× multiplier
iOS 빌드 : 2× multiplier (dedicated Mac 하드웨어 비용으로 인한)

사용한 만큼만 지불합니다. 최소 계약 조건도 없습니다.

Code은 당신의 책임입니다.

Capgo Cloud Build의 중요한 원칙은 자연스럽게 native 부분만 빌드합니다..

JavaScript, HTML, CSS는 당신의 편입니다. 우리는 웹 code을 처리, 검사, 저장하지 않습니다. npm run build 웹 자산을 빌드할 때는 당신이 책임이 있습니다. ( __CAPGO_KEEP_0__ 또는 당신이 선호하는 빌드 도구를 사용하여)

native 컴파일을 처리합니다.

이 분리는 의도적으로 이루어졌습니다. 보안이 더 좋습니다. - 당신의 애플리케이션 로직은 언제나 당신의 통제 하에 있습니다.
빠른 빌드 - 우리는 웹 code의 재빌드를浪費하지 않습니다.
명확한 책임 - 웹 빌드 프로세스를 제어하고 native 복잡성을 처리하는 데 우리가 집중합니다.

실시간 업데이트에 대해

Cloud Build는 우리의 기존 실시간 업데이트 시스템을 보완합니다.. 그들은 어떻게 함께 작동하는지 보겠습니다:

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

Cloud Build을 사용할 때 새로운 플러그인을 추가하거나 네이티브 구성이 변경될 때 사용하세요. Live 업데이트 사용하여 나머지 모든 경우. 함께, 가장 빠른 가능한 배포 워크플로를 제공합니다.

현재 상태: 공개 베타

Cloud Build은 현재 공개 베타입니다. 우리는 경험을 개선하기 위해 모든 사람에게 공개하기 전에 선택한 그룹의 초기 채택자와 함께 작업하고 있습니다.

시도해 보고 싶으신가요? 우리 Discord에 가입하여 - 우리는 당신을 초기 테스터로 받아들이기를 바랍니다! 시작하기

힘들게 빌드하지 않고 빌드하기 위해 준비되셨나요?

Cloud Build 문서 를 참조하여 다음에 대해 더 자세히 알아보세요: 배포 워크플로

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

다음은 무엇입니까?

우리는 다음과 같은 작업을 진행하고 있습니다.

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

우리는 Capgo Cloud Build를 개발자 친화적인 빌드 방법으로 만들고 있습니다. 피드백이나 기능 요청이 있으시면 Discord 커뮤니티에서 알려주십시오. We’re building __CAPGO_KEEP_0__ Cloud Build to be the simplest, most developer-friendly way to build native mobile apps. If you have feedback or feature requests, we’d love to hear from you in our.

__CAPGO_KEEP_0__

Capgo 클라우드 빌드 소개 - 빌드에 대한 스트레스를 받지 않고 네이티브 앱을 빌드하세요.