Capacitor와 Capgo 빌드를 사용하여 iOS 앱을 윈도우에서 빌드하세요.

iOS 앱을 빌드하는 것은 전통적으로 한 가지 의미를 가지고 있습니다: Xcode가 필요하고 Xcode는 macOS를 의미합니다. 이러한 제약은 Windows 또는 Linux에서 팀이 모두 있는 경우 또는 Mac 빌드 머신을 유지 관리할 필요가 없는 경우 불편합니다.

__CAPGO_KEEP_0__ Capacitor (iOS 프로젝트를 생성하기 위해) Capgo 빌드 (클라우드에서 컴파일하고 서명할 수 있도록) Windows 워크스테이션에서 iOS 빌드 및 TestFlight 제출을 할 수 있게 해줍니다.

이 안내서에서는 팀에서 잘 작동하는 실용적인 워크플로우를 보여줍니다:

Windows에서 일반 웹 프로젝트처럼 개발하세요.
Keep ios/ 원본 상태를 재현할 수 있도록 리포지토리에 저장하세요.
Run cap sync 로컬에서 실행하세요 (웹 빌드를 iOS 프로젝트에 복사합니다).
클라우드에서 iOS 빌드를 Capgo Build로 트리거하세요.

실제로 빌드하는 곳

There are two separate “builds” in a Capacitor app:

웹 빌드 (당신의 JS/HTML/CSS): 이 작업은 Windows에서 로컬로 수행합니다.
자연어 빌드 (Xcode 아카이브, 서명, 업로드): Capgo 빌드는 Mac 하드웨어에서 클라우드에서 이 작업을 수행합니다.

이 분리는 핵심입니다: Capgo 빌드는 네이티브 프로젝트를 컴파일하지만 웹 자산이 이미 Synced 된 것을 기대합니다. ios/.

필수 조건

작동하는 Capacitor 앱 (어떤 프레임워크든 상관 없습니다).
Apple Developer 계정.
업로드하고자 하는 앱에 대한 App Store Connect 접근 권한 (TestFlight/App Store 제출을 위해).
당신의 Capgo 계정과 API 토큰 (CAPGO_TOKEN).

1) 당신의 Capacitor 앱을 만들거나 준비하세요 (Windows)

웹 앱이 이미 있다면 Capacitor 단계로 건너 뛰세요.

Vite 예시:

bun create vite@latest my-app
cd my-app
bun install

Windows에서 iOS 앱을 빌드하는 방법 dist/ 2) __CAPGO_KEEP_0__ 및 iOS 플랫폼을 추가하세요.

bun run build

Capacitor 설치:

Capacitor 초기화 및 iOS 플랫폼 폴더를 생성하세요.

bun add @capacitor/core @capacitor/ios
bun add -d @capacitor/cli

__CAPGO_KEEP_0__ 디렉토리가 생성됩니다. Git에 커밋하세요. __CAPGO_KEEP_0__ 빌드는 내부에 있는 것을 컴파일하기 때문에 버전을 관리하고 reproducible 하기를 원합니다.

bunx cap init
bunx cap add ios

3) iOS 빌드 전에 항상 웹 자산을 Sync하세요. ios/ directory. Commit it to git. Capgo Build compiles what is inside ios/__CAPGO_KEEP_0__ 빌드는 iOS 프로젝트에 빌드된 웹 자산을 복사합니다 (__CAPGO_KEEP_0__ 빌드는 실제로 컴파일할 파일입니다).

4) __CAPGO_KEEP_0 및 CAPGO_KEEP_1__을 설치하고 인증하세요.

__CAPGO_KEEP_0__ Build는 iOS 프로젝트에 빌드된 웹 자산을 복사합니다 (__CAPGO_KEEP_0__ Build는 실제로 컴파일할 파일입니다).

bun run build
bunx cap sync ios

cap sync Capgo Build는 iOS 프로젝트에 빌드된 웹 자산을 복사합니다 (Capgo Build는 실제로 컴파일할 파일입니다).

4) Install and Authenticate the Capgo CLI

Capgo Build is triggered via the Capgo CLI. With bun, use bunx:

bunx @capgo/cli@latest login

__CAPGO_KEEP_1__ __CAPGO_KEEP_2__를 통해 빌드가 트리거됩니다.

export CAPGO_TOKEN="your_api_key_here"

__CAPGO_KEEP_3__을 사용하여

환경 변수를 통해 토큰을 설정하세요.

