빌드 전처리 검사
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 AI 설정 지시를 복사하세요
Capgo Cloud Build가 프로젝트를 업로드하기 전에 CLI는 전처리 인증, 프로젝트 및 스토어 구성 문제를 로컬에서 잡습니다.
또한 독립적으로 실행됩니다:
npx @capgo/cli@latest build prescan <appId> --platform ios오늘은 80 개별 체크 아이디를 무시하는 것을 개인 체크를 모두 끄는 것보다 선호합니다.
특정 체크 무시
제목 ‘특정 체크 무시’# Skip one check entirely (example: intentional Capacitor server.url / Next.js shell)npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shipped
# Run the check but never block on it (error becomes warning)npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-warn ios/capacitor-server-url-shipped
# Repeatable or comma-separatednpx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shipped \ --prescan-warn ios/capacitor-allow-navigation-wildcard,ios/plist-ats-arbitrary-loads독립된 별칭 활성화 build prescan:
npx @capgo/cli@latest build prescan <appId> --platform ios \ --skip ios/capacitor-server-url-shipped \ --warn ios/capacitor-server-cleartext알 수 없는 체크 아이디는 빠른 오류와 함께 실패합니다.
전역 탈출 (적극적으로 사용하지 마세요)
세션 제목: 전역 탈출 (적극적으로 사용하지 마세요)| 기호 | 효과 |
|---|---|
--no-prescan | 전체 스캔을 생략 |
--prescan-ignore-fatal 또는 --ignore-fatal 스캔 실행, 보고서 출력, 차단하지 않음 build prescan) | 경고를 치명적인 것으로 처리 (CI) |
--fail-on-warnings | 그리고 |
--no-prescan 숨기거나 우회 --prescan-ignore-fatal 모두 남은 검사들을 숨기거나 우회하세요. 한 규칙에만 반대되는 경우에는 한 개의 규칙에 대한 override를 사용하세요. and
Catalog 확인
Catalog 확인 섹션정확한 id를 사용하세요 --prescan-skip / --prescan-warn.
점진적 적용 정보만 제공할 때까지 찾은 결과는 2026-08-14그 다음으로 빌드 차단을 적용할 수 있습니다.
| ID | 지원 플랫폼 | 체크하는 내용 | 점진적 적용 |
|---|---|---|---|
shared/apikey-permission | iOS, 안드로이드 | API 키는 네이티브 빌드를 요청할 수 있습니다. | — |
shared/app-exists | iOS, 안드로이드 | API 키가 앱 아이디를 볼 수 있으며 존재합니다. | — |
shared/credentials-saved | iOS, 안드로이드 | 필수 iOS/안드로이드 인증 정보는 로컬로 저장됩니다. | — |
shared/cap-sync-stale | iOS, 안드로이드 | 웹 자산이 빌드되고 Capacitor 플러그인이 동기화됩니다. | — |
shared/node-linker-layout | iOS, 안드로이드 | node_modules 레이아웃은 Capacitor 네이티브 경로와 호환됩니다. | — |
shared/bundle-id-consistency | iOS, 안드로이드 | Capacitor 앱 아이디는 네이티브 번들 아이디 / applicationId와 일치합니다. | — |
iOS
iOS 섹션| Id | 플랫폼 | 체크하는 항목 | 점진적 적용 |
|---|---|---|---|
ios/p12-opens | iOS | iOS .p12 파일이 제공된 비밀번호로 열립니다 | — |
ios/p12-expiry | iOS | iOS 인증서가 만료되지 않았습니다 | — |
ios/profile-expiry | iOS | 프로비전 프로파일이 만료되지 않았습니다 | — |
ios/profile-bundle-match | iOS | 앱의 프로비저닝 프로파일 아이디와 일치합니다. | — |
ios/profile-type-vs-mode | iOS | 앱 스토어 / 어드혹 모드와 일치하는 프로파일 타입입니다. | — |
ios/cert-profile-pairing | iOS | 프로비저닝 프로파일에 인증서가 포함되어 있습니다. | — |
ios/targets-covered | iOS | 모든 iOS 대상에 프로비저닝 프로파일이 있습니다. | — |
ios/infoplist-sanity | iOS | Info.plist에 필수 버전 / 자격 증명 키가 있습니다. | — |
ios/asc-key-valid | iOS | 앱 스토어 연결 API 키 필드는 유효합니다. | — |
ios/asc-key-access | iOS | ASC API 키는 앱 (remote) 에 접근할 수 있습니다. | — |
ios/plist-bundle-id-format | iOS | CFBundleIdentifier 형식은 유효합니다. | 네 |
ios/plist-version-short-format | iOS | CFBundleShortVersionString 형식은 유효합니다. | 네 |
ios/plist-version-build-format | iOS | CFBundleVersion 형식은 유효합니다. | 네 |
ios/plist-encryption-compliance | iOS | ITSAppUsesNonExemptEncryption이 선언되었습니다. | 네 |
ios/plist-ats-arbitrary-loads | ios | NSAllowsArbitraryLoads는 프로덕션에서 비활성화되어 있습니다. | 네 |
ios/plist-launch-storyboard | ios | 시작 화면이 선언되었습니다. | 네 |
ios/plist-orientations-multitasking | ios | 방향/멀티태스킹 설정이 일관되게 구성되었습니다. | 네 |
ios/plist-orientations-present | ios | UISupportedInterfaceOrientations이 선언되었습니다. | 네 |
ios/plist-display-name | ios | 표시 이름이 설정되었습니다. | 네 |
ios/plist-background-modes-sanity | ios | UIBackgroundModes의 값이 유효합니다. | 네 |
ios/xcode-deployment-target-capacitor | ios | iOS 배포 대상이 Capacitor 요구 사항을 충족합니다. | 네 |
ios/xcode-signing-team | ios | __CAPGO_KEEP_0__ | __CAPGO_KEEP_1__ |
ios/xcode-bundle-id-mismatch-across-configs | __CAPGO_KEEP_2__ | __CAPGO_KEEP_3__ | __CAPGO_KEEP_4__ |
ios/xcode-enable-bitcode-leftover | __CAPGO_KEEP_5__ | __CAPGO_KEEP_6__ | __CAPGO_KEEP_7__ |
ios/xcode-swift-version-sanity | __CAPGO_KEEP_8__ | __CAPGO_KEEP_9__ | __CAPGO_KEEP_10__ |
ios/xcode-no-app-target | __CAPGO_KEEP_11__ | Xcode 프로젝트에 애플리케이션 목표가 있습니다. | 네 |
ios/xcode-multiple-app-targets | ios | 여러 앱 목표가 의도적으로 처리됩니다. | 네 |
ios/entitlements-vs-profile-capability | ios | 권한이 프로파일 기능과 일치합니다. | 네 |
ios/entitlements-aps-environment-vs-mode | ios | aps-environment가 배포 모드와 일치합니다. | 네 |
ios/entitlements-associated-domains-format | ios | 관련 도메인 형식이 유효합니다. | 네 |
ios/entitlements-app-groups-format | ios | App Groups 형식이 유효합니다. | 네 |
ios/capacitor-server-url-shipped | ios | server.url은 스토어 빌드용으로 live-reload / remote shell 엔드포인트로 남겨지지 않습니다. | 네 |
ios/capacitor-server-cleartext | ios | server.cleartext는 프로덕션에서 사용되지 않습니다. | 네 |
ios/capacitor-allow-navigation-wildcard | ios | 서버. allowNavigation은 완전한 와일드카드가 아닙니다 | 네 |
ios/pods-not-installed | iOS | CocoaPods Pods / workspace는 Pods를 사용할 때 존재합니다 | 네 |
ios/pods-lock-missing | iOS | Podfile.lock은 pod 버전을 고정합니다 | 네 |
ios/pods-capacitor-missing | iOS | Podfile은 Capacitor을 연결합니다 | 네 |
ios/spm-package-resolved-missing | iOS | SPM 패키지. 해결 된 것이 있습니다. | 예 |
ios/spm-capacitor-dependency-missing | ios | Package.swift에서 Capacitor이 선언됩니다. | 예 |
ios/appicon-empty-or-placeholder | ios | AppIcon.appiconset이 존재하고 비어있지 않습니다. | 예 |
ios/appicon-referenced-file-missing | ios | Contents.json 아이콘 파일이 디스크에 존재합니다. | 예 |
ios/appicon-marketing-missing | ios | 1024×1024 마케팅 아이콘 존재 | 예 |
ios/spm-deployment-target-consistency | iOS | SPM 배포 대상이 일관적입니다 | 예 |
안드로이드
제목: 안드로이드| ID | 플랫폼 | 체크하는 것 | 점진적 강제 |
|---|---|---|---|
android/keystore-opens | 안드로이드 | 안드로이드 키스토어는 제공된 비밀번호로 열립니다 | — |
android/keystore-expiry | 안드로이드 | 안드로이드 서명 인증서는 만료되지 않았습니다 | — |
android/cordova-vars-present | 안드로이드 | cordova.variables.gradle은 cap sync 후에 존재합니다 | — |
android/gradle-props-heuristics | 안드로이드 | gradle.properties는 일반적인 빌드 중단을 위한 일반적인 빌드 브레이크를 위한 heuristics입니다 | — |
android/play-sa-json | 안드로이드 | 구글 플레이 서비스 계정 JSON이 구성된 경우 존재합니다 | — |
android/flavor-exists | 안드로이드 | 요청된 제품 맛집이 존재합니다 | — |
android/agp8-package-attr | 안드로이드 | AGP 8+에서 Manifest 패키지 속성이 제거되었습니다. | — |
android/manifest-well-formed | 안드로이드 | AndroidManifest.xml은 다음과 같이 분석됩니다. | — |
android/manifest-tag-typo | 안드로이드 | 일반적인 manifest 태그 오류 | — |
android/manifest-namespace-uri | 안드로이드 | xmlns:android namespace URI는 올바릅니다. | — |
android/manifest-missing-prefix | 안드로이드 | Android 속성은 android: 접두사를 사용합니다. | — |
android/manifest-exported-missing | 안드로이드 | android:exported는 필요한 경우 설정됩니다. | — |
android/manifest-multiple-uses-sdk | 안드로이드 | 단 하나의 sdk 사용 | — |
android/manifest-duplicate-component | 안드로이드 | 중복된 컴포넌트가 없습니다 | — |
android/manifest-unique-permission | 안드로이드 | 사용자 정의 권한은 고유합니다 | — |
android/manifest-hardcoded-debuggable | 안드로이드 | debuggable=true가 배포되지 않습니다 | — |
android/manifest-mock-location | 안드로이드 | ACCESS_MOCK_LOCATION이 배포되지 않습니다 | — |
android/manifest-exported-unprotected | 안드로이드 | 내보낸 컴포넌트는 보호됩니다 | — |
android/manifest-query-all-packages | 안드로이드 | QUERY_ALL_PACKAGES justification | — |
android/manifest-deeplink-valid | 안드로이드 | Deep Link intent 필터가 유효합니다 | — |
android/applicationid-present | 안드로이드 | applicationId는 app/build.gradle에 선언되어 있습니다 | — |
android/capacitor-build-gradle-applied | 안드로이드 | capacitor.build.gradle이 적용되었을 때 존재합니다 | — |
android/gradle-wrapper-present | 안드로이드 | Gradle wrapper 파일이 존재합니다 | — |
android/flavor-dimensions | 안드로이드 | 플레이버드 차원은 플레버드가 존재할 때 선언됩니다 | — |
android/google-services-file | 안드로이드 | 구글 서비스 JSON 파일이 플러그인 적용 시 존재합니다. | — |
android/local-properties-committed | 안드로이드 | local.properties 파일에 비밀을 포함하지 않습니다. | — |
android/sdk-floors | 안드로이드 | SDK 미니/컴파일/타겟 층이 유효합니다. | — |
android/target-sdk-play | 안드로이드 | 타겟 SDK가 플레이 요구 사항을 충족합니다. | — |
android/min-sdk-capacitor | 안드로이드 | 미니 SDK가 Capacitor 요구 사항을 충족합니다. | — |
android/version-fields | 안드로이드 | 버전 코드/버전 이름이 존재합니다. | — |
android/play-sa-access | 안드로이드 | 서비스 계정은 앱에 접근할 수 있습니다 (remote) | — |
예시: remote Next.js / server.url shell
예시: remote Next.js / server.url shell생산 환경에서 네이티브 쉘을 로드하는 것을 지원하는 패턴입니다. server.url Capacitor 패턴은 지원되는 패턴입니다. Prescan 플래그를 사용하여 ios/capacitor-server-url-shipped 이것은 종종 라이브 리로드의 잔여물입니다.
다른 체크를 비활성화하지 않고도 이를 인식하세요:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shipped비밀을 유지하고 경고로 유지하세요:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-warn ios/capacitor-server-url-shipped