Langsung ke konten

Pengecekan build prescan

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:

Jendela terminal
npx @capgo/cli@latest build prescan <appId> --platform ios

Ada 80 pengecekan hari ini. Lebih baik abaikan ID pengecekan tertentu daripada mematikan seluruh scan.

Jendela terminal
# 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

Alias standalone pada build prescan:

Jendela terminal
npx @capgo/cli@latest build prescan <appId> --platform ios \
--skip ios/capacitor-server-url-shipped \
--warn ios/capacitor-server-cleartext

ID check yang tidak dikenal langsung gagal dengan error yang jelas.

FlagEfek
--no-prescanLewati seluruh scan
--prescan-ignore-fatal (atau --ignore-fatal aktif build prescan)Jalankan scan, cetak laporan, tidak pernah memblokir
--fail-on-warningsAnggap 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.

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.

IDPlatformApa yang diperiksaPenerapan bertahap
shared/apikey-permissionios, androidkey API dapat meminta build nativeβ€”
shared/app-existsios, androidApp id sudah ada dan terlihat oleh key APIβ€”
shared/credentials-savedios, androidKredensial iOS/Android yang diperlukan disimpan secara lokalβ€”
shared/cap-sync-staleios, androidAset web di-build dan plugin Capacitor disinkronkanβ€”
shared/node-linker-layoutios, androidLayout node_modules kompatibel dengan path native Capacitorβ€”
shared/bundle-id-consistencyios, androidappId Capacitor cocok dengan bundle id / applicationId nativeβ€”
IDPlatformApa yang diperiksaPenerapan bertahap
ios/p12-opensiOSiOS .p12 dapat dibuka dengan password yang diberikanβ€”
ios/p12-expiryiOSSertifikat signing iOS belum kedaluwarsaβ€”
ios/profile-expiryiOSProvisioning profile belum kedaluwarsaβ€”
ios/profile-bundle-matchiOSBundle ID provisioning profile cocok dengan appβ€”
ios/profile-type-vs-modeiOSTipe profile cocok dengan mode app_store / ad_hocβ€”
ios/cert-profile-pairingiOSSertifikat tertanam dalam provisioning profileβ€”
ios/targets-coverediOSSemua target iOS memiliki provisioning profileβ€”
ios/infoplist-sanityiOSInfo.plist memiliki key version / identity yang diperlukanβ€”
ios/asc-key-validiOSField key App Store Connect API terlihat validβ€”
ios/asc-key-accessiOSKey API ASC dapat mengakses aplikasi (remote)β€”
ios/plist-bundle-id-formatiOSFormat CFBundleIdentifier validYa
ios/plist-version-short-formatiOSFormat CFBundleShortVersionString validYa
ios/plist-version-build-formatiOSFormat CFBundleVersion validYa
ios/plist-encryption-complianceiOSITSAppUsesNonExemptEncryption telah dideklarasikanYa
ios/plist-ats-arbitrary-loadsiOSNSAllowsArbitraryLoads tidak diaktifkan untuk produksiYa
ios/plist-launch-storyboardiOSLaunch screen sudah dideklarasikanYa
ios/plist-orientations-multitaskingiOSPengaturan orientasi / multitasking sudah konsistenYa
ios/plist-orientations-presentiOSUISupportedInterfaceOrientations sudah dideklarasikanYa
ios/plist-display-nameiOSDisplay name sudah diaturYa
ios/plist-background-modes-sanityiOSNilai UIBackgroundModes terlihat validYa
ios/plist-scene-lifecycle-xcode27iOSApp menggunakan lifecycle UIScene saat build dengan Xcode 27+ (wajib untuk iOS 27 SDK)Ya
ios/xcode-deployment-target-capacitoriOSTarget deployment iOS memenuhi syarat CapacitorYa
ios/xcode-signing-teamiOSSigning team sudah diaturYa
ios/xcode-bundle-id-mismatch-across-configsiOSBundle ID konsisten di seluruh konfigurasi XcodeYa
ios/xcode-enable-bitcode-leftoveriOSSisa ENABLE_BITCODE sudah dihapusYa
ios/xcode-swift-version-sanityiOSPengaturan versi Swift terlihat wajarYa
ios/xcode-no-app-targetiOSProyek Xcode memiliki target aplikasiYa
ios/xcode-multiple-app-targetsiOSBeberapa target aplikasi ditangani secara sengajaYa
ios/entitlements-vs-profile-capabilityiOSEntitlements sesuai dengan kapabilitas profilYa
ios/entitlements-aps-environment-vs-modeiOSaps-environment sesuai dengan mode distribusiYa
ios/entitlements-associated-domains-formatiOSFormat Associated Domains validYa
ios/entitlements-app-groups-formatiOSFormat App Groups validYa
ios/capacitor-server-url-shippediOSserver.url masih berupa endpoint live-reload / remote shell untuk build storeYa
ios/capacitor-server-cleartextiOSserver.cleartext tidak diaktifkan untuk produksiYa
ios/capacitor-allow-navigation-wildcardiOSserver.allowNavigation menggunakan wildcard secara bebasYa
ios/pods-not-installediOSCocoaPods Pods / workspace ada saat menggunakan PodsYa
ios/pods-lock-missingiOSPodfile.lock mengunci versi podYa
ios/pods-capacitor-missingiOSPodfile menghubungkan CapacitorYa
ios/spm-package-resolved-missingiOSSPM Package.resolved adaYa
ios/spm-capacitor-dependency-missingiOSPackage.swift mendeklarasikan CapacitorYa
ios/appicon-empty-or-placeholderiOSAppIcon.appiconset ada dan tidak kosongYa
ios/appicon-referenced-file-missingiOSFile ikon di Contents.json ada di diskYa
ios/appicon-marketing-missingiOSIkon marketing 1024Γ—1024 tersediaYa
ios/spm-deployment-target-consistencyiOSTarget deployment SPM sudah konsistenYa
IDPlatformApa yang diperiksaPenerapan bertahap
android/keystore-opensAndroidKeystore Android terbuka dengan password yang diberikanβ€”
android/keystore-expiryAndroidSertifikat signing Android belum kedaluwarsaβ€”
android/cordova-vars-presentAndroidcordova.variables.gradle ada setelah cap syncβ€”
android/gradle-props-heuristicsAndroidHeuristik gradle.properties untuk masalah build umumβ€”
android/play-sa-jsonAndroidJSON service-account Play ada jika dikonfigurasiβ€”
android/flavor-existsAndroidProduct flavor yang diminta tersediaβ€”
android/agp8-package-attrAndroidAtribut Manifest package= dihapus untuk AGP 8+β€”
android/manifest-well-formedAndroidParsing AndroidManifest.xmlβ€”
android/manifest-tag-typoAndroidTypo umum pada tag manifestβ€”
android/manifest-namespace-uriAndroidURI namespace xmlns:android sudah benarβ€”
android/manifest-missing-prefixAndroidAtribut Android menggunakan prefix android:β€”
android/manifest-exported-missingAndroidandroid:exported sudah diatur sesuai kebutuhanβ€”
android/manifest-multiple-uses-sdkAndroidHanya satu elemen yang menggunakan sdkβ€”
android/manifest-duplicate-componentAndroidTidak ada komponen duplikatβ€”
android/manifest-unique-permissionAndroidIzin kustom bersifat unikβ€”
android/manifest-hardcoded-debuggableAndroiddebuggable=true tidak disertakanβ€”
android/manifest-mock-locationAndroidACCESS_MOCK_LOCATION tidak disertakanβ€”
android/manifest-exported-unprotectedAndroidKomponen yang diekspor terlindungiβ€”
android/manifest-query-all-packagesAndroidJustifikasi QUERY_ALL_PACKAGESβ€”
android/manifest-deeplink-validAndroidDeeplink intent-filter terlihat validβ€”
android/applicationid-presentAndroidapplicationId sudah dideklarasikan di app/build.gradleβ€”
android/capacitor-build-gradle-appliedAndroidcapacitor.build.gradle ditemukan saat diterapkanβ€”
android/gradle-wrapper-presentAndroidFile Gradle wrapper tersediaβ€”
android/flavor-dimensionsAndroidFlavor dimensions dideklarasikan saat ada flavorβ€”
android/google-services-fileAndroidgoogle-services.json tersedia saat plugin diterapkanβ€”
android/local-properties-committedAndroidlocal.properties tidak di-commit bersama secretsβ€”
android/sdk-floorsAndroidmin/compile/target SDK floors terlihat validβ€”
android/target-sdk-playAndroidtargetSdk memenuhi persyaratan Playβ€”
android/min-sdk-capacitorAndroidminSdk memenuhi persyaratan Capacitorβ€”
android/version-fieldsAndroidversionCode / versionName tersediaβ€”
android/play-sa-accessAndroidservice account Play dapat mengakses aplikasi (remote)β€”

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:

Jendela terminal
npx @capgo/cli@latest build request <appId> --platform ios \
--prescan-skip ios/capacitor-server-url-shipped

Atau biarkan tetap terlihat sebagai peringatan:

Jendela terminal
npx @capgo/cli@latest build request <appId> --platform ios \
--prescan-warn ios/capacitor-server-url-shipped