ビルドのプレースキャンチェック

コピー用のプロンプト

Capgo Cloud Build がプロジェクトをアップロードする前に、CLI は プレスキャン ローカルで資格情報、プロジェクト、ストア設定の問題をキャッチする

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

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は、明確なエラーと共に速やかに失敗します。

グローバルエスケープ(あまり使用しないでください)

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

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

カタログの確認

正確なIDを使用します。 --prescan-skip / --prescan-warn.

段階的な強制 「情報のみ」であることを意味します。検出は、ビルドをブロックするまで 2026-08-14共有

ID

チェックするもの	段階的な強制	translations	translations
`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 / applicationId と一致します	—

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	プロファイルのタイプがアプリストア/ADホックモードと一致しています	—
`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__ is declared	Yes
`ios/plist-ats-arbitrary-loads`	ios	__CAPGO_KEEP_0__ is not enabled for production	Yes
`ios/plist-launch-storyboard`	ios	__CAPGO_KEEP_0__ is declared	Yes
`ios/plist-orientations-multitasking`	ios	Orientation / multitasking settings are consistent	Yes
`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	特権はプロファイル機能と一致しています。	はい
`ios/entitlements-aps-environment-vs-mode`	iOS	aps環境は配布モードと一致しています。	はい
`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	サーバー.allowNavigation は一律のワイルドカードではありません。	はい
`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`	__CAPGO_KEEP_0__	Android の署名証明書は有効期限内です	—
`android/cordova-vars-present`	__CAPGO_KEEP_0__	cordova.variables.gradle は cap sync 後に存在します	—
`android/gradle-props-heuristics`	__CAPGO_KEEP_0__	Gradle プロパティのヒューリスティクスは一般的なビルドの問題を解決します	—
`android/play-sa-json`	__CAPGO_KEEP_0__	Play サービスアカウントの JSON は設定された場合に存在します	—
`android/flavor-exists`	__CAPGO_KEEP_0__	要求された製品フラバーが存在します	—
`android/agp8-package-attr`	__CAPGO_KEEP_0__	Manifest package=属性はAGP 8+で削除されました	—
`android/manifest-well-formed`	android	AndroidManifest.xmlはパースされます	—
`android/manifest-tag-typo`	android	共通のマニフェストタグのタイプミス	—
`android/manifest-namespace-uri`	android	xmlns:androidの名前空間URIは正しい	—
`android/manifest-missing-prefix`	android	Android属性はandroid:プレフィックスを使用します	—
`android/manifest-exported-missing`	android	android:exportedは必要な場合に設定されます	—
`android/manifest-multiple-uses-sdk`	android	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のIntentフィルタは有効なようです	—
`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	min/compile/target SDK フロアの値は有効です。	—
`android/target-sdk-play`	Android	ターゲット SDK は Play の要件を満たしています。	—
`android/min-sdk-capacitor`	Android	minSdk は Capacitor の要件を満たしています。	—
`android/version-fields`	Android	バージョンコード / バージョン名が存在します。	—
`android/play-sa-access`	Android	サービスアカウントはアプリにアクセスできます (remote)	—

例: 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

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

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

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