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

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

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

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

Windows에서 일반적인 웹 프로젝트처럼 개발하세요.
repo에 저장하세요 (그래서 원본 상태가 재현 가능합니다). ios/ 로컬에서 실행하세요 (그래서 웹 빌드는 iOS 프로젝트에 복사됩니다).
__CAPGO_KEEP_0__ 빌드 cap sync 실제로 빌드하는 곳
Trigger an iOS cloud build with Capgo Build.

웹 빌드

Capacitor

__CAPGO_KEEP_0__ (당신의 JS/HTML/CSS): Windows에서 로컬로 이 작업을 수행합니다.
네이티브 빌드 (Xcode archive, 서명, 업로드): Capgo Windows에서 Capgo와 Capacitor를 사용하여 Mac 하드웨어에서 클라우드에서 이 작업을 수행합니다.

이 분리는 핵심입니다: Capgo 빌드는 네이티브 프로젝트를 컴파일하지만 웹 자산이 이미 Sync로 동기화되어 있어야 합니다. ios/.

기본 조건

A working Capacitor app (any framework is fine).
애플 개발자 계정.
애플 스토어 연결 액세스 (테스트 플라이트/애플 스토어 제출을 위해) 앱에 대한 액세스
당신의 Capgo 계정과 API 토큰 (CAPGO_TOKEN).

1) Create or Prepare Your Capacitor App (Windows)

웹 앱이 이미 있는 경우 Capacitor 단계로 건너뛸 수 있습니다.

예제(Vite)

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

윈도우에서 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

bun run build
bunx cap sync ios

cap sync Capgo

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

The easiest path is: create/export these once (often using any available Mac, a teammate, or a one-time rental), then reuse them from Windows for every subsequent build.

Once you have the files locally, save them for Capgo Build:

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"

Tip: in CI, store the credential files base64-encoded as secrets, decode them at runtime, then run the same build credentials save 6) iOS 앱 빌드 트리거

From your app folder:

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

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__ Build는 네이티브 변경 사항에 대한 것입니다:

Capgo 플러그인 추가/제거

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

일상적인 UI 조정 및 JavaScript 수정을 위해, 보통 실시간 업데이트 역할: 섹션 또는 페이지 제목.

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

좋은 팀 워크플로우는 다음과 같습니다.
Use Capgo Build occasionally when native changes are needed.

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

공통 Windows 오류 (및 수정) cap sync잊어버리다 : UI 변경 사항이 iOS 빌드에 나타나지 않는다면, 웹 앱을 빌드했지만 Sync를 수행하지 않았을 가능성이 있습니다. ios/.
Not committing ios/: Capgo Build은 네이티브 프로젝트를 컴파일합니다. 폴더가 git에 있지 않거나 (또는 빌드 컨텍스트에 없다면) 빌드는 앱을 재현할 수 없습니다.
Plugin changes without native rebuild: 플러그인 추가는 네이티브 변경입니다; Capgo 빌드 실행 (및 스토어 제출)을 계획하세요.

Summary

윈도우에서 Xcode를 실행할 수는 없지만, 그러나 윈도우에서 iOS 앱을 배포할 수 있습니다:

웹 앱을 Capacitor (ios/ 리포지토리 내)에.wrap합니다.
웹 자산을 로컬에서 빌드한 후 __CAPGO_KEEP_0__ 빌드를 사용하여 iOS 바이너리를 컴파일, 서명, 제출하세요. 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 통합 구현 세부 사항을 위해 CI/CD Integration을 사용하세요. GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항