ビルドの前スキャンチェック

Before Capgo Cloud Build uploads your project, the CLI runs a プリアンサン ローカルで資格情報、プロジェクト、ストア設定の問題をキャッチします。

また、独立して実行されます:

npx @capgo/cli@latest build prescan <appId> --platform ios

チェックは 80 個々のチェックIDを無視するのを優先してください。全体のスキャンをオフにするのではなく。

特定のチェックを無視する

# 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-separated
npx @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

未知のチェックIDは、エラーが明確に表示されるまで、速やかに失敗します。

ヒント

必要 @capgo/cli@latest チェックごとにオーバーライドが可能です。そうすることで、他のチェックもビルドを保護することができます。 --prescan-skip / --prescan-warn グローバルエスケープ (あまり使用しないでください)

__CAPGO_KEEP_0__

フラグ	効果
--no-prescan	全体のスキャンをスキップ
--prescan-ignore-fatal または --ignore-fatal 上で build prescan)	スキャンを実行、レポートを出力、ブロックしない
--fail-on-warnings	警告を致命的なものとして扱う（CI)

--no-prescan そして --prescan-ignore-fatal 非表示または回避 すべて 残りのチェック。1つのルールに異議を唱える場合のみ、チェックごとにオーバーライドを使用してください。

カタログを確認

正確なIDを使用 --prescan-skip / --prescan-warn.

段階的に強制 情報のみの検出であるため、建物をブロックすることはありません。 2026-08-14次に、建物をブロックできます。

共有

ID	プラットフォーム	チェックするもの	段階的に強制
shared/apikey-permission	iOS、Android	API キーはネイティブビルドを要求できます	—
shared/app-exists	iOS、Android	API キーがアプリIDを認識し、表示できます	—
shared/credentials-saved	iOS、Android	必要なiOS/Androidの認証情報はローカルに保存されます	—
shared/cap-sync-stale	iOS、Android	Webアセットがビルドされ、Capacitor プラグインが同期されます	—
shared/node-linker-layout	iOS、Android	node_modulesレイアウトはCapacitor ネイティブパスと互換性があります	—
shared/bundle-id-consistency	iOS、Android	Capacitor アプリIDはネイティブバンドルID/アプリケーションIDと一致します	—

iOS

ID	プラットフォーム	チェックするもの	段階的に強制
ios/p12-opens	iOS	iOSの.p12ファイルは、指定されたパスワードで開きます。	—
ios/p12-expiry	iOS	iOSの署名証明書は期限切れではありません。	—
ios/profile-expiry	iOS	プロビジョニングプロファイルは期限切れではありません。	—
ios/profile-bundle-match	iOS	アプリケーションプロビジョニングプロファイルのバンドルIDがアプリと一致しています	—
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	App Store Connect API キーフィールドが有効です	—
ios/asc-key-access	iOS	ASC API キーでアプリにアクセスできます (リモート)	—
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	__CAPGO_KEEP_0__は非特免暗号化を使用していることを宣言しています。	はい
ios/plist-ats-arbitrary-loads	ios	__CAPGO_KEEP_0__の生産用途では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	サインインチームが設定されています	はい
ios/xcode-bundle-id-mismatch-across-configs	iOS	Xcodeの設定間でバンドルIDが一貫しています	はい
ios/xcode-enable-bitcode-leftover	iOS	ENABLE_BITCODE残りが削除されました	はい
ios/xcode-swift-version-sanity	iOS	Swiftのバージョン設定が正常です	はい
ios/xcode-no-app-target	iOS	Xcodeプロジェクトにはアプリケーション目標があります。	はい
ios/xcode-multiple-app-targets	ios	複数のアプリケーション目標は意図的に処理されます。	はい
ios/entitlements-vs-profile-capability	ios	Entitlementsはプロファイルの機能と一致しています。	はい
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はストアビルド用にライブリロード/リモートシェルエンドポイントとして残しておけない。	はい。
ios/capacitor-server-cleartext	ios	server.cleartextはプロダクション用に有効になっていません。	はい。
ios/capacitor-allow-navigation-wildcard	ios	サーバーが移動を許可することは、全面的なワイルドカードではありません。	はい
ios/pods-not-installed	iOS	CocoaPodsのPods / ワークスペースは、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のデプロイ先が一貫しています	はい

