시작하기
설치 단계와 이 플러그인의 전체 마크다운 가이드와 함께 설정 프롬프트를 복사합니다.
Capgo Cloud Build와 시작하여 1분 이내에 iOS 또는 Android 네이티브 빌드를 생성하세요.
필요한 것
“필요한 것”이라는 제목의 섹션시작하기 전에 다음을 확인하세요:
- A Capacitor 앱이 로컬에서 성공적으로 빌드되었습니다.
- Node.js 20 이상이 설치되어 있습니다.
- A Capgo 계정 (시작하기 위해 무료试用판이 충분합니다.)
- Capgo에 이미 앱이 등록되어 있습니다 (아니면 "run"을 실행하세요).
npx @capgo/cli@latest app add(앞서 준비할 필요가 없는 서명 인증서를 미리 준비할 필요가 없습니다. — 다음 단계에서 설정할 것입니다.) - 서명 인증서를 구성하세요.
제목 "서명 인증서를 구성하세요."
__CAPGO_KEEP_0__는 앱을 빌드하고 제출하기 위해 서명 인증서가 필요하지만, 수동으로 관리할 필요가 없습니다. 몇 가지 질문에 답변하고, 정확한 명령어를 실행할 위치를 알려드리겠습니다.Capgo needs signing credentials to build and submit your app — but you don’t have to wrangle them by hand. Answer a couple of questions and we’ll point you to the exact command to run:
제목 "첫 번째 빌드를 실행하세요."
__CAPGO_KEEP_0__에 인증되어야 빌드를 할 수 있습니다. 만약 이미 인증하지 않았다면:Capgo
npx @capgo/cli@latest login# or, in CI, set the token directly:export CAPGO_TOKEN=your_api_key만약에 최근에 build init, 그럼 이미 설정이 완료된 상태 — 온보딩은 빌드 시작을 제안하기 때문에 첫 번째 빌드는 이미 진행 중일 수 있습니다. 🎉
그렇지 않다면, 빌드를 직접 시작하세요. build request — 설정 --platform 을 원하는 빌드에 맞게:
npx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debugCLI은 준비된 네이티브 프로젝트를 업로드하고 빌드 로그를 실시간으로 터미널에 스트리밍합니다. Capgo 빌드는 서명된 아티팩트를 반환하거나 App Store Connect 또는 Google Play로 제출할 수 있습니다. 빌드 프로세스를 구성할 때 적절한 릴리스 흐름을 설정하면.
빌드 프로세스 이해
제목 ‘빌드 프로세스 이해’When you run the build command, here’s what happens:
flowchart LR
A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
B -->|2. Upload| C[Capgo Build]
C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
D -->|4. Stream Logs| E[Your Terminal]
D -->|Return Signed Artifact or Store Delivery| F[Output]
D -->|5. Clean Temporary Project Data| G[Cleanup]
- CI에서 준비하세요 - 웹层를 빌드하고, 개인 의존성을 해결하고, 완료된 자산을 네이티브 프로젝트에 동기화합니다.
- 업로드 - 준비된 네이티브 프로젝트는 보안 클라우드 스토리지에 업로드됩니다.
- 빌드 실행 - Capgo는 전용 인프라에서 네이티브 프로젝트를 컴파일하고 서명합니다.
- 로그 스트리밍 - 서버 SENT 이벤트를 통해 실시간 로그가 터미널로 스트리밍됩니다.
- 정리 - 빌드 환경과 임시 프로젝트 데이터는 빌드 후 정리됩니다. 선택한 아티팩트 및 스토리지 전달 옵션에 따라 출력 보존이 달라집니다.
Capgo 빌드와 Bitrise 또는 다른 CI를 사용하세요.
Capgo 빌드가 기존 CI를 대체하지 않습니다. Bitrise 또는 다른 CI 시스템에서 개인 접근이 필요한 단계를 유지하세요: 개인 레지스트리에서 설치, SSH를 통해 개인 CocoaPods를 해결, 커스텀 네이티브 설정, 웹 레이어 빌드, 빌드 단계 실행Capgo 빌드는 준비된 네이티브 프로젝트와 함께 호출하세요. __CAPGO_KEEP_1__은 준비된 프로젝트를 받고, 프로젝트를 컴파일하고 서명하기 위해 사용됩니다. 따라서 __CAPGO_KEEP_1__은 개인 Nexus, CocoaPods SSH, 또는 웹 빌드 인증서를 필요로 하지 않습니다. 컴파일된 웹 자산은 이미 준비된 네이티브 프로젝트 내에 포함되어 있으며 빌드에 사용됩니다. 원본 저장소로 유지되지 않습니다. npx cap sync.
Then call Capgo Build with the prepared native project. Capgo receives the ready ios/ __CAPGO_KEEP_0__ 빌드는 네이티브 프로젝트를 컴파일하기 위해 필요한 준비된 네이티브 프로젝트를 받습니다. 웹 소스 __CAPGO_KEEP_1__, 개인 의존성 설치, 그리고 __CAPGO_KEEP_2__ 동기화는 CI에서 유지됩니다. android/ 업로드되는 것
__CAPGO_KEEP_0__ 빌드는 네이티브 프로젝트를 컴파일하기 위해 필요한 준비된 네이티브 프로젝트를 받습니다. 웹 소스 __CAPGO_KEEP_1__, 개인 의존성 설치, 그리고 __CAPGO_KEEP_2__ 동기화는 CI에서 유지됩니다.
포함된 것Capgo 빌드는 네이티브 프로젝트를 컴파일하기 위해 필요한 준비된 네이티브 프로젝트를 받습니다. 웹 소스 code, 개인 의존성 설치, 그리고 Capacitor 동기화는 CI에서 유지됩니다.
__CAPGO_KEEP_0__ 빌드는 네이티브 프로젝트를 컴파일하기 위해 필요한 준비된 네이티브 프로젝트를 받습니다. 웹 소스 __CAPGO_KEEP_1__, 개인 의존성 설치, 그리고 __CAPGO_KEEP_2__ 동기화는 CI에서 유지됩니다.
__CAPGO_KEEP_0__ 빌드는 네이티브 프로젝트를 컴파일하기 위해 필요한 준비된 네이티브 프로젝트를 받습니다. 웹 소스 __CAPGO_KEEP_1__, 개인 의존성 설치, 그리고 __CAPGO_KEEP_2__ 동기화는 CI에서 유지됩니다.| __CAPGO_KEEP_0__ 빌드는 네이티브 프로젝트를 컴파일하기 위해 필요한 준비된 네이티브 프로젝트를 받습니다. 웹 소스 __CAPGO_KEEP_1__, 개인 의존성 설치, 그리고 __CAPGO_KEEP_2__ 동기화는 CI에서 유지됩니다. | __CAPGO_KEEP_0__ 설정 |
|---|---|
ios/ 또는 android/ | __CAPGO_KEEP_0__ 네이티브 플랫폼 폴더 |
package.json, package-lock.json | 의존성 매니페스트 |
capacitor.config.* | Capacitor 구성 |
resources/ | 앱 아이콘, 스플래시 화면 |
| 네이티브 플러그인 code | __CAPGO_KEEP_0__ 플러그인의 서브 폴더만 ios/ 또는 android/ Capacitor 플러그인의 서브 폴더 |
업로드되지 않은 것들
__CAPGO_KEEP_0__가 업로드되지 않은 것들| 제외 | 왜 |
|---|---|
node_modules/ (대부분) | code라는 네이티브 플러그인은 포함되지만, JS 의존성은 포함되지 않습니다. |
src/ | 웹 소스 code는 로컬에 유지됩니다. |
dist/, www/, build/ (루트 레벨) | __CAPGO_KEEP_0__가 네이티브 폴더로 자동으로同步되었습니다. cap sync |
.git/ | 버전 관리 기록 |
.gradle/, .idea/, .swiftpm/ | 빌드 캐시 및 IDE 설정 |
.env, 비밀 | 업로드되지 않습니다. |
__CAPGO_KEEP_0__
Your Responsibilities__CAPGO_KEEP_0__ npx @capgo/cli@latest build request:
- Before running Prepare in your CI
- - __CAPGO_KEEP_0__ - __CAPGO_KEEP_1__
npm run build- __CAPGO_KEEP_2__ - - __CAPGO_KEEP_3__ - Run
npx cap sync웹 자산을 준비된 네이티브 프로젝트에 컴파일된 것을 복사합니다. - 네이티브 빌드를 요청하세요 - 준비된
ios/또는android/프로젝트를 Capgo 빌드로 보내세요.
Capgo 빌드는 무엇을 처리하는가
Section titled “What Capgo Build Handles”- 네이티브 Android 컴파일 (Gradle)
- __CAPGO_KEEP_0__ 인증서와 함께 서명
- Code signing with your credentials
- Optional App Store Connect or Google Play submission
- 자연스러운 빌드 구성 및 환경 변수를 통한 자격 증명 값을 지원합니다.
Capgo 빌드는 CI가 네이티브 프로젝트를 준비한 후에 개인 Nexus 레지스트리 또는 SSH 자격 증명을 액세스할 필요가 없습니다. 자세한 내용은 빌드 구성 을 참조하십시오. 지원되는 환경 변수 및 저장 옵션을 확인하십시오.
MDM를 통해 분산되는 키오스크 버전을 구성하려면 Android 프로젝트/빌드를 APK를 생성하도록 구성하십시오. 빌드 요청 시 Google Play를 생략하고 signed 출력을 받으려면 두 플래그를 사용하십시오:
npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload--no-playstore-upload Play Store 업로드를 방지하기 위해 Play 자격 증명이 저장되어도; --output-upload 시간 제한된 signed 출력에 대한 링크를 제공합니다. MDM를 통해 그 APK를 분산하십시오.
다음 단계
‘다음 단계’라는 제목을 가진 섹션이제 첫 번째 빌드를 생성했습니다:
- iOS 빌드 설정 - 인증서 및 프로파일 설정
- Android 빌드 설정 - 키스토어 및 Play Store 설정
- 문제 해결 - 일반적인 문제와 해결책
- CLI 참조 - 명령어 문서
도움말이 필요합니다.
도움말이 필요합니다. 섹션- 체크하는 문제 해결 가이드
- __CAPGO_KEEP_0__ __CAPGO_KEEP_1__
- __CAPGO_KEEP_2__ capgo.app