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

iOS 앱을 빌드하는 전통적인 방법은 한 가지 일 뿐입니다: Xcode가 필요하고 Xcode는 macOS를 의미합니다. 이 제약은 윈도우 또는 리눅스 팀의 모든 구성원이나 macOS 빌드 머신을 유지 관리하지 않으려는 경우가 불편합니다.

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

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

• Windows에서 일반적인 웹 프로젝트처럼 개발하세요.
• __CAPGO_KEEP_0__ ios/ 원본 저장소에 (원래 상태가 재현 가능하도록) 저장하세요.
• __CAPGO_KEEP_0__ cap sync 로컬에서 (웹 빌드가 iOS 프로젝트에 복사되는) 실행하세요.
• Capgo 빌드

실제로 빌드하는 곳

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

• 웹 빌드 (your JS/HTML/CSS): Windows 환경에서 이 작업을 지역적으로 수행합니다.
• 자연스러운 빌드 (Xcode 아카이브, 서명, 업로드): Capgo 빌드는 Mac 하드웨어에서 클라우드에서 이 작업을 수행합니다.

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

필수 조건

• 작동하는 Capacitor 앱 (어떤 프레임워크든 상관 없습니다.)
• Apple 개발자 계정
• 업로드하고자 하는 앱에 대한 App Store Connect 접근 권한
• Your Capgo 계정과 API 토큰 (CAPGO_TOKEN).

1) Capacitor 앱을 생성하거나 준비하세요 (Windows)

웹 앱이 이미 있는 경우 Capacitor 단계로 건너 뛰세요.

Vite 예시:

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

Build는 정적 자산을 생성해야 합니다 (Vite의 경우 기본적으로): dist/ 2) iOS 플랫폼에 __CAPGO_KEEP_0__과 iOS 플랫폼을 추가하세요.

bun run build

Capacitor을 설치하세요.

Install Capacitor:

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

이 시점에서 iOS 플랫폼 폴더가 생성됩니다. Git에 커밋하세요. __CAPGO_KEEP_0__ Build는 폴더 내의 파일을 컴파일합니다. 따라서 버전 관리 및 재현이 가능해야 합니다.

bunx cap init
bunx cap add ios

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

4) __CAPGO_KEEP_0__과 __CAPGO_KEEP_1__을 설치하고 인증하세요.

4) __CAPGO_KEEP_0__과 __CAPGO_KEEP_1__을 설치하고 인증하세요.

bun run build
bunx cap sync ios

cap sync 4) Capgo과 __CAPGO_KEEP_1__을 설치하고 인증하세요.

4) Capgo과 CLI을 설치하고 인증하세요.

Capgo iOS 빌드가 Capgo CLI를 통해 트리거됩니다. bun을 사용하여 bunx:

bunx @capgo/cli@latest login

__CAPGO_KEEP_0__ Build는 __CAPGO_KEEP_1__ __CAPGO_KEEP_2__를 통해 트리거됩니다. __CAPGO_KEEP_3__을 사용하여

export CAPGO_TOKEN="your_api_key_here"

__CAPGO_KEEP_0__ Build는 __CAPGO_KEEP_1__ __CAPGO_KEEP_2__를 통해 트리거됩니다. __CAPGO_KEEP_3__을 사용하여

__CAPGO_KEEP_0__을 사용하여

• 5) iOS 클라우드 빌드에 대한 iOS Signing을 구성하십시오..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__ 문서를 참조하십시오.
• iOS 인증서 및 배포 프로파일을 얻는 방법

가장 쉬운 방법은: Mac이든 팀원이나 임대용으로 한 번만 사용하는 Mac이든, Windows에서 재사용할 수 있는 iOS 인증서와 배포 프로파일을 생성/내보내서 재사용하는 것입니다.

파일을 로컬에 저장한 후 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 Build is for native changes:

• adding/removing Capacitor plugins
• __CAPGO_KEEP_0__
• 아이콘/스플래시 변경
• Capacitor 업데이트
• Swift/Objective-C 변경 사항

일상적인 UI 조정 및 자바스크립트 수정을 위해 일반적으로 원하는 실시간 업데이트 (OTA)로, 매번 네이티브 바이너리를 재빌드하지 않습니다.

좋은 팀 워크플로우는:

• 실시간 업데이트 사용하여 자주 변경되는 웹 변경 사항
• Capgo 빌드를 간혹 사용하여 네이티브 변경 사항이 필요할 때

공통 Windows 오류 (및 해결 방법)

• 잊어버리기 cap sync: UI 변경 사항이 iOS 빌드에서 누락된 경우, iOS 빌드에서 UI 변경 사항이 누락된 경우, 웹 앱을 빌드했지만 __CAPGO_KEEP_0__을同步하지 않았을 가능성이 있습니다. ios/.
• Not committing ios/: Capgo Build은 네이티브 프로젝트를 컴파일합니다. 폴더가 Git에 있지 않거나 (또는 빌드 컨텍스트에 없다면) 빌드는 앱을 재현할 수 없습니다.
• Plugin 변경은 네이티브 재빌드가 필요합니다: 플러그인을 추가하는 것은 네이티브 변경입니다; Capgo 빌드 실행 (및 스토어 제출)을 계획하세요.

요약

윈도우에서 Xcode를 실행할 수 없지만, iOS 앱을 윈도우에서 배포할 수 있습니다: __CAPGO_KEEP_0__ ( 리포지토리 내에)로 웹 앱을.wrap하세요.

1. Wrap your web app with Capacitor (ios/ __CAPGO_KEEP_0__ Build를 사용하여 iOS 바이너리를 컴파일, 서명, 제출하세요. __CAPGO_KEEP_1__에서.
2. __CAPGO_KEEP_0__ Build을 사용하여 iOS 바이너리를 컴파일, 서명, 제출하세요. __CAPGO_KEEP_1__에서. cap sync.
3. Capgo Build을 사용하여 iOS 바이너리를 컴파일, 서명, 제출하세요. CLI에서.

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

__CAPGO_KEEP_0__을 사용하고 있다면 윈도우에서 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를 사용하세요. for the product workflow in Capgo Native Builds, Capgo Integrations for the product workflow in Capgo Integrations, __CAPGO_KEEP_0__ CI/CD를 사용하여 제품 워크플로우를 위한 CI/CD를 사용하세요. __CAPGO_KEEP_0__ Native Builds를 사용하여 제품 워크플로우를 위한 Native Builds를 사용하세요. GitHub 액션 통합 GitHub 액션 통합 구현 세부 사항을 위해.