Checks de prescan del build
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
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:
npx @capgo/cli@latest build prescan <appId> --platform iosHay 80 comprobaciones disponibles hoy. Es preferible ignorar ids de comprobación individuales que desactivar todo el escaneo.
Ignorar comprobaciones específicas
Sección titulada “Ignorar comprobaciones específicas”# 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-separatednpx @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-loadsAlias independientes en build prescan:
npx @capgo/cli@latest build prescan <appId> --platform ios \ --skip ios/capacitor-server-url-shipped \ --warn ios/capacitor-server-cleartextLos ids de check desconocidos fallan rápido con un error claro.
Escapes globales (úsalos con moderación)
Sección titulada “Escapes globales (úsalos con moderación)”| Flag | Efecto |
|---|---|
--no-prescan | Omitir el escaneo completo |
--prescan-ignore-fatal (o --ignore-fatal en build prescan) | Ejecutar escaneo, imprimir informe, nunca bloquear |
--fail-on-warnings | Tratar 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.
Catálogo de comprobaciones
Sección titulada “Catálogo de comprobaciones”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.
Compartido
Sección titulada “Compartido”| Id | Plataformas | Qué verifica | Forzar gradualmente |
|---|---|---|---|
shared/apikey-permission | ios, android | La clave API puede solicitar builds nativos | — |
shared/app-exists | ios, android | El id de la app existe y es visible para la clave API | — |
shared/credentials-saved | ios, android | Las credenciales de iOS/Android se guardan en local | — |
shared/cap-sync-stale | ios, android | Assets web compilados y Capacitor plugins sincronizados | — |
shared/node-linker-layout | ios, android | el diseño de node_modules funciona con rutas nativas de Capacitor | — |
shared/bundle-id-consistency | ios, android | El appId de Capacitor coincide con el bundle id / applicationId nativo | — |
| Id | Plataformas | Qué verifica | Forzar gradualmente |
|---|---|---|---|
ios/p12-opens | iOS | El .p12 de iOS se abre con la contraseña proporcionada | — |
ios/p12-expiry | iOS | El certificado de firma de iOS no ha expirado | — |
ios/profile-expiry | iOS | El provisioning profile no ha expirado | — |
ios/profile-bundle-match | iOS | El bundle id del provisioning profile coincide con la app | — |
ios/profile-type-vs-mode | iOS | El tipo de perfil coincide con el modo app_store / ad_hoc | — |
ios/cert-profile-pairing | iOS | El certificado está incrustado en el perfil de aprovisionamiento | — |
ios/targets-covered | iOS | Todos los objetivos de iOS tienen un perfil de aprovisionamiento | — |
ios/infoplist-sanity | iOS | Info.plist tiene las claves de versión/identidad requeridas | — |
ios/asc-key-valid | iOS | Los campos de la clave API de App Store Connect parecen válidos | — |
ios/asc-key-access | iOS | La clave API de ASC puede acceder a la app (remoto) | — |
ios/plist-bundle-id-format | iOS | El formato de CFBundleIdentifier es válido | Sí |
ios/plist-version-short-format | iOS | El formato de CFBundleShortVersionString es válido | Sí |
ios/plist-version-build-format | iOS | El formato de CFBundleVersion es válido | Sí |
ios/plist-encryption-compliance | iOS | ITSAppUsesNonExemptEncryption está declarado | Sí |
ios/plist-ats-arbitrary-loads | iOS | NSAllowsArbitraryLoads no está habilitado para producción | Sí |
ios/plist-launch-storyboard | iOS | Pantalla de lanzamiento declarada | Sí |
ios/plist-orientations-multitasking | iOS | Ajustes de orientación / multitarea coherentes | Sí |
ios/plist-orientations-present | iOS | UISupportedInterfaceOrientations está declarada | Sí |
ios/plist-display-name | iOS | Nombre visible configurado | Sí |
ios/plist-background-modes-sanity | iOS | Los valores de UIBackgroundModes parecen válidos | Sí |
ios/plist-scene-lifecycle-xcode27 | iOS | La app adopta el ciclo de vida UIScene al compilar con Xcode 27+ (requerido por SDK de iOS 27) | Sí |
ios/xcode-deployment-target-capacitor | iOS | El objetivo de despliegue de iOS cumple los requisitos de Capacitor | Sí |
ios/xcode-signing-team | iOS | El equipo de firma está configurado | Sí |
ios/xcode-bundle-id-mismatch-across-configs | iOS | El Bundle ID coincide en las configs de Xcode | Sí |
ios/xcode-enable-bitcode-leftover | iOS | Se eliminó el resto de ENABLE_BITCODE | Sí |
ios/xcode-swift-version-sanity | iOS | La versión de Swift parece correcta | Sí |
ios/xcode-no-app-target | iOS | El proyecto de Xcode tiene un target de aplicación | Sí |
ios/xcode-multiple-app-targets | iOS | La gestión de múltiples targets de app es intencional | Sí |
ios/entitlements-vs-profile-capability | iOS | Los permisos coinciden con las capacidades del perfil | Sí |
ios/entitlements-aps-environment-vs-mode | iOS | aps-environment coincide con el modo de distribución | Sí |
ios/entitlements-associated-domains-format | iOS | El formato de Associated Domains es válido | Sí |
ios/entitlements-app-groups-format | iOS | El formato de App Groups es válido | Sí |
ios/capacitor-server-url-shipped | iOS | server.url no se deja como un endpoint de live-reload / shell remoto para builds de tienda | Sí |
ios/capacitor-server-cleartext | iOS | server.cleartext no está habilitado para producción | Sí |
ios/capacitor-allow-navigation-wildcard | iOS | server.allowNavigation no es un comodín general | Sí |
ios/pods-not-installed | iOS | CocoaPods Pods / workspace están presentes al usar Pods | Sí |
ios/pods-lock-missing | iOS | Podfile.lock fija las versiones de los pods | Sí |
ios/pods-capacitor-missing | iOS | Podfile conecta Capacitor | Sí |
ios/spm-package-resolved-missing | iOS | SPM Package.resolved está presente | Sí |
ios/spm-capacitor-dependency-missing | iOS | Package.swift declara Capacitor | Sí |
ios/appicon-empty-or-placeholder | iOS | AppIcon.appiconset existe y no está vacío | Sí |
ios/appicon-referenced-file-missing | iOS | Contents.json icon files exist on disk | Sí |
ios/appicon-marketing-missing | iOS | Existe un icono de marketing de 1024×1024 | Sí |
ios/spm-deployment-target-consistency | iOS | El objetivo de despliegue SPM es coherente | Sí |
Android
Sección titulada “Android”| Id | Plataformas | Qué verifica | Forzar gradualmente |
|---|---|---|---|
android/keystore-opens | Android | El keystore de Android se abre con las contraseñas proporcionadas | — |
android/keystore-expiry | Android | El certificado de firma de Android no está caducado | — |
android/cordova-vars-present | Android | cordova.variables.gradle está presente tras cap sync | — |
android/gradle-props-heuristics | Android | Heurísticas de gradle.properties para errores de build comunes | — |
android/play-sa-json | Android | El JSON de service-account de Play está presente si está configurado | — |
android/flavor-exists | Android | Existe el product flavor solicitado | — |
android/agp8-package-attr | Android | Atributo package= del manifiesto eliminado para AGP 8+ | — |
android/manifest-well-formed | Android | AndroidManifest.xml se analiza correctamente | — |
android/manifest-tag-typo | Android | Errores tipográficos comunes en etiquetas del manifiesto | — |
android/manifest-namespace-uri | Android | La URI del espacio de nombres xmlns:android es correcta | — |
android/manifest-missing-prefix | Android | Los atributos de Android usan el prefijo android: | — |
android/manifest-exported-missing | Android | android:exported está definido donde es obligatorio | — |
android/manifest-multiple-uses-sdk | Android | Solo un elemento uses-sdk | — |
android/manifest-duplicate-component | Android | Sin componentes duplicados | — |
android/manifest-unique-permission | Android | Los permisos personalizados son únicos | — |
android/manifest-hardcoded-debuggable | Android | debuggable=true no se incluye | — |
android/manifest-mock-location | Android | ACCESS_MOCK_LOCATION no se incluye | — |
android/manifest-exported-unprotected | Android | Los componentes exportados están protegidos | — |
android/manifest-query-all-packages | Android | Justificación de QUERY_ALL_PACKAGES | — |
android/manifest-deeplink-valid | Android | Los intent-filters de deeplink parecen válidos | — |
android/applicationid-present | Android | applicationId está declarado en app/build.gradle | — |
android/capacitor-build-gradle-applied | Android | capacitor.build.gradle existe al aplicarse | — |
android/gradle-wrapper-present | Android | Los archivos del wrapper de Gradle están presentes | — |
android/flavor-dimensions | Android | Las dimensiones de flavor están declaradas si existen flavors | — |
android/google-services-file | Android | google-services.json presente al aplicar el plugin | — |
android/local-properties-committed | Android | local.properties no se ha commitado con secretos | — |
android/sdk-floors | Android | los mínimos de min/compile/target SDK parecen válidos | — |
android/target-sdk-play | Android | targetSdk cumple los requisitos de Play | — |
android/min-sdk-capacitor | Android | minSdk cumple los requisitos de Capacitor | — |
android/version-fields | Android | versionCode / versionName están presentes | — |
android/play-sa-access | Android | La cuenta de servicio de Play puede acceder a la app (remoto) | — |
Ejemplo: shell remoto Next.js / server.url
Sección titulada “Ejemplo: shell remoto Next.js / server.url”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:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-skip ios/capacitor-server-url-shippedO mantén la visibilidad como advertencia:
npx @capgo/cli@latest build request <appId> --platform ios \ --prescan-warn ios/capacitor-server-url-shipped