메인 콘텐츠로 바로 가기

윈도우와 리눅스 개발자들을 위한

맥을 소유하지 않고 iOS 앱을 빌드하세요

Capgo 빌드는 cloud Mac 머신에서 Capacitor iOS 앱을 컴파일하고 서명합니다. 윈도우, 리눅스, 또는 CI에서 CLI 명령어를 실행하면 서명된 빌드가 App Store Connect로 업로드되어 TestFlight에 배포됩니다.

인간 지원으로부터 마틴

2–3분
일반적인 네이티브 빌드
iOS + Android
CLI에서
테스트 플라이트
애플 스토어 커넥트로 직접 업로드
Capgo 빌드
npx @capgo/cli@latest build init --platform ios
npx @capgo/cli@latest build request --platform ios
# signed build runs on an ephemeral Mac runner
# logs stream back to your terminal

클라우드 맥 머신

iOS 빌드는 전용 맥 미니 M4 머신에서 실행됩니다. 이미 사용하는 컴퓨터에서 시작합니다.

인증된 업로드

빌드는 인증서로 서명되고 애플 스토어 커넥트로 업로드됩니다. 테스트 플라이트에 준비되어 있습니다.

문제

Xcode는 macOS에서만 작동합니다.

맥이 없으면 iOS 빌드가 불가능합니다.

애플의 빌드 도구는 macOS가 필요합니다. 윈도우나 리눅스에서 개발자도 macOS가 없는 상태에서 iOS 빌드를 컴파일하거나 서명할 수 없습니다.

맥북 하나에만 서명이 남아있다

인증서와 프로파일은 종종 한 사람의 맥북에 저장되어 있다. 그 사람이 없거나 프로파일이 만료되면 릴리즈는 기다린다.

자체 호스팅 macOS CI는 자신의 프로젝트이다

임대된 macOS 러너는 여전히 Xcode 업데이트, Fastlane 경로, 서명 비밀, 디버깅이 필요하며 Apple이 변경할 때마다.

숨겨진 작업

릴리즈 빌드가 맥북 이외에 무엇을 필요로 하는가

맥북을 구매하는 것은 단지 하드웨어 부분만 해결한다. 여전히 Apple 계정 설정, 서명 파일, 빌드 도구가 필요하며 누군가가 유지해야 한다.

1

Apple 계정 설정

관리자 권한이 있는 Apple Developer 계정, 번들 ID, App Store Connect 앱 레코드, 업로드를위한 API 키

2

서명 파일 및 프로파일

배포 인증서를 .p12로 내보내고 각 번들 ID에 대한 배포 프로파일, 만료될 때마다 갱신

3

빌드 도구

Xcode 버전, CocoaPods 또는 Swift Package Manager, Fastlane, CI를위한 비밀을 보관하는 장소가 필요합니다.

Capgo를 사용하는 방법

Windows와 Linux 개발자들은 Capgo로 iOS를 배포합니다.

Capgo 제품을 사용하기 위해서는 Capacitor 앱, Capgo 계정, 그리고 Apple Developer 계정이 필요합니다. 아래 명령어는 모두 Capgo CLI 문서에서 가져온 것입니다.

  1. iOS signing을 한번 설정하세요

    The onboarding은 Capacitor 프로젝트를 읽어, 배포 인증서와 프로비전 프로파일을 생성하고, 그들을 로컬 머신에 저장합니다.

    npx @capgo/cli@latest build init --platform ios
    iOS 빌드 가이드
  2. 이미 있는 signing 파일을 저장하세요

    관리할 수 있는 인증서와 프로파일이 이미 있으면 App Store Connect API 키와 함께 저장하세요. 그들은 로컬 인증서 파일에 저장됩니다.

    npx @capgo/cli@latest build credentials save --platform ios \
      --apple-team-id YOUR_TEAM_ID \
      --apple-key ./AuthKey_XXXXX.p8 \
      --apple-key-id YOUR_KEY_ID \
      --apple-issuer-id YOUR_ISSUER_ID \
      --certificate ./certificate.p12 \
      --ios-provisioning-profile ./profile.mobileprovision
    인증서 관리
  3. 빌드를 요청하세요

    웹 빌드를 iOS 프로젝트에 동기화하고 빌드를 요청하세요. 로그는 터미널에 스트림되고, signed 빌드는 App Store Connect에 업로드되어 테스트 플라이트로 전송됩니다.

    npx cap sync ios
    npx @capgo/cli@latest build request com.example.app --platform ios
    시작하기
  4. CI에서 동일한 명령어를 실행하세요

    빌드 요청을 실행하기 위해 CAPGO_TOKEN을 설정하고, GitHub Actions, GitLab CI, 또는任意의 빌드 러너에서 빌드 시크릿을 CI에 내보내세요.

    npx @capgo/cli@latest build credentials manage
    # in your CI job
    npx @capgo/cli@latest build request com.example.app --platform ios
    GitHub Actions 설정

해결책

Capgo 없이 Mac 없이 빌드하십시오

Native builds run in the cloud when native code changes. Web changes keep shipping as live updates between store releases.

Mac이 필요할 때만

iOS 빌드는 Mac mini M4 기계에서 Xcode가 설치된 상태로 실행됩니다. 윈도우나 리눅스 데스크톱 또는 CI 실행자에서 터미널에서 요청을 보내면 됩니다.

Capgo 맥없이 빌드하기

iOS 빌드 가이드

build init creates the distribution certificate and provisioning profile for you. It uses an App Store Connect API key, which you create in your browser when you are on Windows or Linux.

