Mac이 없는 상태에서 Capacitor 클라우드 iOS 빌드

Capgo 클라우드 빌드 Capacitor 팀이 Mac을 소유하지 않고 iOS 및 Android 앱을 빌드하고 서명할 수 있도록 도와줍니다. 웹 빌드, 테스트 및 npx cap sync __CAPGO_KEEP_0__ 빌드 Capgo 빌드 CLI 단계에서 서명된 바이너리와 옵션 스토어 제출을 위해 Capgo 원시 빌드Capgo Capacitor iOS Mac이 없는 FAQ.

해결하고자 하는 문제

웹 개발자에게 항상 문제가 되던 모바일 앱의 네이티브 빌드는

• Local Development Tools: Xcode (30+ GB)와 Android Studio를 설치하고 유지 관리하는 것
• Mac 접근: iOS 빌드의 전통적인 배송은 개발자 머신과 릴리스 경로에 Mac 접근이 필요했습니다
• CI/CD 설정: Actions 또는 다른 CI/CD 워크플로우를 설정하는 데 복잡한 GitHub이 필요합니다
• 의존성 관리빌드 도구, SDK, 및 인증서를 환경 간에 최신 상태로 유지하세요.

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

클라우드 빌드 소개

Capgo 클라우드 빌드와 함께 앱 빌드를 다음과 같이 간단하게 할 수 있습니다.

# 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 클라우드 빌드는 Expo EAS 빌드와 동일한 접근 방식을 사용하여 개발되었습니다. - 전용 클라우드 인프라스트럭처가 모든 복잡성을 처리합니다.

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

우리의 전문성

지난 3년 동안 우리는:

• context: Capgo Builder / Native Cloud Build 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 메시지 키 `native_build_builder_credit_over` (Native Build Builder Credit Over). - 우리는 Capacitor 앱을 위해 특별히 최적화된 Fastlane 구성이 있습니다.
• 우리는 Capacitor 앱을 위해 특별히 최적화된 커스텀 Fastlane 설정을 만들었습니다. Capacitor 빌드를 마스터했습니다
• 우리는 __CAPGO_KEEP_0__ 빌드에 중요한 요소인 플러그인 설정부터 네이티브 의존성까지에 대한 깊은 지식을 가지고 있습니다. - iOS와 Android의 네이티브 부분만 빌드합니다. 자바스크립트는 당신의 편에 있습니다 - 우리는 웹 code를 절대 건드리지도 않고 저장하지도 않습니다.
• 우리는 iOS와 Android의 네이티브 부분만 빌드합니다. JavaScript는 당신의 편입니다 - 우리는 웹 __CAPGO_KEEP_0__에 손을 대거나 저장하지 않습니다. - 수천 개의 내부 빌드는 우리가 빌드 시스템을 사용할 수 있도록 만들기 전에 완벽하게 개선했습니다.

이것은 새로운 실험이 아니에요. 우리는 이미 수년 동안 사용해온 검증된 인프라스트럭처를 서비스로 제공하고 있어요.

안드로이드

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

iOS

iOS 빌드는 Scaleway Mac mini를 사용하여 on-demand로 프로비전됩니다. 우리는 몇 년 동안 Capacitor 빌드를 통해 개선된 Fastlane 설정을 사용하여 앱을 빌드, 서명, TestFlight에 제출합니다. 각 빌드는 보안을 위해 isolated 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_KEEP_0__에 업로드되지 않습니다. Capgo에 업로드되지 않았습니다. 빌드 중에 무슨 일이 일어나는지

인증 정보를 로컬에 저장하는 방법

빌드 명령을 실행할 때:

1. Local: CLI은 로컬에서 자격 증명을 읽습니다. ~/.capgo/credentials.json
2. Upload: 자격 증명은 HTTPS를 통해 Capgo의 빌드 서버와 함께 프로젝트와 함께 안전하게 전송됩니다.
3. Build빌드
4. CleanupCapgo 서버에서 빌드가 완료되면 자격 증명이 자동으로 삭제됩니다.

: 빌드가 완료되면 자격 증명은 __CAPGO_KEEP_0__ 서버에서 자동으로 삭제됩니다.

보안 보장

• ✅ 자격 증명에 대한 보장을 보장합니다: - 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(자동 제출을위한)

See our 자동 인증서 문서를 참조하십시오 세부 설정 지침을 참조하세요.

개인 정보 및 보안 우선

개인 정보 및 보안에 대한 모든 빌드 시스템을 설계했습니다:

