맥이 없으면 iOS 빌드가 불가능합니다.
애플의 빌드 도구는 macOS가 필요합니다. 윈도우나 리눅스에서 개발자도 macOS가 없는 상태에서 iOS 빌드를 컴파일하거나 서명할 수 없습니다.
윈도우와 리눅스 개발자들을 위한
Capgo 빌드는 cloud Mac 머신에서 Capacitor iOS 앱을 컴파일하고 서명합니다. 윈도우, 리눅스, 또는 CI에서 CLI 명령어를 실행하면 서명된 빌드가 App Store Connect로 업로드되어 TestFlight에 배포됩니다.
인간 지원으로부터 마틴
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 머신에서 실행됩니다. 이미 사용하는 컴퓨터에서 시작합니다.
인증된 업로드
빌드는 인증서로 서명되고 애플 스토어 커넥트로 업로드되며 테스트 플라이트에 준비됩니다.
문제
애플의 빌드 도구는 macOS가 필요합니다. 윈도우나 리눅스에서 개발자도 macOS가 없는 상태에서 iOS 빌드를 컴파일하거나 서명할 수 없습니다.
인증서와 프로파일은 종종 한 사람의 맥에 위치한다. 그 사람이 없거나 프로파일이 만료되면 릴리즈는 기다린다.
임대된 macOS 러너는 여전히 Xcode 업데이트, Fastlane 경로, 서명 비밀, 디버깅이 필요하며 Apple이 변경할 때마다.
이것은 어떻게 작동하는가
Capgo 제품을 사용하려면 Capacitor 앱, Capgo 계정, 그리고 Apple Developer 계정이 필요합니다. 아래 명령어는 Capgo CLI 문서에서 가져온 것입니다.
인증서와 프로파일을 이미 가지고 있다면, App Store Connect Capacitor 키와 함께 저장하세요. 그들은 로컬 인증서 파일에 저장됩니다.
npx @capgo/cli@latest build init --platform ios
인증서 관리
If your team already has a certificate and profile, save them with your App Store Connect API key. They stay in a local credentials file.
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
__CAPGO_KEEP_0__ 앱, __CAPGO_KEEP_1__ 계정, 그리고 Apple Developer 계정이 필요합니다. 모든 명령어는 __CAPGO_KEEP_2__ __CAPGO_KEEP_3__ 문서에서 가져옵니다.
온보딩은 __CAPGO_KEEP_0__ 프로젝트를 읽어, 배포 인증서와 프로비전 프로파일을 생성하고, 그들을 컴퓨터에 저장합니다.
npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios
첫 번째 빌드 가이드
빌드 요청을 실행하기 위해 CAPGO_TOKEN을 설정하고, GitHub Actions, GitLab 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 설정
솔루션
Native builds run in the cloud when native code changes. Web changes keep shipping as live updates between store releases.
Capgo 빌드 개요
Capgo 맥없이 빌드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.
동일한 명령어로 CI에서 빌드GitHub 단 한번의 인증 정보 저장, 터미널에서 빌드 요청을 실행하고, GitHub Actions, GitLab CI, 또는 다른 pipeline에서 빌드합니다.
CLI 명령 참조Capgo 빌드 사용할 때는 플러그인, 권한, 아이콘, 또는 Capacitor 버전이 변경될 때 빌드합니다. 사용자들이 스토어 빌드를 설치한 후에 자바스크립트, CSS, 및 자산 변경을 실시간으로 업데이트합니다.
Live update 빌드인지 네이티브 빌드인지?신뢰 모델
Capgo는 빌드가 실행되는 동안만 자격 증명을 보유합니다. 자격 증명은 머신 또는 CI 비밀에 저장됩니다.
CLI는 네이티브 플랫폼 폴더와 네이티브 의존성을 업로드합니다. 전체 저장소는 머신에 유지됩니다.
빌드 로그는 빌드가 실행되는 동안 실시간으로 스트리밍되고 Capgo 서버에 저장되지 않습니다.
인증서 및 프로파일은 빌드 중에 메모리에서 사용되고 빌드가 완료되면 삭제됩니다. 각 빌드는 격리된 환경에서 실행되고 나중에 삭제됩니다.
Capacitor으로 빌드된 앱
학교, 교통 및 지원 앱은 팀이 대부분 웹, 지원 또는 운영을 담당할 때도 서명된 모바일 릴리스가 필요합니다. 호스팅 빌드 워크플로우는 단일 머신 병목 현상을 제거하면서 서명 단계를 반복할 수 있도록 합니다.
학교 커뮤니케이션 앱에서 비영어권 팀이 신뢰할 수 있는 서명된 릴리스가 필요합니다.
개발자 한 명의 컴퓨터에 의존하지 않고 릴리즈 핸드오프가 이루어지는 전자여행 예약 앱입니다.
반복 가능한 모바일 빌드 기록이 필요한 운영 팀에 대한 지원 도구입니다.
디자인, 반경 5
“Capgo 빌드가 우리에게 Capacitor 앱 릴리스 프로세스를 단순화했습니다. 우리는 iOS 및 Android 앱을 하나의 명확한 워크플로우에서 빌드하고 배포할 수 있습니다.”
Tellent의 모바일 플랫폼 엔지니어
“우리는 원래 Capgo의 플러그인을 통해 발견했으며, 이는 우리 팀의 릴리스 프로세스를 훨씬 더 효율적으로 관리하는 데 큰 도움이되었습니다.”
FAQ
Windows 및 Linux 개발자들이 첫 번째 클라우드 iOS 빌드를 하기 전에 물어보는 질문들입니다.
빌드는 Capgo의 맥 미니 M4 머신에서 실행됩니다. Apple Developer 계정이 필요합니다. Windows 또는 Linux에서 App Store Connect API 키를 브라우저에서 생성하고, CLI는 인증서와 프로파일을 관리합니다.
iOS 빌드 가이드일반적인 네이티브 빌드는 2–3분 정도 걸립니다. 빌드가 실행되는 동안 로그는 터미널에 스트리밍되므로 오류를 즉시 확인할 수 있습니다.
첫 번째 빌드 가이드네. App Store Connect API 키가 있는 자격 증명에서 빌드가 signed 상태로 업로드되며, 테스트 플라이트에서 테스트하고 앱 스토어 리뷰에 제출할 수 있습니다. --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 update14일 무료试用 기간 내에 첫 번째 서명된 iOS 빌드를 실행하고 필요할 때 Android, CI 및 실시간 업데이트 를 추가하세요.
인간 지원으로부터 Martin