Mac 없이 빌드하기

Mac이 필요할 때만

인증 정보를 한 번 저장한 후 터미널에서 빌드 요청을 실행할 수 있습니다. GitHub Actions, GitLab CI, 또는 다른 pipeline에서 빌드 요청을 실행할 수 있습니다.

빌드 명령어 참조

네이티브 빌드 플러스 라이브 업데이트

Use Capgo Build when plugins, permissions, icons, or the Capacitor version change. Ship JavaScript, CSS, and asset changes as live updates after users install the store build.

Live update 빌드 또는 네이티브 빌드?

신뢰 모델

클라우드 하드웨어를 사용하여 code와 키를 넘기지 않습니다.

Capgo는 빌드가 실행되는 동안만 자격 증명을 보유합니다. 자격 증명은 머신 또는 CI 비밀에 남아 있습니다.

네이티브 프로젝트만 업로드됩니다.

CLI는 네이티브 플랫폼 폴더와 네이티브 종속성을 업로드합니다. 전체 저장소는 머신에 남아 있습니다.

로그는 터미널로 스트림됩니다.

빌드 로그는 빌드가 실행되는 동안 라이브로 스트림되고 Capgo 서버에 저장되지 않습니다.

자격 증명은 빌드 동안만 존재합니다.

인증서와 프로파일은 빌드 중에 메모리에서 사용되고 빌드가 끝나면 삭제됩니다. 각 빌드는 격리된 환경에서 실행되고 나중에 삭제됩니다.

Capacitor으로 빌드된 앱

운영 앱은 한 대의 로컬 맥을 기다리지 않아야 합니다.

학교, 교통 및 지원 앱은 팀이 대부분 웹, 지원 또는 운영을 담당할 때도 서명된 모바일 릴리스가 필요합니다. 호스팅 빌드 워크플로우는 단일 머신 병목 현상을 제거하면서 서명 단계를 반복할 수 있도록 합니다.

IRIS ParentMail 앱 아이콘 교육

IRIS ParentMail

학교 커뮤니케이션 앱으로, 비영어권 팀이 신뢰할 수 있는 서명된 릴리스가 필요합니다.

구글 플레이 설치
1,200,000
스토어 평점
2.8
KAI Access: Train Booking App 앱 아이콘 여행 및 지역

KAI Access: 열차 예약 앱

개발자 한 명의 컴퓨터에 의존하지 않고 릴리즈 핸드오프가 이루어지는 수송 예약 앱입니다.

Google Play 설치
13,500,000
Store 평점
3.6
Técnico Virtual – Suporte Técn 앱 아이콘 도구

가상 기술자 – 기술 지원

반복 가능한 모바일 빌드 기록이 필요한 운영 팀을 위한 지원 도구입니다.

구글 플레이 설치
10,300,000
스토어 평점
4.3

고객 증명

Capgo을 사용하는 팀들이 말하는 것

5.0/5 개발자 팀으로부터 평가 9,400+ 개발자 팀 리뷰 보기

sikafanka

디자인, 반경 5

“Capgo 빌드가 우리에게 Capacitor 앱 릴리스 프로세스를 단순화했습니다. 우리는 iOS와 Android 앱을 하나의 명확한 워크플로에서 빌드하고 배포할 수 있습니다.”

Mikołaj Wilczek

Mikołaj Wilczek

Tellent의 모바일 플랫폼 엔지니어

“우리는 Capgo의 플러그인을 통해 처음으로 접하게 되었고, 그게 우리 팀의 릴리스 프로세스를 훨씬 더 효율적으로 관리하는 데 큰 도움이되었습니다.”

FAQ

iOS를 Mac 없이 빌드하는 방법

What Windows와 Linux 개발자가 첫 번째 클라우드 iOS 빌드를 하기 전에 물어보는 질문들

Mac이 필요합니까?

컴파일, 서명, 업로드를 위해 Mac이 필요하지 않습니다. 빌드는 Capgo의 Mac mini M4 머신에서 실행됩니다. Apple Developer 계정이 필요합니다. Windows 또는 Linux에서 App Store Connect API 키를 브라우저에서 생성하고, CLI는 인증서와 프로필을 관리합니다.

iOS 빌드 가이드

iOS 빌드가 얼마나 걸리는지 궁금합니다.

일반적인 네이티브 빌드는 2-3분 정도 걸립니다. 빌드가 실행되는 동안 로그는 터미널에 스트리밍되므로 오류를 즉시 확인할 수 있습니다.

첫 번째 빌드 가이드

빌드가 바로 테스트 플라이트로 갈 수 있나요?

네. App Store Connect API 키가 있는 자격 증명에서, 빌드는 App Store Connect로 업로드되고, 테스트 플라이트에서 테스트하고 앱 스토어 리뷰에 제출할 수 있습니다. --output-upload 옵션을 추가하면 IPA 다운로드 링크도 제공됩니다.

빌드 구성

인증서가 어디에 저장되어 있는가요?

On your machine, in ~/.capgo-credentials/credentials.json by default, or in your CI secrets. They are sent to Capgo only for the duration of a build and deleted afterwards.

인증서 관리

변경 사항마다 새로운 빌드를 해야 하나요?

Capacitor 빌드 또는 네이티브 빌드?

Live update 빌드 또는 네이티브 빌드?

Mac을 구매하지 않고 iOS를 배포하세요

14일 무료试用 기간 동안 첫 번째 서명된 iOS 빌드를 실행하고 필요할 때 Android, CI 및 실시간 업데이트 추가

마틴의 인간 지원