Konfigurasi prescan build

Copas prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Sebelum Capgo Cloud Build mengunggah proyek Anda, CLI menjalankan prescan Mengenali 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 pemeriksaan secara keseluruhan.

Mengabaikan pemeriksaan tertentu

# 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 mandiri pada 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 pesan kesalahan yang jelas.

Keluaran Global (Gunakan dengan Bijak)

Flag	Bendera
`--no-prescan`	Dampaknya adalah ‘Lepaskan sken seluruhnya’
`--prescan-ignore-fatal` atau `--ignore-fatal` di `build prescan`)	Run scan, print report, never block
`--fail-on-warnings`	Anggap peringatan sebagai fatal (CI)

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

Periksa katalog

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

Mengaktifkan secara bertahap berarti temuan adalah informasi saja sampai 2026-08-14, kemudian dapat menghambat pembangunan.

Berbagi

Id	Platform	Apa yang dicek	Menyeluruhkan pelaksanaan
`shared/apikey-permission`	iOS, Android	Kunci API dapat meminta bangun native	—
`shared/app-exists`	iOS, Android	Id aplikasi ada dan terlihat oleh kunci API	—
`shared/credentials-saved`	IOS, Android	Kredensial iOS/Android yang diperlukan disimpan secara lokal	—
`shared/cap-sync-stale`	IOS, Android	Asset web dibangun dan Capacitor plugin disinkronkan	—
`shared/node-linker-layout`	IOS, Android	Struktur node_modules berfungsi dengan Capacitor jalur native	—
`shared/bundle-id-consistency`	IOS, Android	ID aplikasi Capacitor sesuai dengan ID paket native / ID aplikasi	—

IOS

ID	Platform	Apa yang diperiksa	Menggunakan penegakan secara bertahap
`ios/p12-opens`	iOS	iOS .p12 dibuka dengan kata sandi yang disediakan	—
`ios/p12-expiry`	iOS	Sertifikat tanda tangan iOS tidak kedaluwarsa	—
`ios/profile-expiry`	iOS	Profil pengaturan tidak kedaluwarsa	—
`ios/profile-bundle-match`	iOS	ID bundle profil pengaturan sesuai dengan aplikasi	—
`ios/profile-type-vs-mode`	iOS	Jenis profil sesuai dengan mode app_store / ad_hoc	—
`ios/cert-profile-pairing`	iOS	Sertifikat terintegrasi dalam profil pengaturan	—
`ios/targets-covered`	iOS	Semua target iOS memiliki profil pengaturan	—
`ios/infoplist-sanity`	iOS	Info.plist memiliki kunci versi / identitas yang diperlukan	—
`ios/asc-key-valid`	iOS	Kunci ASC API untuk App Store Connect terlihat valid	—
`ios/asc-key-access`	iOS	Kunci ASC API 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	Screen peluncuran telah dideklarasikan	Ya
`ios/plist-orientations-multitasking`	iOS	Pengaturan orientasi / multitasking konsisten	Ya
`ios/plist-orientations-present`	iOS	UISupportedInterfaceOrientations telah dideklarasikan	Ya
`ios/plist-display-name`	iOS	Nama tampilan telah ditetapkan	Yes
`ios/plist-background-modes-sanity`	IOS	Nilai UIBackgroundModes tampak valid	Yes
`ios/xcode-deployment-target-capacitor`	IOS	Target penginstalan iOS memenuhi persyaratan Capacitor	Yes
`ios/xcode-signing-team`	IOS	Tim signing sudah ditetapkan	Yes
`ios/xcode-bundle-id-mismatch-across-configs`	IOS	ID paket konsisten di konfigurasi Xcode	Ya
`ios/xcode-enable-bitcode-leftover`	iOS	Ditinggalkan ENABLE_BITCODE	Ya
`ios/xcode-swift-version-sanity`	iOS	Pengaturan versi Swift terlihat normal	Ya
`ios/xcode-no-app-target`	iOS	Project Xcode memiliki target aplikasi	Ya
`ios/xcode-multiple-app-targets`	iOS	Ditangani secara sengaja beberapa target aplikasi	Ya
`ios/entitlements-vs-profile-capability`	iOS	Entitlements sesuai dengan kemampuan profil	Ya
`ios/entitlements-aps-environment-vs-mode`	iOS	aps-environment sesuai dengan mode distribusi	Ya
`ios/entitlements-associated-domains-format`	iOS	Format Domain Asosiasi valid	Ya
`ios/entitlements-app-groups-format`	iOS	Format App Groups valid	Ya
`ios/capacitor-server-url-shipped`	iOS	server.url tidak dibiarkan sebagai endpoint reload hidup / shell jarak jauh 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	Pods CocoaPods / workspace ada ketika menggunakan Pods	Ya
`ios/pods-lock-missing`	iOS	Podfile.lock memasang versi pod tertentu	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 mengklaim Capacitor	Yes
`ios/appicon-empty-or-placeholder`	iOS	Icon Set Aplikasi iOS Tersedia dan Tidak Kosong	Yes
`ios/appicon-referenced-file-missing`	iOS	File Icon Berisi di Disk Tersedia	Yes
`ios/appicon-marketing-missing`	iOS	Icon Pemasaran Ukuran 1024x1024 Tersedia	Yes
`ios/spm-deployment-target-consistency`	iOS	Target Pengembangan SPM Konsisten	Ya

