Melakukan periksaan prescan

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

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

Juga dapat dijalankan 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 pemeriksaan spesifik

# 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 pengecekan tidak diketahui gagal dengan pesan kesalahan yang jelas.

Escapes global (gunakan dengan sedikit)

Bendera	Efek
`--no-prescan`	Lewati skenario seluruhnya
`--prescan-ignore-fatal` (atau `--ignore-fatal` pada `build prescan`)	Lakukan skenario, cetak laporan, tidak pernah blokir
`--fail-on-warnings`	Tangani peringatan sebagai fatal (CI)

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

Periksa katalog

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

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

Berbagi

Id	Platform	Apa yang dicek	Mengenakan secara bertahap
`shared/apikey-permission`	ios, android	API dapat meminta bangunan asli	—
`shared/app-exists`	ios, android	ID aplikasi ada dan dapat dilihat oleh API key	—
`shared/credentials-saved`	ios, android	Kredensial iOS/Android yang diperlukan disimpan secara lokal	—
`shared/cap-sync-stale`	ios, android	Aset web dibangun dan Capacitor plugin disinkronkan	—
`shared/node-linker-layout`	ios, android	Tata letak node_modules berfungsi dengan Capacitor jalur asli	—
`shared/bundle-id-consistency`	ios, android	Capacitor appId sesuai dengan ID paket asli / aplikasiId	—

iOS

Id	Platform	Apa yang diperiksa	Menerapkan secara bertahap
`ios/p12-opens`	iOS	Sertifikat iOS .p12 dapat dibuka dengan kata sandi yang disediakan	—
`ios/p12-expiry`	Sertifikat tanda tangan iOS tidak kedaluwarsa	Profil pengaturan iOS tidak kedaluwarsa	—
`ios/profile-expiry`	iOS	iOS	—
`ios/profile-bundle-match`	iOS	Profil pengaturan bundel id 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 App Store Connect API untuk aplikasi terlihat valid	—
`ios/asc-key-access`	ios	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	Layar 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	Ya
`ios/plist-background-modes-sanity`	ios	Nilai UIBackgroundModes terlihat valid	Ya
`ios/xcode-deployment-target-capacitor`	ios	Target pengembangan iOS memenuhi persyaratan Capacitor	Ya
`ios/xcode-signing-team`	ios	Tim penandatangan telah ditetapkan	Ya
`ios/xcode-bundle-id-mismatch-across-configs`	ios	ID aplikasi terkonsisten di konfigurasi Xcode	Ya
`ios/xcode-enable-bitcode-leftover`	ios	Sisa ENABLE_BITCODE dihapus	Ya
`ios/xcode-swift-version-sanity`	ios	Pengaturan versi Swift terlihat wajar	Ya
`ios/xcode-no-app-target`	ios	Aplikasi Xcode memiliki target aplikasi	Ya
`ios/xcode-multiple-app-targets`	ios	Banyak target aplikasi ditangani secara sengaja	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 adalah valid	Ya
`ios/capacitor-server-url-shipped`	ios	server.url tidak dibiarkan sebagai endpoint reload / shell remote untuk build 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	CocoaPods Pods / 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	SPM Package.resolved ada	Ya
`ios/spm-capacitor-dependency-missing`	ios	Package.swift mengumumkan 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	Target pengembangan SPM konsisten	Ya

Android

Id	Platform	Apa yang dicek	Menggunakan secara bertahap
`android/keystore-opens`	android	Android keystore membuka dengan kata sandi yang disediakan	—
`android/keystore-expiry`	Android	Certifikasi tanda tangan Android tidak telah kedaluwarsa	—
`android/cordova-vars-present`	Android	Variabel cordova.variables.gradle ada setelah cap sinkron	—
`android/gradle-props-heuristics`	Android	Heuristik gradle.properties untuk gangguan konstruksi umum	—
`android/play-sa-json`	Android	JSON layanan Play-account ada ketika dikonfigurasi	—
`android/flavor-exists`	Android	Rasa produk yang diminta ada	—
`android/agp8-package-attr`	Android	Atribut paket Manifest dihilangkan untuk AGP 8+	—
`android/manifest-well-formed`	Bahasa Android	AndroidManifest.xml memproses	—
`android/manifest-tag-typo`	Bahasa Android	Tanda tanda manifest umum yang salah	—
`android/manifest-namespace-uri`	Bahasa Android	URI namespace xmlns:android benar	—
`android/manifest-missing-prefix`	Bahasa Android	Atribut Android menggunakan prefix android:	—
`android/manifest-exported-missing`	Bahasa Android	android:exported ditetapkan di mana diperlukan	—
`android/manifest-multiple-uses-sdk`	Bahasa Android	Hanya satu elemen uses-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 diekspor dilindungi	—
`android/manifest-query-all-packages`	Android	Alasan QUERY_ALL_PACKAGES	—
`android/manifest-deeplink-valid`	android	Intent-filter tautan Deep memanggilkan valid	—
`android/applicationid-present`	android	ID aplikasi dideklarasikan di app/build.gradle	—
`android/capacitor-build-gradle-applied`	android	capacitor.build.gradle ada ketika diaplikasikan	—
`android/gradle-wrapper-present`	android	File wrapper Gradle ada	—
`android/flavor-dimensions`	android	Dimensi rasa warna dideklarasikan ketika rasa ada	—
`android/google-services-file`	android	google-services.json ada ketika plugin diaplikasikan	—
`android/local-properties-committed`	android	Properti lokal tidak dikomitkan bersama rahasia	—
`android/sdk-floors`	android	min/compile/target SDK lantai terlihat valid	—
`android/target-sdk-play`	android	Sistem operasi target memenuhi persyaratan Play	—
`android/min-sdk-capacitor`	android	Sistem operasi minimum memenuhi Capacitor persyaratan	—
`android/version-fields`	android	Kode versi / nama versi ada	—
`android/play-sa-access`	android	Akun layanan Play dapat mengakses aplikasi (jarak jauh)	—

Contoh: remote Next.js / server.url shell

Mengirimkan shell native yang memuat produksi server.url adalah pola Capacitor yang didukung. Pilih flag prescan ios/capacitor-server-url-shipped karena sering kali merupakan sisa live-reload.

Tetapkan tanpa mengaktifkan pengecekan lainnya:

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

Atau tetapkan sebagai peringatan:

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

Pemula Membuat Capgo Cloud Build pertama Anda.

Pengaturan Masalah umum Cloud Build dan solusinya.

Referensi CLI build Opsi perintah prescan / penuh build.