Conceptos básicos de iOS para desarrolladores de RN

Q: ¿Dónde se establece la versión de iOS / objetivo de implementación?

expo.ios.deploymentTarget en app.config.ts, o plugin expo-build-properties. Reconstruye nativo después de cambiar - no es un cambio de OTA.

Q: ¿Puedo eliminar DerivedData?

Sí cuando las compilaciones actúan embrujadas: rm -rf ~/Library/Developer/Xcode/DerivedData. Luego cd ios && pod install && cd .. y reconstruye.

Q: ¿Qué carpeta confirmo?

CNG: confirma app.config.ts, no ios/. Desnudo: confirma ios/ incluyendo Podfile.lock - ver CocoaPods y Pod Install.

Conceptos esenciales de Xcode sin necesidad de convertirse en ingeniero de iOS a tiempo completo - el modelo mental mínimo que los desarrolladores de React Native necesitan cuando npx expo run:ios, EAS Build, o un registro de fallos nativo te lleva a la cadena de herramientas de Apple en SDK 57.

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

# Genera ios/ desde app.config.ts (CNG) y ejecuta en simulador
npx expo prebuild --platform ios
npx expo run:ios
 
# Selecciona un simulador específico
npx expo run:ios --simulator "iPhone 16 Pro"
 
# Dispositivo USB (requiere cuenta de Apple Developer + Xcode)
npx expo run:ios --device
 
