본문 바로가기
제품

Mac 없이 Capacitor 및 CI를 위한 클라우드 iOS Build

Mac 없이도 어떤 CI에서든 iOS 및 Android Capacitor 앱을 빌드하고 서명하세요. cap sync 후 CLI 단계 하나면 되고, App Store 및 Play Store 제출은 선택 사항입니다.

아티클 크레딧

마르탱 도나디외

작성자

Valeria

검토자

Jordan

편집자
Mac 없이 클라우드에서 iOS를 빌드하는 Capacitor 및 CI Capgo 블로그 일러스트

Capgo Cloud Build Capacitor 팀이 Mac 없이도 iOS 및 Android 앱을 빌드하고 서명할 수 있도록 지원합니다. 기존 웹 빌드, 테스트 및 npx cap sync 기존 파이프라인에 그대로 두고, 그다음 호출하세요 Capgo 빌드 서명된 바이너리와 선택적 스토어 제출을 CLI 단계 하나로. 제품 개요와 가격은 다음에서 확인하세요 Capgo Native Build. 작업별 답변은 다음에 있습니다 Capacitor Mac 없이 iOS FAQ.

우리가 해결하는 문제

네이티브 모바일 앱 빌드는 웹 개발자에게 늘 골칫거리였습니다. 필요한 것은:

  • 로컬 개발 도구: 내 머신에 Xcode(30GB 이상)와 Android Studio를 설치하고 유지 관리
  • Mac 접근 권한: 기존에는 iOS 빌드를 배포하려면 모든 개발자 머신과 릴리스 경로에 Mac이 필요했습니다
  • CI/CD 설정: 빌드 캐싱, 자격 증명 관리 등을 포함한 복잡한 GitHub Actions 또는 기타 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. App Store 및 Play Store에 제출합니다(설정된 경우)

작동 원리

Expo EAS Build와 동일한 방식으로 Capgo Cloud Build를 만들었습니다. 모든 복잡한 과정을 대신 처리해 주는 전용 클라우드 인프라입니다.

하지만 저희만의 차별점은 다음과 같습니다: 저희는 3년째 이 일을 해오고 있습니다.Capgo 초기부터 고객사의 네이티브 앱을 내부적으로 빌드해 왔고, Capacitor 앱을 안정적으로 빌드하는 데 무엇이 필요한지 정확히 알고 있습니다.

전문성

지난 3년 동안 저희가 해온 일:

  • 자체 Fastlane 시스템 구축 - Capacitor 앱에 특화된 커스텀 Fastlane 설정을 직접 만들었습니다.
  • Capacitor 빌드 완벽 숙지 - 플러그인 설정부터 네이티브 의존성까지, Capacitor 빌드에서 중요한 요소를 깊이 이해하고 있습니다.
  • 네이티브에만 집중 - 저희는 네이티브 파트(iOS 및 Android)만 빌드합니다. JavaScript는 고객 쪽에 그대로 남으며, 저희는 웹 code를 절대 건드리거나 저장하지 않습니다.
  • 인프라 고도화 - 수천 건의 내부 빌드를 통해 빌드 시스템을 완벽하게 다듬은 후 여러분께 공개했습니다

새로운 실험이 아닙니다. 수년간 의존해 온 검증된 인프라를 이제 서비스로 제공합니다.

Android의 경우

Android 빌드는 완료 후 즉시 정리되는 안전한 Cloudflare 샌드박스에서 실행됩니다. 앱은 Capacitor 최적화 빌드 스크립트를 사용해 Gradle로 컴파일되고 서명되며, Play Store 제출 준비가 완료됩니다.

iOS의 경우

iOS 빌드는 온디맨드로 프로비저닝되는 전용 Mac 머신(Scaleway Mac mini)에서 실행됩니다. 수년간의 Capacitor 빌드를 통해 다듬은 커스텀 Fastlane 설정을 사용해 앱을 빌드, 서명, TestFlight에 제출합니다. 각 빌드는 보안 위해 격리된 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에 업로드되지 않습니다 빌드를 요청할 때까지 기기에 안전하게 유지됩니다.

