Periksa konfigurasi pembangunan

Sebelum Capgo Cloud Build mengunggah proyek Anda, CLI menjalankan pemeriksaan awal yang menangkap masalah kredit, proyek, dan konfigurasi toko secara lokal.

Juga menjalankan secara mandiri:

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

Ada 80 pemeriksaan hari ini. Lebih baik mengabaikan ID pemeriksaan individu daripada mematikan skenario pemeriksaan secara keseluruhan.

Abai khusus pemeriksaan

# 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 berdiri sendiri aktif build prescan:

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

ID cek tidak diketahui gagal dengan cepat dengan pesan kesalahan yang jelas.

Trik

Diperlukan @capgo/cli@latest dengan dukungan pengaturan per-cek. Lebih baik --prescan-skip / --prescan-warn sehingga setiap cek lainnya masih melindungi bangun Anda.

Penggunaan global (gunakan dengan hati-hati)

Flag	Pengaruh
--no-prescan	Lebihkan Sken Semua
--prescan-ignore-fatal atau --ignore-fatal Pada build prescan)	Sken, cetak laporan, tidak pernah menghalangi
--fail-on-warnings	Tangani peringatan sebagai fatal (CI)

--no-prescan dan --prescan-ignore-fatal sembunyikan atau menghindari semua periksa lainnya. Gunakan pengaturan per-periksaan jika Anda hanya tidak setuju dengan satu aturan.

Periksa katalog

Pakai id yang tepat di --prescan-skip / --prescan-warn.

Mengenakan secara bertahap berarti temuan hanya berupa informasi sampai 2026-08-14, kemudian dapat menghambat pembangunan.

Berbagi

Id	Platform	Apa yang diperiksa	Mengenakan secara bertahap
shared/apikey-permission	iOS, Android	Kunci API dapat meminta bangun native	—
shared/app-exists	iOS, Android	Aplikasi id ada dan terlihat untuk kunci API	—
shared/credentials-saved	iOS, Android	Kredensial iOS/Android yang diperlukan disimpan secara lokal	—
shared/cap-sync-stale	iOS, Android	Aset web dibangun dan plugin Capacitor disinkronkan	—
shared/node-linker-layout	iOS, Android	Tata letak node_modules bekerja dengan jalur native Capacitor	—
shared/bundle-id-consistency	iOS, Android	ID aplikasi Capacitor sesuai dengan ID paket native / applicationId	—

iOS

Id	Platform	Apa yang dicek	Menggunakan secara bertahap
ios/p12-opens	ios	iOS .p12 dapat dibuka dengan kata sandi yang disediakan	—
ios/p12-expiry	ios	Sertifikat tanda tangan iOS tidak kadaluarsa	—
ios/profile-expiry	ios	Profil pengaturan tidak kadaluarsa	—
ios/profile-bundle-match	iOS	ID bundle profil provisioning aplikasi sesuai	—
ios/profile-type-vs-mode	iOS	Jenis profil sesuai dengan mode app_store / ad_hoc	—
ios/cert-profile-pairing	iOS	Sertifikat terintegrasi dalam profil provisioning	—
ios/targets-covered	iOS	Semua target iOS memiliki profil provisioning	—
ios/infoplist-sanity	iOS	Info.plist memiliki kunci versi / identitas yang diperlukan	—
ios/asc-key-valid	iOS	Kunci API App Store Connect terlihat valid	—
ios/asc-key-access	iOS	ASC API dapat mengakses aplikasi (jarak jauh)	—
ios/plist-bundle-id-format	iOS	Format CFBundleIdentifier adalah valid	Ya
ios/plist-version-short-format	iOS	Format CFBundleShortVersionString adalah valid	Ya
ios/plist-version-build-format	iOS	Format CFBundleVersion adalah valid	Ya
ios/plist-encryption-compliance	iOS	Apa itu ITSAppUsesNonExemptEncryption yang dideklarasikan?	Ya
ios/plist-ats-arbitrary-loads	ios	NSAllowsArbitraryLoads tidak diaktifkan untuk produksi	Ya
ios/plist-launch-storyboard	ios	Apakah layar peluncuran dideklarasikan?	Ya
ios/plist-orientations-multitasking	ios	Konfigurasi orientasi / multitasking konsisten?	Ya
ios/plist-orientations-present	ios	Orientasi Antarmuka yang Dapat Dibantu oleh UI telah Dideklarasikan	Ya
ios/plist-display-name	ios	Nama Tampilan telah Ditetapkan	Ya
ios/plist-background-modes-sanity	ios	Nilai Mode Latar Belakang UI terlihat Sah	Ya
ios/xcode-deployment-target-capacitor	ios	Target Pengembangan iOS memenuhi Persyaratan Capacitor	Ya
ios/xcode-signing-team	ios	Tim pengesahan telah ditetapkan	Ya
ios/xcode-bundle-id-mismatch-across-configs	iOS	ID aplikasi konsisten di konfigurasi Xcode	Ya
ios/xcode-enable-bitcode-leftover	iOS	ENABLE_BITCODE yang tersisa dihapus	Ya
ios/xcode-swift-version-sanity	iOS	Pengaturan versi Swift terlihat wajar	Ya
ios/xcode-no-app-target	iOS	Projek Xcode memiliki target aplikasi	Ya
ios/xcode-multiple-app-targets	ios	Target aplikasi beberapa aplikasi dihandle secara sengaja	Ya
ios/entitlements-vs-profile-capability	ios	Entitlements cocok dengan kemampuan profil	Ya
ios/entitlements-aps-environment-vs-mode	ios	aps-environment cocok dengan mode distribusi	Ya
ios/entitlements-associated-domains-format	ios	Format Domain Terkait Sah	Ya
ios/entitlements-app-groups-format	ios	Format App Groups Sah	Ya
ios/capacitor-server-url-shipped	ios	server.url tidak dibiarkan sebagai endpoint reload hidup / shell remote untuk pembangunan toko	Ya
ios/capacitor-server-cleartext	ios	server.cleartext tidak diaktifkan untuk produksi	Ya
ios/capacitor-allow-navigation-wildcard	ios	server.allowNavigation bukanlah wildcard umum	Ya
ios/pods-not-installed	iOS	Pod CocoaPods / workspace ada ketika menggunakan Pods	Ya
ios/pods-lock-missing	iOS	Podfile.lock memasang versi pod	Ya
ios/pods-capacitor-missing	iOS	Podfile menghubungkan Capacitor	Ya
ios/spm-package-resolved-missing	iOS	Paket SPM terresolusi ada	Ya
ios/spm-capacitor-dependency-missing	iOS	Paket Swift menyatakan Capacitor	Ya
ios/appicon-empty-or-placeholder	iOS	AppIcon.appiconset ada dan tidak kosong	Ya
ios/appicon-referenced-file-missing	iOS	File ikon Contents.json ada di disk	Ya
ios/appicon-marketing-missing	iOS	ikon pemasaran 1024×1024 ada	Ya
ios/spm-deployment-target-consistency	iOS	Tujuan pengembangan SPM konsisten	Ya