# Abre el workspace cuando debas inspeccionar la configuración de compilación nativa
open ios/*.xcworkspace
 
# Lista simuladores y dispositivos conectados
xcrun simctl list devices available
xcrun xctrace list devices

Cuándo usar esto:

Primera vez abriendo ios/ después de npx expo prebuild.
Una compilación nativa falla en EAS y necesitas reproducirla localmente en Xcode.
QA reporta un error solo en dispositivo (push, cámara, biometría, enlaces universales).
Necesitas leer un registro de fallos o adjuntar el depurador nativo a un problema de Hermes.
Alguien en el equipo pregunta "¿qué archivo edito?" - respuesta: generalmente app.config.ts, no pbxproj.

Ejemplo funcional

Paso 1 - Entiende qué generó prebuild

ios/
├── Podfile                 ← Manifiesto de dependencias de CocoaPods (autolinking escribe aquí)
├── Podfile.lock            ← Versiones de pod fijadas (confirma si ios/ está en git)
├── YourApp.xcworkspace     ← ABRE ESTO en Xcode (incluye proyecto Pods)
├── YourApp.xcodeproj       ← Solo destino de app - entrada incorrecta cuando existen Pods
└── YourApp/
    ├── AppDelegate.swift   ← Entrada de RN; raramente edita manualmente bajo CNG
    ├── Info.plist          ← Cadenas de permisos; prefiere plugins de app.config
    └── YourApp.entitlements ← Push, dominios asociados, grupos de apps

Paso 2 - Ejecuta desde CLI (ruta diaria)

npx expo install expo-dev-client
npx expo prebuild --platform ios
npx expo run:ios --simulator "iPhone 16 Pro"
npx expo start --dev-client

Paso 3 - Abre Xcode solo cuando sea necesario

open ios/ShopApp.xcworkspace

En Xcode:

Scheme (barra de herramientas): ShopApp - selecciona el destino de app a compilar.
Destino: simulador o iPhone conectado por USB.
Producto - Ejecutar (⌘R): igual que npx expo run:ios pero con puntos de interrupción GUI en código nativo.
Pestaña Firma y capacidades: ID de bundle, equipo, espejo de derechos - debe coincidir con app.config.ts.

Paso 4 - Lee un fallo de compilación nativa

▸ Compilando SomePod.m
❌ archivo 'SomeHeader.h' no encontrado

Orden típico de corrección de RN/Expo:

cd ios && pod install && cd ..
npx expo prebuild --platform ios --no-clean   # solo si ios/ está confirmado
npx expo run:ios

Si el error es firma:

error: No profiles for 'com.example.app' were found

Soluciona en Credenciales de iOS de EAS o Xcode - Firma - selecciona tu Equipo - no deshabilitando la firma.

Lo que esto demuestra:

Workspace vs proyecto - CocoaPods requiere .xcworkspace.
Flujo CLI-first - Los comandos de Expo envuelven Xcode; no vives en Interface Builder.
La configuración es la fuente de verdad - las claves de derechos e Info.plist deben fluir desde plugins de app.config.ts.
Simulador vs dispositivo - elige el hardware correcto para la característica bajo prueba.

Análisis profundo

Conceptos de Xcode mapeados a RN

Término de Xcode	Equivalente de RN / Expo
Target	El binario `.app` (tu app o una extensión de widget)
Scheme	Configuración de compilación + ejecución para un destino (Debug/Release)
Workspace	Proyecto de app + `Pods.xcodeproj`
Bundle Identifier	`ios.bundleIdentifier` en `app.config.ts`
Provisioning Profile	Permiso firmado por Apple que vincula cert + ID de bundle + dispositivos
Capacidades / Derechos	`ios.associatedDomains`, push, keychain - ver Derechos y capacidades
Info.plist	Cadenas de uso de permisos, esquemas de URL, modos de fondo
Archive	Compilación de lanzamiento para TestFlight - `eas build` hace esto en CI

Debug vs Release

	Debug	Release
Hermes	Herramientas de desarrollo habilitadas	Bytecode optimizado
Bundle JS	Servidor de desarrollo de Metro	Bundle de producción integrado
Firma	Certificado de desarrollo	Certificado de distribución
Usar cuando	Desarrollo diario, depuración USB	TestFlight, App Store

npx expo run:ios compila Debug por defecto. Los binarios de la tienda provienen de eas build --profile production.

Esenciales del simulador

# Inicia un simulador sin ejecutar la app
xcrun simctl boot "iPhone 16 Pro"
 
# Abre una URL (prueba de humo de enlace universal)
xcrun simctl openurl booted "https://shop.example.com/orders/42"
 
# Borra estado (keychain atascado / AASA cacheado)
xcrun simctl erase booted

Las Macs con Apple Silicon ejecutan simuladores arm64 de forma nativa - prefierelos sobre simuladores Rosetta-x86_64.
Los simuladores no pueden recibir APNs push real, no ejecutan BGTaskScheduler fielmente, y simulan algunos sensores.
Los dispositivos iOS 16+ requieren Developer Mode (Configuración - Privacidad y seguridad).

CNG vs `ios/` confirmado

Modelo	Tú editas	Rol de Xcode
CNG (`ios/` gitignored)	`app.config.ts`, plugins	Solo depurador; regenerado en prebuild
Nativo confirmado	`ios/` + plugins	Fusiona cambios nativos cuidadosamente en actualizaciones de SDK

SDK 57 por defecto: npx expo prebuild ejecuta --clean - ver Conceptos básicos de Prebuild.

Cuándo realmente necesitas Xcode

Errores de compilación de módulos nativos en un pod específico.
Inspeccionar Firma y capacidades después de un rechazo.
Adjuntar a un crash nativo (no redbox JS) en AppDelegate o un SDK de terceros.
Perfilar con Instruments (filtraciones de memoria en pipelines de imágenes nativas).

Para depuración de JS, prefiere React Native DevTools y Metro - no puntos de interrupción de Xcode en código de aplicación.

Errores comunes

Abrir .xcodeproj en lugar de .xcworkspace - faltan encabezados de Pods, compilación falla. Solución: siempre open ios/*.xcworkspace.
Editar Info.plist / derechos manualmente bajo CNG - borrado en próximo prebuild. Solución: plugin de configuración o campos ios de app.config.ts.
Asumir que el simulador prueba push o Live Activities - APNs requiere dispositivo + derechos apropiados. Solución: pruebas en dispositivo USB.
Desajuste de ID de bundle - app.config.ts, portal de Apple Developer y appID de AASA deben coincidir exactamente.
Perseguir UI de Xcode en cada actualización de RN - si ios/ se genera, elimina y prebuild --clean antes de fusiones manuales profundas.
Usar Expo Go para características de derechos de iOS - enlaces universales, Iniciar sesión con Apple y grupos de apps necesitan tu ID de bundle en un cliente de desarrollo o compilación de tienda.

Alternativas

Alternativa	Usar cuando	No usar cuando
`eas build --local`	Reproducir compilación de iOS en la nube en tu Mac	Solo necesitas una ejecución rápida de Debug del simulador
Xcode Cloud	El equipo ya está en CI de Apple	Equipos de Expo estándar - EAS Build es más simple
`npx react-native run-ios`	RN desnudo sin prebuild de Expo	Proyectos de Expo - pierde tubería de plugin de configuración
VS Code + sweetpad	Integración de editor más ligera	Problemas de firma complejos - usa GUI de Xcode

Preguntas frecuentes

¿Necesito una cuenta pagada de Apple Developer para compilaciones de simulador?

No - las compilaciones de simulador funcionan con Apple ID gratuito.
Dispositivo físico, TestFlight y App Store requieren el programa $99/año.

¿Dónde se establece la versión de iOS / objetivo de implementación?

expo.ios.deploymentTarget en app.config.ts, o plugin expo-build-properties.
Reconstruye nativo después de cambiar - no es un cambio de OTA.

¿Por qué Metro dice "No bundle URL present" en dispositivo?

Teléfono y Mac no en la misma red, o cliente dev no puede alcanzar Metro.
Intenta npx expo start --dev-client --tunnel o USB con banderas de nombre de host apropiadas.

¿Cómo veo registros nativos?

Xcode - Ventana - Dispositivos y simuladores - Abrir consola.
CLI: npx react-native log-ios o xcrun simctl spawn booted log stream --predicate 'processImagePath contains "YourApp"'.

¿Puedo eliminar DerivedData?

Sí cuando las compilaciones actúan embrujadas: rm -rf ~/Library/Developer/Xcode/DerivedData.
Luego cd ios && pod install && cd .. y reconstruye.

¿Qué carpeta confirmo?

CNG: confirma app.config.ts, no ios/.
Desnudo: confirma ios/ incluyendo Podfile.lock - ver CocoaPods y Pod Install.

Relacionado

CocoaPods y Pod Install - pod install y peculiaridades de Apple Silicon
Derechos y capacidades - push, dominios, keychain
Pruebas en dispositivo físico - depuración USB e inalámbrica
Conceptos básicos de Prebuild - flujo de trabajo CNG
Enlaces universales de iOS - dominios asociados y AASA
Credenciales y aprovisionamiento de iOS - certificados y perfiles

Versiones de pila: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (expo ~57.0.4).

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

# Genera ios/ desde app.config.ts (CNG) y ejecuta en simulador
npx expo prebuild --platform ios
npx expo run:ios
 
# Selecciona un simulador específico
npx expo run:ios --simulator "iPhone 16 Pro"
 
# Dispositivo USB (requiere cuenta de Apple Developer + Xcode)
npx expo run:ios --device
 
# Abre el workspace cuando debas inspeccionar la configuración de compilación nativa
open ios/*.xcworkspace
 
# Lista simuladores y dispositivos conectados
xcrun simctl list devices available
xcrun xctrace list devices

Cuándo usar esto:

Primera vez abriendo ios/ después de npx expo prebuild.
Una compilación nativa falla en EAS y necesitas reproducirla localmente en Xcode.
QA reporta un error solo en dispositivo (push, cámara, biometría, enlaces universales).
Necesitas leer un registro de fallos o adjuntar el depurador nativo a un problema de Hermes.
Alguien en el equipo pregunta "¿qué archivo edito?" - respuesta: generalmente app.config.ts, no pbxproj.

Ejemplo funcional

Paso 1 - Entiende qué generó prebuild

ios/
├── Podfile                 ← Manifiesto de dependencias de CocoaPods (autolinking escribe aquí)
├── Podfile.lock            ← Versiones de pod fijadas (confirma si ios/ está en git)
├── YourApp.xcworkspace     ← ABRE ESTO en Xcode (incluye proyecto Pods)
├── YourApp.xcodeproj       ← Solo destino de app - entrada incorrecta cuando existen Pods
└── YourApp/
    ├── AppDelegate.swift   ← Entrada de RN; raramente edita manualmente bajo CNG
    ├── Info.plist          ← Cadenas de permisos; prefiere plugins de app.config
    └── YourApp.entitlements ← Push, dominios asociados, grupos de apps

Paso 2 - Ejecuta desde CLI (ruta diaria)

npx expo install expo-dev-client
npx expo prebuild --platform ios
npx expo run:ios --simulator "iPhone 16 Pro"
npx expo start --dev-client

Paso 3 - Abre Xcode solo cuando sea necesario

open ios/ShopApp.xcworkspace

En Xcode:

Scheme (barra de herramientas): ShopApp - selecciona el destino de app a compilar.
Destino: simulador o iPhone conectado por USB.
Producto - Ejecutar (⌘R): igual que npx expo run:ios pero con puntos de interrupción GUI en código nativo.
Pestaña Firma y capacidades: ID de bundle, equipo, espejo de derechos - debe coincidir con app.config.ts.

Paso 4 - Lee un fallo de compilación nativa

▸ Compilando SomePod.m
❌ archivo 'SomeHeader.h' no encontrado

Orden típico de corrección de RN/Expo:

cd ios && pod install && cd ..
npx expo prebuild --platform ios --no-clean   # solo si ios/ está confirmado
npx expo run:ios

Si el error es firma:

error: No profiles for 'com.example.app' were found

Soluciona en Credenciales de iOS de EAS o Xcode - Firma - selecciona tu Equipo - no deshabilitando la firma.

Lo que esto demuestra:

Workspace vs proyecto - CocoaPods requiere .xcworkspace.
Flujo CLI-first - Los comandos de Expo envuelven Xcode; no vives en Interface Builder.
La configuración es la fuente de verdad - las claves de derechos e Info.plist deben fluir desde plugins de app.config.ts.
Simulador vs dispositivo - elige el hardware correcto para la característica bajo prueba.

Análisis profundo

Conceptos de Xcode mapeados a RN

Término de Xcode	Equivalente de RN / Expo
Target	El binario `.app` (tu app o una extensión de widget)
Scheme	Configuración de compilación + ejecución para un destino (Debug/Release)
Workspace	Proyecto de app + `Pods.xcodeproj`
Bundle Identifier	`ios.bundleIdentifier` en `app.config.ts`
Provisioning Profile	Permiso firmado por Apple que vincula cert + ID de bundle + dispositivos
Capacidades / Derechos	`ios.associatedDomains`, push, keychain - ver Derechos y capacidades
Info.plist	Cadenas de uso de permisos, esquemas de URL, modos de fondo
Archive	Compilación de lanzamiento para TestFlight - `eas build` hace esto en CI

Debug vs Release

	Debug	Release
Hermes	Herramientas de desarrollo habilitadas	Bytecode optimizado
Bundle JS	Servidor de desarrollo de Metro	Bundle de producción integrado
Firma	Certificado de desarrollo	Certificado de distribución
Usar cuando	Desarrollo diario, depuración USB	TestFlight, App Store

npx expo run:ios compila Debug por defecto. Los binarios de la tienda provienen de eas build --profile production.

Esenciales del simulador

# Inicia un simulador sin ejecutar la app
xcrun simctl boot "iPhone 16 Pro"
 
# Abre una URL (prueba de humo de enlace universal)
xcrun simctl openurl booted "https://shop.example.com/orders/42"
 
# Borra estado (keychain atascado / AASA cacheado)
xcrun simctl erase booted

Las Macs con Apple Silicon ejecutan simuladores arm64 de forma nativa - prefierelos sobre simuladores Rosetta-x86_64.
Los simuladores no pueden recibir APNs push real, no ejecutan BGTaskScheduler fielmente, y simulan algunos sensores.
Los dispositivos iOS 16+ requieren Developer Mode (Configuración - Privacidad y seguridad).

CNG vs `ios/` confirmado

Modelo	Tú editas	Rol de Xcode
CNG (`ios/` gitignored)	`app.config.ts`, plugins	Solo depurador; regenerado en prebuild
Nativo confirmado	`ios/` + plugins	Fusiona cambios nativos cuidadosamente en actualizaciones de SDK

SDK 57 por defecto: npx expo prebuild ejecuta --clean - ver Conceptos básicos de Prebuild.

Cuándo realmente necesitas Xcode

Errores de compilación de módulos nativos en un pod específico.
Inspeccionar Firma y capacidades después de un rechazo.
Adjuntar a un crash nativo (no redbox JS) en AppDelegate o un SDK de terceros.
Perfilar con Instruments (filtraciones de memoria en pipelines de imágenes nativas).

Para depuración de JS, prefiere React Native DevTools y Metro - no puntos de interrupción de Xcode en código de aplicación.

Errores comunes

Abrir .xcodeproj en lugar de .xcworkspace - faltan encabezados de Pods, compilación falla. Solución: siempre open ios/*.xcworkspace.
Editar Info.plist / derechos manualmente bajo CNG - borrado en próximo prebuild. Solución: plugin de configuración o campos ios de app.config.ts.
Asumir que el simulador prueba push o Live Activities - APNs requiere dispositivo + derechos apropiados. Solución: pruebas en dispositivo USB.
Desajuste de ID de bundle - app.config.ts, portal de Apple Developer y appID de AASA deben coincidir exactamente.
Perseguir UI de Xcode en cada actualización de RN - si ios/ se genera, elimina y prebuild --clean antes de fusiones manuales profundas.
Usar Expo Go para características de derechos de iOS - enlaces universales, Iniciar sesión con Apple y grupos de apps necesitan tu ID de bundle en un cliente de desarrollo o compilación de tienda.

Alternativas

Alternativa	Usar cuando	No usar cuando
`eas build --local`	Reproducir compilación de iOS en la nube en tu Mac	Solo necesitas una ejecución rápida de Debug del simulador
Xcode Cloud	El equipo ya está en CI de Apple	Equipos de Expo estándar - EAS Build es más simple
`npx react-native run-ios`	RN desnudo sin prebuild de Expo	Proyectos de Expo - pierde tubería de plugin de configuración
VS Code + sweetpad	Integración de editor más ligera	Problemas de firma complejos - usa GUI de Xcode

Preguntas frecuentes

¿Necesito una cuenta pagada de Apple Developer para compilaciones de simulador?

No - las compilaciones de simulador funcionan con Apple ID gratuito.
Dispositivo físico, TestFlight y App Store requieren el programa $99/año.

¿Dónde se establece la versión de iOS / objetivo de implementación?

expo.ios.deploymentTarget en app.config.ts, o plugin expo-build-properties.
Reconstruye nativo después de cambiar - no es un cambio de OTA.

¿Por qué Metro dice "No bundle URL present" en dispositivo?

Teléfono y Mac no en la misma red, o cliente dev no puede alcanzar Metro.
Intenta npx expo start --dev-client --tunnel o USB con banderas de nombre de host apropiadas.

¿Cómo veo registros nativos?

Xcode - Ventana - Dispositivos y simuladores - Abrir consola.
CLI: npx react-native log-ios o xcrun simctl spawn booted log stream --predicate 'processImagePath contains "YourApp"'.

¿Puedo eliminar DerivedData?

Sí cuando las compilaciones actúan embrujadas: rm -rf ~/Library/Developer/Xcode/DerivedData.
Luego cd ios && pod install && cd .. y reconstruye.

¿Qué carpeta confirmo?

CNG: confirma app.config.ts, no ios/.
Desnudo: confirma ios/ incluyendo Podfile.lock - ver CocoaPods y Pod Install.

Relacionado

CocoaPods y Pod Install - pod install y peculiaridades de Apple Silicon
Derechos y capacidades - push, dominios, keychain
Pruebas en dispositivo físico - depuración USB e inalámbrica
Conceptos básicos de Prebuild - flujo de trabajo CNG
Enlaces universales de iOS - dominios asociados y AASA
Credenciales y aprovisionamiento de iOS - certificados y perfiles

Versiones de pila: Esta página fue escrita para React 19.2.3, React Native 0.86.0 y Expo SDK 57 (expo ~57.0.4).

Conceptos básicos de iOS para desarrolladores de RN

Buscar en la documentación

Conceptos básicos de iOS para desarrolladores de RN