빌드 중 발생하는 일

빌드 명령을 실행하면:

  1. 로컬: CLI이(가) 자격 증명을 읽습니다 ~/.capgo/credentials.json
  2. 업로드: 자격 증명이 프로젝트와 함께 HTTPS를 통해 Capgo 빌드 서버로 안전하게 전송됩니다
  3. 빌드: 자격 증명은 활성 빌드 프로세스 중에만 사용됩니다
  4. 정리: 빌드가 완료되면 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 파일)
  • 선택 사항: App Store Connect API 키 (자동 제출용)

Android의 경우:

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

전체 체크리스트는 자격 증명 문서 상세 설정 안내를 확인하세요.

프라이버시 & 보안 최우선

자격 증명 외에도, 전체 빌드 시스템을 프라이버시와 보안을 최우선으로 설계했습니다:

  • 로그 저장 없음: 빌드 로그는 Server-Sent Events(SSE)를 통해 터미널에 실시간으로 스트리밍되지만, 디스크나 데이터베이스에 영구 저장되지 않습니다
  • 아티팩트 저장 없음: 빌드된 IPA/APK 파일은 저희 빌드 머신에서 App Store/Play Store 서버로 바로 전송되며, Capgo에는 절대 저장되지 않습니다
  • 자동 정리:
    • Android: 빌드 완료 즉시 샌드박스 삭제
    • iOS: 빌드 후 Mac 사용자 계정 정리, 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 환경에서는 다음 중 하나를 선택할 수 있습니다:

옵션 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

옵션 2: 자격 증명을 인라인으로 제공 (고급 사용 사례용)

환경 변수에 자격 증명을 직접 전달할 수도 있습니다. 다음을 참조하세요: 자격 증명 문서 에서 확인하세요.

CI 환경에서 Mac runner를 설정하거나, 빌드 캐시를 관리하거나, SDK를 설치할 필요가 없습니다. Capgo가 클라우드에서 이 모든 것을 처리합니다.

간단하고 투명한 요금제

실제 사용된 빌드 시간을 기준으로 요금을 청구합니다:

  • Android 빌드: 1× 배수
  • iOS 빌드: 2배 (전용 Mac 하드웨어 비용 반영)

예상치 못한 추가 비용이나 최소 약정은 없습니다. 사용한 만큼만 지불하세요.

여러분의 Code, 여러분의 책임

Capgo Cloud Build의 중요한 원칙: 저희는 네이티브 파트만 빌드합니다.

웹 소스 code 및 의존성 설치는 사용자 측에 남습니다. 이후 cap sync, 네이티브 프로젝트 내 컴파일된 JavaScript, HTML, CSS가 업로드되어 빌드에 사용되며, 임시 프로젝트 데이터는 정리됩니다. 웹 에셋은 로컬에서 직접 빌드해야 하며 ( npm run build 또는 선호하는 빌드 도구 사용), 저희는 네이티브 컴파일을 담당합니다.

이러한 분리는 의도된 설계입니다:

  • 더 나은 보안 - 애플리케이션 로직이 사용자의 통제 범위를 벗어나지 않습니다
  • 더 빠른 빌드 - 웹 code을 다시 빌드하는 데 시간을 낭비하지 않습니다.
  • 명확한 역할 분담 - 웹 빌드 프로세스는 직접 제어하고, 네이티브의 복잡함은 저희가 처리합니다.

Live Updates는 어떤가요?

Cloud Build는 기존의 live update 시스템을보완합니다. 두 기능이 함께 작동하는 방식은 다음과 같습니다:

  • Cloud Build: App Store/Play Store 심사가 필요한 네이티브 앱 변경 사항(플러그인, 권한, 네이티브 code)에 사용합니다.
  • Live Update: 심사 없이 즉시 배포할 수 있는 웹 code 변경 사항(HTML, CSS, JavaScript)에 사용합니다.

새 플러그인을 추가하거나 네이티브 설정을 변경할 때는 Cloud Build를 사용하세요. 그 외의 모든 작업에는 Live Updates를 사용하면 됩니다. 이 둘을 함께 쓰면 가장 빠른 배포 워크플로우를 얻을 수 있습니다.

