Busca en todas las páginas de la documentación
Lista de verificación operativa para npx expo prebuild en Expo SDK 57 - regeneración limpia por defecto, cuándo pasar --no-clean, y cómo iterar localmente sin corromper proyectos nativos. Usa esto antes de actualizaciones de SDK, PRs de config plugins, y primera configuración de dev-client.
ios//android/ obsoletos de un SDK anterior bloquean plantillas de RN 0.86.expo run:ios / expo run:android.docs/adr/ - CNG es la ruta por defecto en SDK 57.Entiende el valor por defecto limpio de SDK 57: npx expo prebuild elimina los ios/ y android/ existentes antes de generar proyectos frescos.
npx expo prebuild --no-clean superpone actualizaciones de plantilla en carpetas existentes.--no-clean en ramas de actualización.Elimina carpetas nativas obsoletas antes de prebuild de actualización: El ios/ confirmado de SDK 56 apunta a RN 0.85 Hermes y versiones de Pod.
rm -rf ios android luego npx expo prebuild.package.json muestra expo ~57.0.4 y react-native 0.86.0.Ejecuta expo-doctor antes de prebuild: Los campos app.config.ts inválidos fallan tarde - doctor detecta desvío de esquema temprano.
npx expo-doctor sale con código cero antes de expo prebuild en scripts de actualización.npx expo install --fix cuando doctor reporta desajuste de versión.Gitignore de directorios nativos bajo CNG: Los equipos estándar no confirman ios/ y android/.
.gitignore: Añade ios/ y android/ en la raíz de la app.Usa --no-install para comprobaciones de diff en CI: Omite pod install y sincronización de Gradle - validación más rápida de salida de plugin.
--no-install cuando necesites compilar inmediatamente después de prebuild.Prebuild delimitado por plataforma cuando iteras: --platform ios o --platform android ahorra tiempo en trabajo de plugin de plataforma única.
Expresa cambios nativos como plugins: Permisos, entitlements, dependencias de Gradle, y entradas de manifest pertenecen al array plugins en app.config.ts.
npx expo config --type introspect antes de prebuild completo.Ejecuta prebuild dos veces para cada plugin nuevo: La segunda ejecución debe producir cero diff en salida nativa.
npx expo prebuild && npx expo prebuild - git diff ios android vacío en segundo paso.Documenta orden de plugin en comentarios: Múltiples plugins tocando Info.plist o build.gradle dependen del orden de ejecución.
Prefiere library plugins sobre ediciones manuales: expo-camera, expo-notifications, y la mayoría de módulos Expo envían plugins mantenidos.
npx expo install <package> - no npm install @latest.Migra ediciones manuales con --no-clean temporalmente: Cuando transportas cambios de Xcode brownfield, usa --no-clean mientras desarrollas el plugin, luego verifica con limpieza completa.
Nunca edites archivos generados que no puedas reproducir: Si un cambio no está en config o en un plugin, se perderá en prebuild limpio.
expo run:ios envuelve prebuild + compile: Genera ios/ si falta, ejecuta pod install, abre compilación de Xcode.
"ios:native": "expo run:ios" en package.json.expo run:android envuelve prebuild + Gradle: Mismo flujo para Android - genera android/ si está ausente.
expo run:android --device para pruebas de hardware físico.ANDROID_HOME y plataformas de SDK están instaladas.Reconstruye dev client después de cambios de dependencia nativa: expo-dev-client incrusta código nativo - la recarga de Metro no es suficiente.
eas update envía solo JS dentro del mismo runtime.Limpia cache de Metro después de cambios de config prebuild: Las caches obsoletas enmascaran autolinking y problemas de resolución de config.
npx expo start --clear después de añadir módulos nativos.rm -rf node_modules/.cache en errores de bundler obstinados.Usa npx expo config para debuggear sin escribir archivos: Más rápido que prebuild completo cuando validas variantes de env.
npx expo config --type public antes de envío a tienda.Prueba de humo en dispositivo físico después de prebuild: Los simuladores no detectan entitlement, push, o problemas de App Links.
development construye para compañeros sin Xcode.Actualizaciones de SDK secuenciales: Sube un SDK a la vez - las plantillas de prebuild cambian por SDK.
expo install expo@^<sdk> - --fix - expo-doctor - elimina directorios nativos - prebuild.Confirma lockfiles con cambios de dep relacionados con prebuild: expo install --fix actualiza package-lock.json - CI debe resolver el mismo árbol.
package.json sin lockfile.npx expo install --check en scripts de higiene semanal.EAS Build ejecuta prebuild cuando directorios nativos están ausentes: Sube sin ios//android/ - constructor de nube los genera.
Fingerprint cambios nativos para OTA/runtime version: Cuando fingerprint nativo cambia, actualizaciones OTA deben apuntar a nuevo runtime.
@expo/fingerprint - ve Fingerprint & Native Change Detection.Alineación New Architecture: SDK 57 prebuild templates habilitan New Architecture por defecto en RN 0.86.
newArchEnabled: false requiere ADR y reconstrucción.Lanzamiento de tienda después de fusiones que afecten native: Producción eas build debe ejecutarse en el mismo commit que pasó prebuild local/EAS.
Inventaría diffs nativos mantenidos a mano antes de adopción de CNG: Lista cada cambio de Xcode y Gradle no en config.
Usa --no-clean solo durante migración, no en CI: CI debe probar que prebuild limpio es reproducible.
rm -rf ios android && npx expo prebuild pasa en rama de migración.Verificación de autolinking después de migración: expo-modules-autolinking debe aparecer en Podfile generado y settings.gradle.
npx expo prebuild --clean si entradas de autolinking están ausentes.Documenta quién posee regresiones nativas post-CNG: Ingeniero de plataforma o líder móvil revisa PRs de plugin.
app.config.ts, plugins/, y cualquier código nativo modules/.ios/ y android/ no se suben o están gitignored.app.config.ts o pluginnpx expo prebuild --platform <ios|android>npx expo run:<platform>--no-install en prebuild solo cuando omites compileios/ y android/Versiones de Stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (
expo~57.0.4).
Revisado por Chris St. John·Última actualización: 16 jul 2026