__CAPGO_KEEP_1__
Capgo - Live Updates for Capacitor Apps Capgo

도움이 필요하세요

Capgo Cloud Build와 함께 iOS 또는 Android 네이티브 빌드를 몇 분만에 시작하세요.

필요한 것들

Section titled “What You’ll Need”

시작하기 전에 다음을 확인하세요:

  • 로컬에서 성공적으로 빌드되는 Capacitor 앱
  • Node.js 20 이상이 설치되어야 합니다.
  • Capgo 계정 (무료试用도 시작하기에 충분합니다)
  • Capgo에 이미 앱이 등록되어 있는지 확인하세요 (아래 명령어를 실행하세요) npx @capgo/cli@latest app add if not
  • (이미 서명 인증서를 준비할 필요가 없습니다. 다음 단계에서 설정할 것입니다.)

서명 인증서 설정

Section titled “Configure your signing credentials”

Capgo는 앱을 빌드하고 제출하기 위해 서명 인증서가 필요하지만, 수동으로 관리할 필요는 없습니다. 몇 가지 질문에 답변하고, 정확한 명령어를 실행할 수 있도록 가르쳐 드리겠습니다:

첫 번째 빌드 실행

Run your first build

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 debug

CLI은 준비된 네이티브 프로젝트를 업로드하고 빌드 로그를 실시간으로 터미널에 스트리밍합니다. Capgo 빌드는 적절한 릴리스 플로우를 구성할 때 서명된 아티팩트를 반환하거나 앱 스토어 커넥트 또는 구글 플레이에 제출할 수 있습니다.

빌드 프로세스 이해

‘빌드 프로세스 이해’ 섹션

빌드 명령어를 실행할 때 발생하는 일

  1. CI에서 준비 - 웹层 빌드, 개인 의존성 해결, 완료된 자산을 네이티브 프로젝트에 동기화합니다.
  2. 업로드 - 준비된 네이티브 프로젝트는 안전한 클라우드 스토리지로 업로드됩니다.
  3. 빌드 실행 - Capgo는 전용 인프라에서 네이티브 프로젝트를 컴파일하고 서명합니다.
  4. 로그 스트리밍 - 실시간 로그는 Server-Sent Events를 통해 터미널에 스트리밍됩니다.
  5. 정리 - 빌드 환경과 임시 프로젝트 데이터는 빌드 후에 정리됩니다. 출력 보존은 선택한 아티팩트 및 스토어 전달 옵션에 따라 달라집니다.

Bitrise 또는 다른 CI를 사용하여 Capgo 빌드

Bitrise 또는 다른 CI를 사용하여 Capgo 빌드

Capgo 빌드는 기존 CI를 대체하지 않습니다. 비트리스 또는 다른 CI 시스템에서 필요로 하는 개인 접근 권한이 있는 단계를 유지하세요: 개인 레지스트리에서 설치, SSH를 통해 개인 CocoaPods를 해결, 커스텀 네이티브 설정을 실행, 웹 레이어를 빌드, 그리고 실행 npx cap sync.

그 다음 Capgo 빌드에 준비된 네이티브 프로젝트를 호출하세요. Capgo은 준비된 프로젝트를 받습니다. ios/ 또는 android/ 컨텍스트: HTML 텍스트 프래그먼트가 더 긴 Capgo UI 문자열 (부모 키 `alternatives_cta_questions`). 페이지/영역: Capacitor live-update 대안 비교 페이지. 역할: 장기 마케팅 또는 법적 문단. Seen in: 페이지 alternatives.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하세요. 메시지 키 `alternatives_cta_questions` (대안 CTA 질문). | HTML 텍스트 프래그먼트가 더 긴 Capgo UI 문자열 (부모 키 `appflow_cta_questions`). 페이지/영역: Appflow 비교/이동 마케팅 복사본. 역할: 장기 마케팅 또는 법적 문단. Seen in: 페이지 ionic-appflow.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하세요. 메시지 키 `appflow_cta_questions` (Appflow CTA 질문). | HTML 텍스트 프래그먼트가 더 긴 Capgo UI 문자열 (부모 키 `capwesome_cta_questions`). 페이지/영역: Capawesome 비교 페이지. 역할: 장기 마케팅 또는 법적 문단. Seen in: 페이지 capwesome.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하세요. 메시지 키 `capwesome_cta_questions` (Capwesome CTA 질문). | HTML 텍스트 프래그먼트가 더 긴 Capgo UI 문자열 (부모 키 `consulting_faq_subtitle`). 페이지/영역: 컨설팅 서비스 페이지. 역할: 섹션 서브 타이틀 또는 태그 라인. Seen in: 페이지 consulting.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지하세요. 메시지 키 `consulting_faq_subtitle` (컨설팅 FAQ 서브 타이틀). | 페이지/영역: Appflow 비교/이동 마케팅 복사본. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. Seen in: 페이지 ionic-appflow.astro, 페이지 ionic-enterprise-plugins.astro, 페이지 solutions/ionic-enterprise-plugins.astro. 메시지 키 `appflow_plugins_or` (Appflow 플러그인 또는)