현재 상태: 정식 출시

Cloud Build는 2026년 1월부터 정식 출시되었으며 모든 Capgo 사용자가 이용할 수 있습니다. 프로덕션 피드백을 바탕으로 사용 경험을 계속 개선하고 있습니다.

시작하는 데 도움이 필요하신가요? Discord에 참여하세요 그리고 알려주세요. 첫 빌드를 실행할 수 있도록 기꺼이 도와드리겠습니다.

시작하기

번거로움 없는 빌드를 시작할 준비가 되셨나요? 아래의 Cloud Build 문서 에서 자세히 알아보세요:

다음 단계는?

다음 작업에 집중하고 있습니다:

  • 더 빠른 iOS 빌드: 빌드 간 의존성 캐싱으로 빌드 시간 단축
  • 빌드 아티팩트 저장소: 수동 배포를 위한 IPA/APK 파일 선택적 다운로드
  • 커스텀 빌드 스크립트: pre/post-build 훅 및 커스텀 Fastlane lane 지원
  • 빌드 로그 히스토리: 디버깅 및 감사 추적을 위한 선택적 로그 저장

저희는 Capgo Cloud Build를 네이티브 모바일 앱을 빌드하는 가장 쉽고 개발자 친화적인 방법으로 만들고 있습니다. 피드백이나 기능 제안이 있다면 다음 채널을 통해 알려주세요. Discord 커뮤니티에.

즐겁게 빌드하세요!

자주 묻는 질문

Capgo Build가 Capacitor 팀에 어떤 도움을 줄까요?

웹 빌드와 cap sync 이후, Capgo CLI은 준비된 네이티브 프로젝트를 업로드하고, 컴파일 로그를 터미널로 스트리밍하며, 서명된 iOS 및 Android 바이너리를 반환하거나 App Store Connect와 Play 자격 증명을 설정한 경우 업로드합니다.

Capgo란 무엇인가요?

Capgo은 Capacitor 앱을 위한 릴리스 플랫폼입니다. Capgo Build는 서명된 네이티브 바이너리와 스토어 제출을 처리합니다. Capgo Live Updates는 네이티브 릴리스 사이에 JavaScript 및 에셋 변경 사항을 배포합니다.

더 알아보기

Mac 없이 Cloud iOS 빌드로 Capacitor 및 CI 계속 진행하기

사용 중이라면 Mac 없이 Capacitor 및 CI를 위한 클라우드 iOS Build CI/CD 자동화를 계획하려면, 다음을 연결하세요 Capgo CI/CD 설정하기 Capgo CI/CD의 제품 워크플로우용, Capgo Native Build Capgo Native Builds의 제품 워크플로우용, Capgo 연동 서비스 Capgo Integrations의 제품 워크플로우용, CI/CD 통합 CI/CD Integration의 구현 세부 사항은, 그리고 GitHub Actions 연동 GitHub Actions Integration의 구현 세부 사항을 참고하세요.

Capacitor 앱용 Live updates

웹 레이어 버그가 라이브 상태라면, 앱 스토어 승인을 며칠씩 기다리지 말고 Capgo를 통해 수정 사항을 배포하세요. 네이티브 변경 사항은 정상 리뷰 절차를 그대로 따르는 반면, 사용자는 백그라운드에서 업데이트를 받습니다.

블로그 최신 글

Capgo는 정말 프로페셔널한 모바일 앱을 만드는 데 필요한 최고의 인사이트를 제공합니다.

채택 지표 사례: 앱 업데이트를 추적하는 10가지 방법
모바일 업데이트 +1
2026년 10월 15일

채택 지표 사례: 앱 업데이트를 추적하는 10가지 방법

앱을 실제로 발전시키는 피드백 수집 방법
모바일 튜토리얼 +1
2026년 9월 13일

앱을 실제로 발전시키는 피드백 수집 방법

소프트웨어 및 모바일 개발 팀을 위한 운영 효율성
모바일 제품
2026년 7월 20일

소프트웨어 및 모바일 개발 팀을 위한 운영 효율성

블로그 전체 보기