Saltar al contenido

Checks de prescan del build

Antes de que Capgo Cloud Build suba tu proyecto, CLI ejecuta un prescan que detecta problemas de credenciales, proyecto y configuración de la tienda localmente.

También se puede ejecutar de forma independiente:

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

Hay 80 comprobaciones disponibles hoy. Es preferible ignorar ids de comprobación individuales que desactivar todo el escaneo.

Ventana de 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 independientes en build prescan:

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

Los ids de check desconocidos fallan rápido con un error claro.

FlagEfecto
--no-prescanOmitir el escaneo completo
--prescan-ignore-fatal (o --ignore-fatal en build prescan)Ejecutar escaneo, imprimir informe, nunca bloquear
--fail-on-warningsTratar advertencias como fatales (CI)

--no-prescan y --prescan-ignore-fatal ocultar o evitar todos las comprobaciones restantes. Usa sobrescrituras por comprobación si solo discrepas con una regla.

Usa el id exacto en --prescan-skip / --prescan-warn.

Forzar gradualmente significa que el hallazgo es solo informativo hasta 2026-08-14, luego puede bloquear los builds.

IdPlataformasQué verificaForzar gradualmente
shared/apikey-permissionios, androidLa clave API puede solicitar builds nativos—
shared/app-existsios, androidEl id de la app existe y es visible para la clave API—
shared/credentials-savedios, androidLas credenciales de iOS/Android se guardan en local—
shared/cap-sync-staleios, androidAssets web compilados y Capacitor plugins sincronizados—
shared/node-linker-layoutios, androidel diseño de node_modules funciona con rutas nativas de Capacitor—
shared/bundle-id-consistencyios, androidEl appId de Capacitor coincide con el bundle id / applicationId nativo—
IdPlataformasQué verificaForzar gradualmente
ios/p12-opensiOSEl .p12 de iOS se abre con la contraseña proporcionada—
ios/p12-expiryiOSEl certificado de firma de iOS no ha expirado—
ios/profile-expiryiOSEl provisioning profile no ha expirado—
ios/profile-bundle-matchiOSEl bundle id del provisioning profile coincide con la app—
ios/profile-type-vs-modeiOSEl tipo de perfil coincide con el modo app_store / ad_hoc—
ios/cert-profile-pairingiOSEl certificado está incrustado en el perfil de aprovisionamiento—
ios/targets-coverediOSTodos los objetivos de iOS tienen un perfil de aprovisionamiento—
ios/infoplist-sanityiOSInfo.plist tiene las claves de versión/identidad requeridas—
ios/asc-key-validiOSLos campos de la clave API de App Store Connect parecen válidos—
ios/asc-key-accessiOSLa clave API de ASC puede acceder a la app (remoto)—
ios/plist-bundle-id-formatiOSEl formato de CFBundleIdentifier es válidoSí
ios/plist-version-short-formatiOSEl formato de CFBundleShortVersionString es válidoSí
ios/plist-version-build-formatiOSEl formato de CFBundleVersion es válidoSí
ios/plist-encryption-complianceiOSITSAppUsesNonExemptEncryption está declaradoSí
ios/plist-ats-arbitrary-loadsiOSNSAllowsArbitraryLoads no está habilitado para producciónSí
ios/plist-launch-storyboardiOSPantalla de lanzamiento declaradaSí
ios/plist-orientations-multitaskingiOSAjustes de orientación / multitarea coherentesSí
ios/plist-orientations-presentiOSUISupportedInterfaceOrientations está declaradaSí
ios/plist-display-nameiOSNombre visible configuradoSí
ios/plist-background-modes-sanityiOSLos valores de UIBackgroundModes parecen válidosSí
ios/plist-scene-lifecycle-xcode27iOSLa app adopta el ciclo de vida UIScene al compilar con Xcode 27+ (requerido por SDK de iOS 27)Sí
ios/xcode-deployment-target-capacitoriOSEl objetivo de despliegue de iOS cumple los requisitos de CapacitorSí
ios/xcode-signing-teamiOSEl equipo de firma está configuradoSí
ios/xcode-bundle-id-mismatch-across-configsiOSEl Bundle ID coincide en las configs de XcodeSí
ios/xcode-enable-bitcode-leftoveriOSSe eliminó el resto de ENABLE_BITCODESí
ios/xcode-swift-version-sanityiOSLa versión de Swift parece correctaSí
ios/xcode-no-app-targetiOSEl proyecto de Xcode tiene un target de aplicaciónSí
ios/xcode-multiple-app-targetsiOSLa gestión de múltiples targets de app es intencionalSí
ios/entitlements-vs-profile-capabilityiOSLos permisos coinciden con las capacidades del perfilSí
ios/entitlements-aps-environment-vs-modeiOSaps-environment coincide con el modo de distribuciónSí
ios/entitlements-associated-domains-formatiOSEl formato de Associated Domains es válidoSí
ios/entitlements-app-groups-formatiOSEl formato de App Groups es válidoSí
ios/capacitor-server-url-shippediOSserver.url no se deja como un endpoint de live-reload / shell remoto para builds de tiendaSí
ios/capacitor-server-cleartextiOSserver.cleartext no está habilitado para producciónSí
ios/capacitor-allow-navigation-wildcardiOSserver.allowNavigation no es un comodín generalSí
ios/pods-not-installediOSCocoaPods Pods / workspace están presentes al usar PodsSí
ios/pods-lock-missingiOSPodfile.lock fija las versiones de los podsSí
ios/pods-capacitor-missingiOSPodfile conecta CapacitorSí
ios/spm-package-resolved-missingiOSSPM Package.resolved está presenteSí
ios/spm-capacitor-dependency-missingiOSPackage.swift declara CapacitorSí
ios/appicon-empty-or-placeholderiOSAppIcon.appiconset existe y no está vacíoSí
ios/appicon-referenced-file-missingiOSContents.json icon files exist on diskSí
ios/appicon-marketing-missingiOSExiste un icono de marketing de 1024×1024Sí
ios/spm-deployment-target-consistencyiOSEl objetivo de despliegue SPM es coherenteSí
IdPlataformasQué verificaForzar gradualmente
android/keystore-opensAndroidEl keystore de Android se abre con las contraseñas proporcionadas—
android/keystore-expiryAndroidEl certificado de firma de Android no está caducado—
android/cordova-vars-presentAndroidcordova.variables.gradle está presente tras cap sync—
android/gradle-props-heuristicsAndroidHeurísticas de gradle.properties para errores de build comunes—
android/play-sa-jsonAndroidEl JSON de service-account de Play está presente si está configurado—
android/flavor-existsAndroidExiste el product flavor solicitado—
android/agp8-package-attrAndroidAtributo package= del manifiesto eliminado para AGP 8+—
android/manifest-well-formedAndroidAndroidManifest.xml se analiza correctamente—
android/manifest-tag-typoAndroidErrores tipográficos comunes en etiquetas del manifiesto—
android/manifest-namespace-uriAndroidLa URI del espacio de nombres xmlns:android es correcta—
android/manifest-missing-prefixAndroidLos atributos de Android usan el prefijo android:—
android/manifest-exported-missingAndroidandroid:exported está definido donde es obligatorio—
android/manifest-multiple-uses-sdkAndroidSolo un elemento uses-sdk—
android/manifest-duplicate-componentAndroidSin componentes duplicados—
android/manifest-unique-permissionAndroidLos permisos personalizados son únicos—
android/manifest-hardcoded-debuggableAndroiddebuggable=true no se incluye—
android/manifest-mock-locationAndroidACCESS_MOCK_LOCATION no se incluye—
android/manifest-exported-unprotectedAndroidLos componentes exportados están protegidos—
android/manifest-query-all-packagesAndroidJustificación de QUERY_ALL_PACKAGES—
android/manifest-deeplink-validAndroidLos intent-filters de deeplink parecen válidos—
android/applicationid-presentAndroidapplicationId está declarado en app/build.gradle—
android/capacitor-build-gradle-appliedAndroidcapacitor.build.gradle existe al aplicarse—
android/gradle-wrapper-presentAndroidLos archivos del wrapper de Gradle están presentes—
android/flavor-dimensionsAndroidLas dimensiones de flavor están declaradas si existen flavors—
android/google-services-fileAndroidgoogle-services.json presente al aplicar el plugin—
android/local-properties-committedAndroidlocal.properties no se ha commitado con secretos—
android/sdk-floorsAndroidlos mínimos de min/compile/target SDK parecen válidos—
android/target-sdk-playAndroidtargetSdk cumple los requisitos de Play—
android/min-sdk-capacitorAndroidminSdk cumple los requisitos de Capacitor—
android/version-fieldsAndroidversionCode / versionName están presentes—
android/play-sa-accessAndroidLa cuenta de servicio de Play puede acceder a la app (remoto)—

Publicar un shell nativo que carga una producción server.url es un patrón Capacitor soportado. Prescan marca ios/capacitor-server-url-shipped porque suele ser un residuo de live-reload.

Reconócelo sin desactivar otras comprobaciones:

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

O mantén la visibilidad como advertencia:

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