Android

ID	プラットフォーム	チェックするもの	段階的強制
android/keystore-opens	Android	Android キーストアは提供されたパスワードで開きます。	—
android/keystore-expiry	android	Android の署名証明書は期限切れではありません。	—
android/cordova-vars-present	android	cordova.variables.gradle は cap sync 後に存在します。	—
android/gradle-props-heuristics	android	Gradle プロパティのヒューリスティクスは一般的なビルドの問題を解決します。	—
android/play-sa-json	android	Play サービスアカウントの JSON は設定された場合に存在します。	—
android/flavor-exists	android	要求された製品フラバーが存在します。	—
android/agp8-package-attr	android	Manifest package= attribute removed for AGP 8+	—
android/manifest-well-formed	アンドロイド	AndroidManifest.xml parses	—
android/manifest-tag-typo	アンドロイド	共通のマニフェストタグのタイプミス	—
android/manifest-namespace-uri	アンドロイド	xmlns:android namespace URI is correct	—
android/manifest-missing-prefix	アンドロイド	Android attributes use the android: prefix	—
android/manifest-exported-missing	アンドロイド	android:exported is set where required	—
android/manifest-multiple-uses-sdk	アンドロイド	1つのsdk要素のみ	—
android/manifest-duplicate-component	android	コンポーネントの重複は許可されません	—
android/manifest-unique-permission	android	カスタムの権限は一意です	—
android/manifest-hardcoded-debuggable	android	debuggable=trueは配信されません	—
android/manifest-mock-location	android	ACCESS_MOCK_LOCATIONは配信されません	—
android/manifest-exported-unprotected	android	エクスポートされたコンポーネントは保護されています	—
android/manifest-query-all-packages	android	QUERY_ALL_PACKAGES 理由	—
android/manifest-deeplink-valid	アンドロイド	Deep Link インテントフィルタが有効	—
android/applicationid-present	アンドロイド	アプリケーションIDはapp/build.gradleで宣言されている	—
android/capacitor-build-gradle-applied	アンドロイド	capacitor.build.gradleが適用されたときに存在する	—
android/gradle-wrapper-present	アンドロイド	Gradleワッパーファイルが存在する	—
android/flavor-dimensions	アンドロイド	フラビアーダイメンションが存在する	—
android/google-services-file	アンドロイド	Google サービス JSON がプラグイン適用時に存在します。	—
android/local-properties-committed	Android	ローカル プロパティはシークレットが含まれないようにコミットされます。	—
android/sdk-floors	Android	最小/コンパイル/ターゲット SDK フロアが有効です。	—
android/target-sdk-play	Android	ターゲット SDK が Play の要件を満たしています。	—
android/min-sdk-capacitor	Android	最小 SDK が Capacitor の要件を満たしています。	—
android/version-fields	Android	バージョンコード / バージョン名が存在します。	—
android/play-sa-access	Android	サービスアカウントはアプリにアクセスできます (remote)	—

例: remote Next.js / server.url shell

生産用のシェルをロードするためにネイティブシェルを配信することはサポートされています server.url Capacitor パターンは、しばしばライブリロードの残骸です。 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

関連

はじめに 最初のCapgo Cloud Buildを作成してください。

トラブルシューティング コンテキスト: サポート / プレミアムサポートページまたはフッターのサポートセクション。役割: セクションまたはページヘッダー。見られる場所: サポートポリシーページ。メッセージキー `support_policy_troubleshooting_title` (サポートポリシー トラブルシューティング タイトル)。

CLI build reference __CAPGO_KEEP_0__ ビルドのリファレンス