프로젝트를 컴파일하고 서명하기 위해 필요로 하는 네이티브 프로젝트를 받습니다. 웹 소스 __CAPGO_KEEP_1__, 개인 의존성 설치, 그리고 __CAPGO_KEEP_2__ 동기화는 CI에서 유지됩니다.

업로드하는 것

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

__CAPGO_KEEP_0__ 빌드는 준비된 네이티브 프로젝트를 받습니다. 네이티브 프로젝트는 앱을 컴파일하기 위해 필요로 하는 프로젝트입니다. 웹 소스 __CAPGO_KEEP_1__, 개인 의존성 설치, 그리고 __CAPGO_KEEP_2__ 동기화는 CI에서 유지됩니다.

업로드되는 내용
포함설명
ios/ 또는 android/Capacitor Live-Update 대안 비교 페이지
package.json, package-lock.jsonCapacitor Live-Update 대안 비교 페이지
capacitor.config.*Capacitor configuration
resources/Capacitor Live-Update 대안 비교 페이지
Native plugin codeCapacitor Live-Update 대안 비교 페이지 ios/ Capacitor Live-Update 대안 비교 페이지 android/ subfolder of each Capacitor plugin

업로드되지 않은 것들

업로드되지 않은 것들
제외된 것들왜
node_modules/ (대부분의 것)Only native plugin code is included, not JS dependencies
src/웹 소스 code는 로컬에 유지됩니다.
dist/, www/, build/ (루트 레벨)버전 관리 기록 cap sync
.git/빌드 캐시 및 IDE 설정
.gradle/, .idea/, .swiftpm/, 비밀
.env(대부분의 것)업로드되지 않은 항목

Your Responsibilities

실행하기 전에

CI에서 준비하기 npx @capgo/cli@latest build request:

  1. - 비트리스(Bitrise) 또는 기존 CI에서 개인 패키지 레지스트리, SSH 기반 CocoaPods, 장치 SDK, 확장 및 사용자 지정 네이티브 준비를 해결합니다. 웹 자산 빌드하기
  2. - run npm run build 또는 (또는 framework의 빌드 명령어)
  3. 자연스럽게 동기화 - 실행 npx cap sync 컴파일된 웹 자산을 준비된 네이티브 프로젝트에 복사합니다.
  4. 네이티브 빌드를 요청 - 준비된 ios/ 또는 android/ project to Capgo Build.

What Capgo Build Handles

Section titled “What Capgo Build Handles”
  • Capacitor live-update 대안
  • Capacitor live-update 대안을 비교합니다. (Capacitor live-update 대안 비교). | HTML 텍스트 프래그먼트 (부모 키 `appflow_cta_questions`). 페이지/영역: Appflow 비교/이동 마케팅 복사본. 역할: 장기 마케팅 또는 법률 문단. 표시: 페이지 ionic-appflow.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지합니다. (Appflow CTA 질문). | HTML 텍스트 프래그먼트 (부모 키 `capwesome_cta_questions`). 페이지/영역: Capawesome 비교 페이지. 역할: 장기 마케팅 또는 법률 문단. 표시: 페이지 capwesome.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지합니다. (Capwesome CTA 질문). | HTML 텍스트 프래그먼트 (부모 키 `consulting_faq_subtitle`). 페이지/영역: 컨설팅 서비스 페이지. 역할: 섹션 서브 타이틀 또는 태그 라인. 표시: 페이지 consulting.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지합니다. (컨설팅 FAQ 서브 타이틀). | 페이지/영역: Appflow 비교/이동 마케팅 복사본. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 표시: 페이지 ionic-appflow.astro, 페이지 ionic-enterprise-plugins.astro, 페이지 solutions/ionic-enterprise-plugins.astro. Capgo 제품/브랜드 및 개발자 용어를 정확하게 유지합니다. (Appflow 플러그인 또는).
  • Code Code
  • __CAPGO_KEEP_0__ App Store Connect 또는 Google Play 제출
  • __CAPGO_KEEP_0__ 지원되는 네이티브 빌드 구성 및 자격 증명이 환경 변수로 전달됩니다.

Capgo Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__
npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload __CAPGO_KEEP_0__ --output-upload __CAPGO_KEEP_0__

__CAPGO_KEEP_0__ 다음 단계

다음 단계

첫 번째 빌드를 생성했습니다:

  • iOS 빌드 구성 - 인증서 및 프로파일 설정
  • Android 빌드 구성 - 키스토어 및 Play Store 설정
  • 문제 해결 컨텍스트: 지원 / 프리미엄 지원 페이지 또는 푸터 지원 섹션. 역할: 섹션 또는 페이지 제목. 보이는 곳: 페이지 support-policy.astro. 메시지 키 `support_policy_troubleshooting_title` (지원 정책 문제 해결 제목).
  • CLI Reference __CAPGO_KEEP_0__ 참조

- 완전한 명령어 문서

도움이 필요합니다?