빌드 전처리 검사
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 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알 수 없는 체크 아이디는 빠른 오류와 함께 실패합니다.
__CAPGO_KEEP_0__
세션 제목: 전역 탈출 (적극적으로 사용하지 마세요)| 기호 | 효과 |
|---|---|
--no-prescan | 전체 스캔을 생략합니다 |
--prescan-ignore-fatal 또는 --ignore-fatal 스캔을 실행하고, 보고서를 출력하고, 차단하지 마세요 build prescan) | 경고를 치명적인 오류로 처리합니다 (CI) |
--fail-on-warnings | 그리고 |
--no-prescan 숨기거나 생략 --prescan-ignore-fatal 모두 남은 검사들을 숨기거나 생략합니다. 단일 규칙에 대해 반대하는 경우에는 대신 per-check override를 사용하세요. 스캔을 실행하고, 보고서를 출력하고, 차단하지 마세요
Catalog 확인
Catalog 확인 섹션정확한 id를 사용하세요 --prescan-skip / --prescan-warn.
점진적 강제 의미는 정보만 제공할 때까지 2026-08-14, 그 후에 빌드 차단이 가능합니다.
| id | 플랫폼 | 검사하는 내용 | Gradual enforce |
|---|---|---|---|
shared/apikey-permission | iOS, 안드로이드 | API 키는 네이티브 빌드를 요청할 수 있습니다. | — |
shared/app-exists | iOS, 안드로이드 | API 키가 앱 아이디를 볼 수 있는지 확인합니다. | — |
shared/credentials-saved | iOS, 안드로이드 | iOS/Android 인증 정보가 저장되어 있습니다. | — |
shared/cap-sync-stale | iOS, 안드로이드 | 웹 자산이 빌드되고 Capacitor 플러그인이 동기화됩니다. | — |
shared/node-linker-layout | iOS, 안드로이드 | node_modules 레이아웃은 Capacitor 네이티브 경로와 호환됩니다. | — |
shared/bundle-id-consistency | iOS, 안드로이드 | Capacitor 앱 아이디는 네이티브 번들 아이디와 일치합니다. | — |
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 키는 앱 (원격) 에 접근할 수 있습니다. | — |
ios/plist-bundle-id-format | iOS | CFBundleIdentifier 형식은 유효합니다. | Yes |
ios/plist-version-short-format | iOS | CFBundleShortVersionString 형식은 유효합니다. | Yes |
ios/plist-version-build-format | iOS | CFBundleVersion 형식은 유효합니다. | Yes |
ios/plist-encryption-compliance | iOS | __CAPGO_KEEP_0__ | __CAPGO_KEEP_1__ |
ios/plist-ats-arbitrary-loads | __CAPGO_KEEP_2__ | __CAPGO_KEEP_3__ | __CAPGO_KEEP_4__ |
ios/plist-launch-storyboard | __CAPGO_KEEP_5__ | __CAPGO_KEEP_6__ | __CAPGO_KEEP_7__ |
ios/plist-orientations-multitasking | __CAPGO_KEEP_8__ | __CAPGO_KEEP_9__ | __CAPGO_KEEP_10__ |
ios/plist-orientations-present | __CAPGO_KEEP_11__ | 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_0__ |
ios/xcode-bundle-id-mismatch-across-configs | iOS | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ |
ios/xcode-enable-bitcode-leftover | iOS | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ |
ios/xcode-swift-version-sanity | iOS | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ |
ios/xcode-no-app-target | iOS | __CAPGO_KEEP_0__ 프로젝트는 애플리케이션 목표를 가지고 있습니다. | 네 |
ios/xcode-multiple-app-targets | ios | __CAPGO_KEEP_0__ 프로젝트는 여러 앱 목표를 의도적으로 처리합니다. | 네 |
ios/entitlements-vs-profile-capability | ios | __CAPGO_KEEP_0__ 프로젝트의 권한은 프로파일 기능과 일치합니다. | 네 |
ios/entitlements-aps-environment-vs-mode | ios | __CAPGO_KEEP_0__ 프로젝트의 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은 전면적인 wildcard가 아닙니다. | 네 |
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 패키지.resolved가 존재합니다. | 예 |
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 | 안드로이드 | __CAPGO_KEEP_0__ 키스토어가 제공된 비밀번호로 열립니다. | — |
android/keystore-expiry | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ 인증서가 만료되지 않았습니다. | — |
android/cordova-vars-present | __CAPGO_KEEP_0__ | cap sync 후 cordova.variables.gradle이 존재합니다. | — |
android/gradle-props-heuristics | __CAPGO_KEEP_0__ | gradle.properties에서 일반적인 빌드 중단을 위한 가이드라인이 있습니다. | — |
android/play-sa-json | __CAPGO_KEEP_0__ | 구성된 경우 Play 서비스 계정 JSON이 존재합니다. | — |
android/flavor-exists | __CAPGO_KEEP_0__ | 요청된 제품 맛집이 존재합니다. | — |
android/agp8-package-attr | __CAPGO_KEEP_0__ | 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 제목생산 환경에서 로드하는 네이티브 쉘을 배송하는 것은 지원되는 __CAPGO_KEEP_0__ 패턴입니다. server.url is a supported Capacitor pattern. Prescan flags 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