• 로그 저장 없음페이지/영역: Capgo Builder / 네이티브 클라우드 빌드 제품 페이지. 역할: 섹션 또는 페이지 제목. 메시지 키 `native_build_security_feature4_title` (네이티브 빌드 보안 기능 4 제목).
• : 빌드 로그는 실시간으로 서버 SENT 이벤트 (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__는 그들을 저장하지 않습니다:
  • 자동 정리
  • 안드로이드: 빌드 샌드박스가 완료 후 즉시 삭제
• iOS: Mac 사용자 계정이 빌드 후 정리되며 24시간 후에 기계가 해제격리된 빌드
• Code 개인 정보 보호__CAPGO_KEEP_0__는 자바스크립트/HTML/CSS가 서버에 접근하지 않도록 native 부분만 빌드합니다.
• 빌드 기록 없음__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: Inline 인증 정보 제공 (고급 사용 사례에 대해)

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

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

간단한, 투명한 가격제

실제 빌드 시간에 따라 요금을 부과합니다.

• 안드로이드 빌드1배 곱셈자
• iOS 빌드2배의 곱셈 (Mac 전용 하드웨어 비용으로 인한)

비용이 없는 충격, 최소 계약이 없습니다. 사용하는 만큼만 지불합니다.

Code의 책임

Capgo Cloud Build의 중요한 원칙: 자연스러운 부분만 빌드합니다..

code과 의존성 설치는 당신의 책임입니다. 그 후 cap sync, 자바스크립트, HTML, CSS가 컴파일된 네이티브 프로젝트가 업로드되고 사용되며, 임시 프로젝트 데이터는 삭제됩니다. 당신은 로컬에서 웹 자산을 빌드하는 책임이 있습니다 ( npm run build 또는 당신이 선호하는 빌드 도구를 사용하여). 우리는 네이티브 컴파일을 처리합니다.

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

• 보안이 더 좋습니다. - 당신의 애플리케이션 로직은 언제나 당신의 통제하에 있습니다.
• 빠른 빌드 - 우리는 당신의 웹 code을 다시 빌드하는 시간을浪費하지 않습니다.
• 책임 있는 관리 - 웹 빌드 프로세스를 제어하고, 네이티브 복잡성을 처리합니다.

Live Update에 대해 어떻게 생각하나요?

Cloud Build는 우리의 기존 live update 시스템을 보완합니다. 그들은 어떻게 함께 작동하는지 보겠습니다.

• 클라우드 빌드: 네이티브 앱 변경 (플러그인, 권한, 네이티브 code)이 App Store/Play Store 검토를 필요로 할 때
• Live Update웹 code 변경 사항(HTML, CSS, JavaScript)도 즉시 배포할 수 있습니다.

: 웹 __CAPGO_KEEP_0__ 변경 (HTML, CSS, JavaScript)이 검토 없이 즉시 배포될 수 있는 경우

Cloud Build를 사용할 때 새로운 플러그인을 추가하거나 네이티브 구성 변경을 사용하세요. Live Update를 사용하면 다른 모든 경우입니다. 그들은 가장 빠른 배포 워크플로를 제공합니다.

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

시작하기에 도움이 필요하신가요? 우리 Discord에 가입하세요 우리에 대해 알려주세요 - 우리는 당신의 첫 번째 빌드를 실행하는 데 도움을 드리고 싶습니다.

시작하기

힘든 일을 피하고 싶으신가요? Cloud Build 문서를 확인하세요. Cloud Build 문서 더 많은 정보를 얻기 위해 다음 항목에 대해 알아보세요:

• 인증 정보 설정 - iOS 인증서 및 Android 키 스토어
• 시작하기 안내서 - 5분 만에 첫 번째 빌드
• iOS 전용 설정 Certificates, provisioning profiles, 및 App Store Connect
• Android 전용 설정 Keystores 및 Play Store 설정
• CI/CD 통합 자동화 빌드 pipeline에서
• 문제 해결 일반적인 문제 및 해결책

다음 단계

현재 진행 중인 작업

• iOS 빌드 속도 향상: 종속성 캐싱을 통해 빌드 시간을 줄입니다
• 빌드 아티팩트 저장소: 수동 배포를 위한 IPA/APK 파일의 선택적 다운로드
• 사용자 지정 빌드 스크립트Capgo에서 제공하는 기능은 빌드 전/후 스크립트 지원 및 사용자 정의 Fastlane 경로입니다.
• 빌드 로그 기록Optional 로그 저장소 (debugging 및 감사 기록을 위한)

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

조립하세요!

FAQ

How does Capgo Build help Capacitor teams?

After your web build and cap sync, the Capgo CLI uploads the prepared native project, streams compile logs to your terminal, and returns signed iOS and Android binaries or uploads them when you configure App Store Connect and Play credentials.

What is Capgo?

Capgo is a release platform for Capacitor apps. Capgo Build handles signed native binaries and store submission. Capgo Live Updates ship JavaScript and asset changes between native releases.

더 알아보기

• 클라우드 빌드 개요
• 인증 설정 안내서
• 클라우드 빌드 시작하기
• iOS 빌드 구성
• 안드로이드 빌드 구성
• 디스코드에 가입하세요

클라우드 iOS 빌드에 맥을 사용하지 않고 Capacitor 및 CI에서 계속 진행하세요.

Capgo를 사용 중이라면 Mac 없이 iOS 빌드를 위한 Capacitor 및 CI CI/CD 자동화 계획을 세우기 위해 연결하세요. Capgo CI/CD 제품 워크플로우에서 Capgo CI/CD를 사용하세요. Capgo 네이티브 빌드 제품 워크플로우에서 Capgo 네이티브 빌드를 사용하세요. Capgo 통합 제품 워크플로우에서 Capgo 통합을 사용하세요. CI/CD 통합 제품 워크플로우에서 CI/CD 통합을 사용하세요. GitHub 액션 통합 GitHub 액션 통합