ビルドのプリスキャンチェック
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
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-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不明なチェック 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-permission | iOS, Android | API キーは Native Build をリクエストできます | — |
shared/app-exists | iOS, Android | App ID が存在し、API キーから参照可能であること | — |
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 の appId がネイティブの bundle id / applicationId と一致しています | — |
iOSと
「iOS」セクション| ID | プラットフォーム | チェック内容 | 段階的な適用 |
|---|---|---|---|
ios/p12-opens | iOS | iOS .p12 が指定されたパスワードで開けること | — |
ios/p12-expiry | iOS | iOS 署名証明書が期限切れでないこと | — |
ios/profile-expiry | iOS | プロビジョニングプロファイルが期限切れでないこと | — |
ios/profile-bundle-match | iOS | プロビジョニングプロファイルの bundle ID がアプリと一致すること | — |
ios/profile-type-vs-mode | iOS | プロファイルタイプが app_store / ad_hoc モードと一致すること | — |
ios/cert-profile-pairing | iOS | 証明書がプロビジョニングプロファイルに埋め込まれています | — |
ios/targets-covered | iOS | すべてのiOSターゲットにプロビジョニングプロファイルがあります | — |
ios/infoplist-sanity | iOS | Info.plistに必須のversion / identityキーがあります | — |
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 | ITSAppUsesNonExemptEncryption が宣言されています | はい |
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/plist-scene-lifecycle-xcode27 | iOS | Xcode 27 以降でビルドする場合、アプリは UIScene ライフサイクルを採用しています(iOS 27 SDK による必須要件) | はい |
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 | 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 | Associated Domainsの形式は有効です | はい |
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 | server.allowNavigationが全面的なワイルドカードになっていない | はい |
ios/pods-not-installed | iOS | Pods使用時にCocoaPodsのPods / workspaceが存在する | はい |
ios/pods-lock-missing | iOS | Podfile.lockでPodのバージョンを固定 | はい |
ios/pods-capacitor-missing | iOS | PodfileでCapacitorを組み込む | はい |
ios/spm-package-resolved-missing | iOS | SPMのPackage.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のdeployment targetが一致しています | はい |
Androidでは
「Android」セクション| ID | プラットフォーム | チェック内容 | 段階的な適用 |
|---|---|---|---|
android/keystore-opens | Android | Android keystoreが指定されたパスワードで開けます | — |
android/keystore-expiry | Android | Androidの署名証明書が期限切れになっていません | — |
android/cordova-vars-present | Android | cap sync 後に cordova.variables.gradle が存在すること | — |
android/gradle-props-heuristics | Android | 一般的な build 失敗に対する gradle.properties のヒューリスティック | — |
android/play-sa-json | Android | 設定されている場合、Play の service-account JSON が存在すること | — |
android/flavor-exists | Android | リクエストされた product flavor が存在すること | — |
android/agp8-package-attr | Android | AGP 8+ 向けに Manifest の package= 属性を削除 | — |
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 | uses-sdk 要素は1つだけ | — |
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 | Android | Deeplinkのintent-filterは有効です | — |
android/applicationid-present | Android | app/build.gradleにapplicationIdが宣言されています | — |
android/capacitor-build-gradle-applied | Android | 適用時にcapacitor.build.gradleが存在します | — |
android/gradle-wrapper-present | Android | Gradle wrapperファイルが存在します | — |
android/flavor-dimensions | Android | flavorが存在する場合、Flavor dimensionsが宣言されています | — |
android/google-services-file | Android | プラグイン適用時にgoogle-services.jsonが存在します | — |
android/local-properties-committed | Android | local.properties がシークレット付きでコミットされていない | — |
android/sdk-floors | Android | min/compile/target SDK の下限値は妥当です | — |
android/target-sdk-play | Android | targetSdk が Play の要件を満たしています | — |
android/min-sdk-capacitor | Android | minSdk が Capacitor の要件を満たしています | — |
android/version-fields | Android | versionCode / versionName が設定されています | — |
android/play-sa-access | Android | Play サービスアカウントがアプリにアクセスできます (remote) | — |
例: remote Next.js / server.url のシェル
「例: リモート Next.js / server.url シェル」セクション本番環境をロードするネイティブシェルを配信することは、 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関連情報
セクション「関連」
スタートガイド
最初の Capgo Cloud Build を作成します。
トラブルシューティング
Cloud Build の一般的な失敗と修正方法。
CLI build リファレンス
build リクエスト / prescan コマンドのオプション。