Android

ID	Platform	Apa yang dicek	Menggunakan secara bertahap
android/keystore-opens	android	Android keystore dibuka dengan kata sandi yang disediakan	—
android/keystore-expiry	android	Sertifikat tanda tangan Android tidak kedaluwarsa	—
android/cordova-vars-present	android	cordova.variables.gradle ada setelah cap sinkronisasi	—
android/gradle-props-heuristics	android	Heuristik gradle.properties untuk gangguan konstruksi umum	—
android/play-sa-json	android	JSON akun layanan Play ada ketika dikonfigurasi	—
android/flavor-exists	android	Rasa produk flavor yang diminta ada	—
android/agp8-package-attr	android	Manifest package= atribut dihapus untuk AGP 8+	—
android/manifest-well-formed	Android	AndroidManifest.xml diproses	—
android/manifest-tag-typo	Android	Penyebab umum kesalahan tag manifest	—
android/manifest-namespace-uri	Android	URI namespace xmlns:android benar	—
android/manifest-missing-prefix	Android	Atribut Android menggunakan prefix android:	—
android/manifest-exported-missing	Android	android:exported diatur di mana diperlukan	—
android/manifest-multiple-uses-sdk	Android	Hanya satu elemen sdk yang digunakan	—
android/manifest-duplicate-component	android	Tidak ada komponen duplikat	—
android/manifest-unique-permission	android	Izin khusus adalah unik	—
android/manifest-hardcoded-debuggable	android	debuggable=true tidak dikirimkan	—
android/manifest-mock-location	android	ACCESS_MOCK_LOCATION tidak dikirimkan	—
android/manifest-exported-unprotected	android	Komponen yang diekspor dilindungi	—
android/manifest-query-all-packages	android	QUERY_ALL_PACKAGES alasan	—
android/manifest-deeplink-valid	android	Link akses dalam aplikasi tampak valid	—
android/applicationid-present	android	ID aplikasi telah dideklarasikan di app/build.gradle	—
android/capacitor-build-gradle-applied	android	capacitor.build.gradle ada ketika diterapkan	—
android/gradle-wrapper-present	android	File wrapper Gradle ada	—
android/flavor-dimensions	android	Dimensi rasa telah dideklarasikan ketika rasa ada	—
android/google-services-file	android	ada google-services.json ketika plugin diterapkan	—
android/local-properties-committed	android	local.properties tidak dikomitkan dengan rahasia	—
android/sdk-floors	android	tingkat min/compile/target SDK terlihat valid	—
android/target-sdk-play	android	targetSdk memenuhi persyaratan Play	—
android/min-sdk-capacitor	android	minSdk memenuhi Capacitor persyaratan	—
android/version-fields	android	versiCode / versiNama hadir	—
android/play-sa-access	android	Akun layanan dapat mengakses aplikasi (remote)	—

Contoh: remote Next.js / server.url shell

Menyebarkan shell native yang memuat produksi server.url adalah pola Capacitor yang didukung. Flag prescan ios/capacitor-server-url-shipped karena sering kali merupakan sisa reload hidup.

Konfirmasinya tanpa menonaktifkan cek lainnya:

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

atau tetapkan visibilitas sebagai peringatan:

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

Terkait

Pengantar Buat Capgo Build Pertama Anda.

Pengaturan Masalah umum pada __CAPGO_KEEP_0__ Build dan solusinya.

Referensi CLI Build Opsi perintah prescan / penuh __CAPGO_KEEP_0__ Build.