Android

Id	Platform	Apa yang diperiksa	Menggunakan secara bertahap
`android/keystore-opens`	android	Android mengekspor keystore dengan kata sandi yang diberikan	—
`android/keystore-expiry`	android	Android sertifikat tanda tangan tidak kadaluarsa	—
`android/cordova-vars-present`	android	cordova.variables.gradle ada setelah cap sinkronisasi	—
`android/gradle-props-heuristics`	android	Properti Gradle untuk Menghindari Masalah Pembangunan Umum	—
`android/play-sa-json`	android	heuristik gradle.properties untuk masalah build umum	—
`android/flavor-exists`	android	JSON layanan Play ada ketika dikonfigurasi	—
`android/agp8-package-attr`	android	Rasa produk flavor yang diminta ada	—
`android/manifest-well-formed`	android	AndroidManifest.xml diparsing	—
`android/manifest-tag-typo`	android	Tag umum manifest yang salah ejaan	—
`android/manifest-namespace-uri`	android	xmlns:android namespace URI adalah benar	—
`android/manifest-missing-prefix`	android	URI namespace xmlns:android sudah benar	—
`android/manifest-exported-missing`	android	Atribut Android menggunakan prefix android:	—
`android/manifest-multiple-uses-sdk`	android	Only one uses-sdk element	—
`android/manifest-duplicate-component`	android	Hanya satu elemen uses-__CAPGO_KEEP_0__ yang digunakan	—
`android/manifest-unique-permission`	android	Hak istimewa kustom 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	Alasan QUERY_ALL_PACKAGES	—
`android/manifest-deeplink-valid`	android	Intent-filter deeplink tampaknya valid	—
`android/applicationid-present`	android	ID aplikasi dideklarasikan di app/build.gradle	—
`android/capacitor-build-gradle-applied`	android	capacitor.build.gradle ada ketika diterapkan	—
`android/gradle-wrapper-present`	android	File Gradle wrapper ada	—
`android/flavor-dimensions`	android	__CAPGO_KEEP_0__.build.gradle ada ketika diterapkan	—
`android/google-services-file`	android	google-services.json ada saat plugin diterapkan	—
`android/local-properties-committed`	android	Dimensi rasa yang dideklarasikan ketika rasa ada	—
`android/sdk-floors`	android	min/compile/target SDK lantai terlihat valid	—
`android/target-sdk-play`	android	Sistem Sdk target memenuhi persyaratan Play	—
`android/min-sdk-capacitor`	android	minSdk memenuhi persyaratan Capacitor	—
`android/version-fields`	android	minSdk memenuhi __CAPGO_KEEP_0__ persyaratan	—
`android/play-sa-access`	android	Akun layanan dapat mengakses aplikasi (jarak jauh)	—

akun layanan Play dapat mengakses aplikasi (remote)

Judul: Contoh: remote Next.js / shell server.url server.url adalah pola yang didukung Capacitor. Flag prescan ios/capacitor-server-url-shipped mengapa sering kali merupakan sisa live-reload.

Terima tanpa menonaktifkan cek lainnya:

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

atau jaga visibilitas sebagai peringatan:

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

Mulai Menggunakan Buat Capgo Cloud Build pertama Anda.

Pengaturan Masalah Pengalaman Membangun Cloud yang Umum dan Solusinya.

Referensi CLI Pembangunan Opsi Perintah Pembangunan Lengkap / Prascan.