5) iOS 빌드에 대한 인증서 설정.p12iOS 빌드를 위해 다음을 필요로합니다.
Apple Distribution 인증서 (.mobileprovision)
App Store Connect API key (AuthKey_XXXXXX.p8배포 프로파일 (

App Store Connect Capgo 키 (

) 및 메타데이터 (Key ID, Issuer ID, Team ID) 이 파일들을 생성해야 한다면, __CAPGO_KEEP_0__ 문서를 참조하세요.
How to Get iOS Certificates and Provisioning Profiles

가장 쉬운 방법은: 이들을 한 번만 생성/내보내기 (많은 경우에 Mac, 동료, 또는 일회용 임대가 사용됩니다)하고, 이후 Windows에서 재사용하는 것입니다.

파일을 로컬에 저장한 후 Capgo 빌드에 저장하세요:

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --certificate ./cert.p12 \
  --p12-password "password" \
  --provisioning-profile ./profile.mobileprovision \
  --apple-key ./AuthKey.p8 \
  --apple-key-id "KEY123" \
  --apple-issuer-id "issuer-uuid" \
  --apple-team-id "team-id"

팁: CI에서 자격 증명 파일을 base64로 인코딩하여 비밀로 저장하고, 런타임에 디코딩한 후 동일한 명령어를 실행하세요. build credentials save 6) Windows에서 iOS 빌드를 트리거하세요.

앱 폴더에서:

터미널에서 실시간 로그를 볼 수 있습니다. App Store Connect 키가 구성된 경우, __CAPGO_KEEP_0__ 빌드는 자동으로 테스트 플라이트에 결과 빌드를 제출할 수 있습니다.

bun run build
bunx cap sync ios
bunx @capgo/cli@latest build com.example.app --platform ios --build-mode release

You will see real-time logs in your terminal. If your App Store Connect key is configured, Capgo Build can submit the resulting build to TestFlight automatically.

__CAPGO_KEEP_0__ 빌드는 네이티브 변경 사항을 위한 것입니다:

Capgo 플러그인 추가/제거

adding/removing Capacitor plugins
네이티브 권한 변경
아이콘/스플래시 변경
Capacitor 업데이트
Swift/Objective-C 변경

일상적인 UI 조정 및 자바스크립트 수정을 위해, 일반적으로 실시간 업데이트 웹 변경을 위해 실시간 업데이트 사용

(OTA), 따라서 매번 네이티브 바이너리를 재빌드하지 않습니다.

좋은 팀 워크플로우는
Use Capgo Build occasionally when native changes are needed.

__CAPGO_KEEP_0__ 빌드를 간헐적으로 사용하여 네이티브 변경이 필요할 때

윈도우즈 일반적인 오류 (및 해결 방법) cap sync잊어버리다 ios/.
Not committing ios/: Capgo Build은 네이티브 프로젝트를 컴파일합니다. 폴더가 Git에 있지 않거나(또는 빌드 컨텍스트에 없다면) 빌드는 앱을 재현할 수 없습니다.
Plugin changes without native rebuild: 플러그인 추가는 네이티브 변경입니다. Capgo 빌드 실행(및 스토어 제출)을 계획하세요.

Summary

윈도우에서 Xcode를 실행할 수 없지만, iOS 앱을 윈도우에서 배포할 수 있습니다: __CAPGO_KEEP_0__ ( 을(를) 리포지토리에 포함합니다.

웹 앱을 빌드할 때 웹 자산을 로컬에서 빌드하고, Capacitor 빌드를 사용하여 iOS 바이너리를 컴파일, 서명, 제출하세요.ios/ __CAPGO_KEEP_1__
__CAPGO_KEEP_1__ cap sync.
Use Capgo Build to compile, sign, and submit your iOS binary from the CLI.

Capacitor와 Capgo을 사용하여 윈도우에서 iOS 앱을 빌드하세요.

If you are using 윈도우에서 iOS 앱을 Capacitor와 Capgo을 사용하여 빌드하세요. CI/CD 자동화 계획을 위해 __CAPGO_KEEP_0__ CI/CD와 연결하세요. Capgo CI/CD Capgo CI/CD에서 제품 워크플로우를 관리하세요. Capgo Native Builds Capgo Native Builds에서 제품 워크플로우를 관리하세요. Capgo Integrations Capgo Integrations에서 제품 워크플로우를 관리하세요. CI/CD 통합 CI/CD 통합에서 구현 세부 정보를 확인하세요. GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항