Pengecekan build prescan
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Sebelum Capgo Cloud Build mengunggah proyek Anda, CLI akan menjalankan prescan untuk mendeteksi masalah kredensial, proyek, dan konfigurasi store secara lokal.
Bisa juga dijalankan secara standalone:
npx @capgo/cli@latest build prescan <appId> --platform iosAda 80 pengecekan hari ini. Lebih baik abaikan ID pengecekan tertentu daripada mematikan seluruh scan.
Abaikan pengecekan tertentu
Bagian berjudul βIgnore specific checksβ# 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-loadsAlias standalone pada build prescan:
npx @capgo/cli@latest build prescan <appId> --platform ios \ --skip ios/capacitor-server-url-shipped \ --warn ios/capacitor-server-cleartextID check yang tidak dikenal langsung gagal dengan error yang jelas.
Global escapes (gunakan seperlunya)
Bagian berjudul βGlobal escapes (gunakan seperlunya)β| Flag | Efek |
|---|---|
--no-prescan | Lewati seluruh scan |
--prescan-ignore-fatal (atau --ignore-fatal aktif build prescan) | Jalankan scan, cetak laporan, tidak pernah memblokir |
--fail-on-warnings | Anggap peringatan sebagai fatal (CI) |
--no-prescan dan --prescan-ignore-fatal sembunyikan atau bypass semua pemeriksaan lainnya. Gunakan override per pemeriksaan jika Anda hanya tidak setuju dengan satu aturan.
Katalog pemeriksaan
Bagian berjudul βKatalog pemeriksaanβGunakan id yang sama persis di --prescan-skip / --prescan-warn.
Penerapan bertahap berarti temuan hanya bersifat informasi sampai 2026-08-14, lalu bisa memblokir build.
Dibagikan
Bagian berjudul βDibagikanβ| ID | Platform | Apa yang diperiksa | Penerapan bertahap |
|---|---|---|---|
shared/apikey-permission | ios, android | key API dapat meminta build native | β |
shared/app-exists | ios, android | App id sudah ada dan terlihat oleh key API | β |
shared/credentials-saved | ios, android | Kredensial iOS/Android yang diperlukan disimpan secara lokal | β |
shared/cap-sync-stale | ios, android | Aset web di-build dan plugin Capacitor disinkronkan | β |
shared/node-linker-layout | ios, android | Layout node_modules kompatibel dengan path native Capacitor | β |
shared/bundle-id-consistency | ios, android | appId Capacitor cocok dengan bundle id / applicationId native | β |
| ID | Platform | Apa yang diperiksa | Penerapan bertahap |
|---|---|---|---|
ios/p12-opens | iOS | iOS .p12 dapat dibuka dengan password yang diberikan | β |
ios/p12-expiry | iOS | Sertifikat signing iOS belum kedaluwarsa | β |
ios/profile-expiry | iOS | Provisioning profile belum kedaluwarsa | β |
ios/profile-bundle-match | iOS | Bundle ID provisioning profile cocok dengan app | β |
ios/profile-type-vs-mode | iOS | Tipe profile cocok dengan mode app_store / ad_hoc | β |
ios/cert-profile-pairing | iOS | Sertifikat tertanam dalam provisioning profile | β |
ios/targets-covered | iOS | Semua target iOS memiliki provisioning profile | β |
ios/infoplist-sanity | iOS | Info.plist memiliki key version / identity yang diperlukan | β |
ios/asc-key-valid | iOS | Field key App Store Connect API terlihat valid | β |
ios/asc-key-access | iOS | Key API ASC dapat mengakses aplikasi (remote) | β |
ios/plist-bundle-id-format | iOS | Format CFBundleIdentifier valid | Ya |
ios/plist-version-short-format | iOS | Format CFBundleShortVersionString valid | Ya |
ios/plist-version-build-format | iOS | Format CFBundleVersion valid | Ya |
ios/plist-encryption-compliance | iOS | ITSAppUsesNonExemptEncryption telah dideklarasikan | Ya |
ios/plist-ats-arbitrary-loads | iOS | NSAllowsArbitraryLoads tidak diaktifkan untuk produksi | Ya |
ios/plist-launch-storyboard | iOS | Launch screen sudah dideklarasikan | Ya |
ios/plist-orientations-multitasking | iOS | Pengaturan orientasi / multitasking sudah konsisten | Ya |
ios/plist-orientations-present | iOS | UISupportedInterfaceOrientations sudah dideklarasikan | Ya |
ios/plist-display-name | iOS | Display name sudah diatur | Ya |
ios/plist-background-modes-sanity | iOS | Nilai UIBackgroundModes terlihat valid | Ya |
ios/plist-scene-lifecycle-xcode27 | iOS | App menggunakan lifecycle UIScene saat build dengan Xcode 27+ (wajib untuk iOS 27 SDK) | Ya |
ios/xcode-deployment-target-capacitor | iOS | Target deployment iOS memenuhi syarat Capacitor | Ya |
ios/xcode-signing-team | iOS | Signing team sudah diatur | Ya |
ios/xcode-bundle-id-mismatch-across-configs | iOS | Bundle ID konsisten di seluruh konfigurasi Xcode | Ya |
ios/xcode-enable-bitcode-leftover | iOS | Sisa ENABLE_BITCODE sudah dihapus | Ya |
ios/xcode-swift-version-sanity | iOS | Pengaturan versi Swift terlihat wajar | Ya |
ios/xcode-no-app-target | iOS | Proyek Xcode memiliki target aplikasi | Ya |
ios/xcode-multiple-app-targets | iOS | Beberapa target aplikasi ditangani secara sengaja | Ya |
ios/entitlements-vs-profile-capability | iOS | Entitlements sesuai dengan kapabilitas profil | Ya |
ios/entitlements-aps-environment-vs-mode | iOS | aps-environment sesuai dengan mode distribusi | Ya |
ios/entitlements-associated-domains-format | iOS | Format Associated Domains valid | Ya |
ios/entitlements-app-groups-format | iOS | Format App Groups valid | Ya |
ios/capacitor-server-url-shipped | iOS | server.url masih berupa endpoint live-reload / remote shell untuk build store | Ya |
ios/capacitor-server-cleartext | iOS | server.cleartext tidak diaktifkan untuk produksi | Ya |
ios/capacitor-allow-navigation-wildcard | iOS | server.allowNavigation menggunakan wildcard secara bebas | Ya |
ios/pods-not-installed | iOS | CocoaPods Pods / workspace ada saat menggunakan Pods | Ya |
ios/pods-lock-missing | iOS | Podfile.lock mengunci versi pod | Ya |
ios/pods-capacitor-missing | iOS | Podfile menghubungkan Capacitor | Ya |
ios/spm-package-resolved-missing | iOS | SPM Package.resolved ada | Ya |
ios/spm-capacitor-dependency-missing | iOS | Package.swift mendeklarasikan Capacitor | Ya |
ios/appicon-empty-or-placeholder | iOS | AppIcon.appiconset ada dan tidak kosong | Ya |
ios/appicon-referenced-file-missing | iOS | File ikon di Contents.json ada di disk | Ya |
ios/appicon-marketing-missing | iOS | Ikon marketing 1024Γ1024 tersedia | Ya |
ios/spm-deployment-target-consistency | iOS | Target deployment SPM sudah konsisten | Ya |
| ID | Platform | Apa yang diperiksa | Penerapan bertahap |
|---|---|---|---|
android/keystore-opens | Android | Keystore Android terbuka dengan password yang diberikan | β |
android/keystore-expiry | Android | Sertifikat signing Android belum kedaluwarsa | β |
android/cordova-vars-present | Android | cordova.variables.gradle ada setelah cap sync | β |
android/gradle-props-heuristics | Android | Heuristik gradle.properties untuk masalah build umum | β |
android/play-sa-json | Android | JSON service-account Play ada jika dikonfigurasi | β |
android/flavor-exists | Android | Product flavor yang diminta tersedia | β |
android/agp8-package-attr | Android | Atribut Manifest package= dihapus untuk AGP 8+ | β |
android/manifest-well-formed | Android | Parsing AndroidManifest.xml | β |
android/manifest-tag-typo | Android | Typo umum pada tag manifest | β |
android/manifest-namespace-uri | Android | URI namespace xmlns:android sudah benar | β |
android/manifest-missing-prefix | Android | Atribut Android menggunakan prefix android: | β |
android/manifest-exported-missing | Android | android:exported sudah diatur sesuai kebutuhan | β |
android/manifest-multiple-uses-sdk | Android | Hanya satu elemen yang menggunakan sdk | β |
android/manifest-duplicate-component | Android | Tidak ada komponen duplikat | β |
android/manifest-unique-permission | Android | Izin kustom bersifat unik | β |
android/manifest-hardcoded-debuggable | Android | debuggable=true tidak disertakan | β |
android/manifest-mock-location | Android | ACCESS_MOCK_LOCATION tidak disertakan | β |
android/manifest-exported-unprotected | Android | Komponen yang diekspor terlindungi | β |
android/manifest-query-all-packages | Android | Justifikasi QUERY_ALL_PACKAGES | β |
android/manifest-deeplink-valid | Android | Deeplink intent-filter terlihat valid | β |
android/applicationid-present | Android | applicationId sudah dideklarasikan di app/build.gradle | β |
android/capacitor-build-gradle-applied | Android | capacitor.build.gradle ditemukan saat diterapkan | β |
android/gradle-wrapper-present | Android | File Gradle wrapper tersedia | β |
android/flavor-dimensions | Android | Flavor dimensions dideklarasikan saat ada flavor | β |
android/google-services-file | Android | google-services.json tersedia saat plugin diterapkan | β |
android/local-properties-committed | Android | local.properties tidak di-commit bersama secrets | β |
android/sdk-floors | Android | min/compile/target SDK floors terlihat valid | β |
android/target-sdk-play | Android | targetSdk memenuhi persyaratan Play | β |
android/min-sdk-capacitor | Android | minSdk memenuhi persyaratan Capacitor | β |
android/version-fields | Android | versionCode / versionName tersedia | β |
android/play-sa-access | Android | service account Play dapat mengakses aplikasi (remote) | β |
Contoh: shell remote Next.js / server.url
Bagian berjudul βContoh: remote Next.js / server.url shellβMerilis native shell yang memuat production server.url adalah pola Capacitor yang didukung. Prescan menandai ios/capacitor-server-url-shipped karena sering kali ini sisa dari live-reload.
Akui saja tanpa menonaktifkan pengecekan lainnya:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shippedAtau biarkan tetap terlihat sebagai peringatan:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-warn ios/capacitor-server-url-shipped