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

コピー可能

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は、エラーが明確に表示されるまで、速やかに失敗します。

globalEscapesDescription

フラグ	効果
`--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	プラットフォーム	チェックするもの	段階的に強制
`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	非特例暗号化を使用しているアプリが宣言されている	はい
`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	署名チームの設定が完了しました	はい
`ios/xcode-bundle-id-mismatch-across-configs`	iOS	Xcodeの設定間でBundle IDが一貫している	はい
`ios/xcode-enable-bitcode-leftover`	iOS	ENABLE_BITCODE残りの設定が削除されました	はい
`ios/xcode-swift-version-sanity`	iOS	Swiftのバージョン設定が正常です	はい
`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環境は配布モードと一致しています。	はい
`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	CapacitorをPodfileでワイヤーします。	はい
`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__	AGP 8+でManifestパッケージ属性が削除されました。	—
`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 インテントフィルタが有効なようです	—
`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-services.json がプラグイン適用時に存在します	—
`android/local-properties-committed`	Android	local.properties に秘密情報が含まれていることはコミットされません	—
`android/sdk-floors`	Android	SDK の最小/コンパイル/ターゲットフロアが正常に表示されます	—
`android/target-sdk-play`	Android	ターゲットSDKがPlayの要件を満たしています	—
`android/min-sdk-capacitor`	Android	minSdkがCapacitorの要件を満たしています	—
`android/version-fields`	Android	versionCode / versionName が存在しています	—
`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__ ビルドのリファレンス