メインコンテンツへスキップ

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

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)スキャンを実行し、レポートを出力し、ブロックしない
--fail-on-warnings警告を致命的エラーとして扱う (CI)

--no-prescan と --prescan-ignore-fatal 非表示またはバイパス すべて 残りのチェック。1つのルールだけに納得できない場合は、チェックごとのオーバーライドを使ってください。

正確な id を以下で使用 --prescan-skip / --prescan-warn.

段階的な適用 は、〜までその検出結果が情報提供のみであることを意味します 2026-08-14、ビルドをブロックできます。

IDプラットフォームチェック内容段階的な適用
shared/apikey-permissioniOS, AndroidAPI キーは Native Build をリクエストできます—
shared/app-existsiOS, AndroidApp ID が存在し、API キーから参照可能であること—
shared/credentials-savediOS, Android必要な iOS/Android 認証情報をローカルに保存しました—
shared/cap-sync-staleiOS, AndroidWeb アセットをビルドし、Capacitor プラグインを同期しました—
shared/node-linker-layoutiOS, Androidnode_modules の構成が Capacitor のネイティブパスに対応しています—
shared/bundle-id-consistencyiOS, AndroidCapacitor の appId がネイティブの bundle id / applicationId と一致しています—
IDプラットフォームチェック内容段階的な適用
ios/p12-opensiOSiOS .p12 が指定されたパスワードで開けること—
ios/p12-expiryiOSiOS 署名証明書が期限切れでないこと—
ios/profile-expiryiOSプロビジョニングプロファイルが期限切れでないこと—
ios/profile-bundle-matchiOSプロビジョニングプロファイルの bundle ID がアプリと一致すること—
ios/profile-type-vs-modeiOSプロファイルタイプが app_store / ad_hoc モードと一致すること—
ios/cert-profile-pairingiOS証明書がプロビジョニングプロファイルに埋め込まれています—
ios/targets-coverediOSすべてのiOSターゲットにプロビジョニングプロファイルがあります—
ios/infoplist-sanityiOSInfo.plistに必須のversion / identityキーがあります—
ios/asc-key-validiOSApp Store ConnectのAPIキー項目は有効に見えます—
ios/asc-key-accessiOSASCのAPIキーでアプリにアクセスできます(リモート)—
ios/plist-bundle-id-formatiOSCFBundleIdentifierの形式は有効ですはい
ios/plist-version-short-formatiOSCFBundleShortVersionString の形式は有効ですはい
ios/plist-version-build-formatiOSCFBundleVersion の形式は有効ですはい
ios/plist-encryption-complianceiOSITSAppUsesNonExemptEncryption が宣言されていますはい
ios/plist-ats-arbitrary-loadsiOS本番環境では NSAllowsArbitraryLoads が有効になっていませんはい
ios/plist-launch-storyboardiOS起動画面が宣言されていますはい
ios/plist-orientations-multitaskingiOS向き / マルチタスク設定が一致していますはい
ios/plist-orientations-presentiOSUISupportedInterfaceOrientations が宣言されていますはい
ios/plist-display-nameiOS表示名が設定されていますはい
ios/plist-background-modes-sanityiOSUIBackgroundModes の値は有効ですはい
ios/plist-scene-lifecycle-xcode27iOSXcode 27 以降でビルドする場合、アプリは UIScene ライフサイクルを採用しています(iOS 27 SDK による必須要件)はい
ios/xcode-deployment-target-capacitoriOSiOS デプロイメントターゲットが Capacitor の要件を満たしていますはい
ios/xcode-signing-teamiOS署名チームが設定されていますはい
ios/xcode-bundle-id-mismatch-across-configsiOSXcode 設定間で Bundle ID が一致しているはい
ios/xcode-enable-bitcode-leftoveriOSENABLE_BITCODE の残骸が削除されているはい
ios/xcode-swift-version-sanityiOSSwift バージョン設定が妥当であるはい
ios/xcode-no-app-targetiOSXcode プロジェクトにアプリケーションターゲットがあるはい
ios/xcode-multiple-app-targetsiOS複数のアプリターゲットが意図的に処理されていますはい
ios/entitlements-vs-profile-capabilityiOSEntitlementsがプロファイルの機能と一致していますはい
ios/entitlements-aps-environment-vs-modeiOSaps-environmentが配布モードと一致していますはい
ios/entitlements-associated-domains-formatiOSAssociated Domainsの形式は有効ですはい
ios/entitlements-app-groups-formatiOSApp Groupsの形式が有効ですはい
ios/capacitor-server-url-shippediOSserver.urlがストアビルド用のlive-reload / remote shellエンドポイントのまま残っていないはい
ios/capacitor-server-cleartextiOS本番環境でserver.cleartextが有効になっていないはい
ios/capacitor-allow-navigation-wildcardiOSserver.allowNavigationが全面的なワイルドカードになっていないはい
ios/pods-not-installediOSPods使用時にCocoaPodsのPods / workspaceが存在するはい
ios/pods-lock-missingiOSPodfile.lockでPodのバージョンを固定はい
ios/pods-capacitor-missingiOSPodfileでCapacitorを組み込むはい
ios/spm-package-resolved-missingiOSSPMのPackage.resolvedが存在するはい
ios/spm-capacitor-dependency-missingiOSPackage.swift が Capacitor を宣言しているはい
ios/appicon-empty-or-placeholderiOSAppIcon.appiconset が存在し、空でないはい
ios/appicon-referenced-file-missingiOSContents.json のアイコンファイルがディスク上に存在するはい
ios/appicon-marketing-missingiOS1024×1024 のマーケティング用アイコンが存在するはい
ios/spm-deployment-target-consistencyiOSSPMのdeployment targetが一致していますはい
IDプラットフォームチェック内容段階的な適用
android/keystore-opensAndroidAndroid keystoreが指定されたパスワードで開けます—
android/keystore-expiryAndroidAndroidの署名証明書が期限切れになっていません—
android/cordova-vars-presentAndroidcap sync 後に cordova.variables.gradle が存在すること—
android/gradle-props-heuristicsAndroid一般的な build 失敗に対する gradle.properties のヒューリスティック—
android/play-sa-jsonAndroid設定されている場合、Play の service-account JSON が存在すること—
android/flavor-existsAndroidリクエストされた product flavor が存在すること—
android/agp8-package-attrAndroidAGP 8+ 向けに Manifest の package= 属性を削除—
android/manifest-well-formedAndroidAndroidManifest.xml がパースできる—
android/manifest-tag-typoAndroidマニフェストタグのよくあるタイポ—
android/manifest-namespace-uriAndroidxmlns:android 名前空間 URI が正しい—
android/manifest-missing-prefixAndroidAndroid 属性に android: プレフィックスを使用—
android/manifest-exported-missingAndroid必要な箇所に android:exported が設定済み—
android/manifest-multiple-uses-sdkAndroiduses-sdk 要素は1つだけ—
android/manifest-duplicate-componentAndroidコンポーネントの重複なし—
android/manifest-unique-permissionAndroidカスタム権限は一意—
android/manifest-hardcoded-debuggableAndroiddebuggable=true は含まれません—
android/manifest-mock-locationAndroidACCESS_MOCK_LOCATION は含まれません—
android/manifest-exported-unprotectedAndroidエクスポートされたコンポーネントは保護済み—
android/manifest-query-all-packagesAndroidQUERY_ALL_PACKAGES の正当性—
android/manifest-deeplink-validAndroidDeeplinkのintent-filterは有効です—
android/applicationid-presentAndroidapp/build.gradleにapplicationIdが宣言されています—
android/capacitor-build-gradle-appliedAndroid適用時にcapacitor.build.gradleが存在します—
android/gradle-wrapper-presentAndroidGradle wrapperファイルが存在します—
android/flavor-dimensionsAndroidflavorが存在する場合、Flavor dimensionsが宣言されています—
android/google-services-fileAndroidプラグイン適用時にgoogle-services.jsonが存在します—
android/local-properties-committedAndroidlocal.properties がシークレット付きでコミットされていない—
android/sdk-floorsAndroidmin/compile/target SDK の下限値は妥当です—
android/target-sdk-playAndroidtargetSdk が Play の要件を満たしています—
android/min-sdk-capacitorAndroidminSdk が Capacitor の要件を満たしています—
android/version-fieldsAndroidversionCode / versionName が設定されています—
android/play-sa-accessAndroidPlay サービスアカウントがアプリにアクセスできます (remote)—

本番環境をロードするネイティブシェルを配信することは、 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