React Native: armando un build de iOS sin volverte loco

Teléfono junto a portátil de desarrollo
Imagen editorial publicada en Dribba como referencia visual del desarrollo móvil. Autor y licencia pendientes de verificar. · Ver imagen original

Cada vez que un cliente me pide un build de iOS para React Native, sé que voy a pasar dos horas peleando con certificados. Esta es mi checklist para llegar al final sin tirarme por la ventana.

Ilustración conceptual de compilación de aplicaciones iOS con React Native: bundle, dependencias nativas y Xcode.
Ilustración conceptual original: síntesis visual del tema del artículo, no captura ni prueba ejecutada.

1. Provisioning profiles

Apple tiene tres tipos: Development, Ad Hoc, App Store. Para probar en tu dispositivo necesitas Ad Hoc con el UDID del teléfono. Para subir a TestFlight necesitas App Store. Verifica cuál tienes antes de empezar.

2. Cocoapods limpio

cd ios
pod repo update
rm -rf Pods Podfile.lock
pod install

Esto resuelve el 80% de los errores de “no such module” después de un npx react-native upgrade.

3. Scheme y configuración

xcodebuild -list

Mira los schemes disponibles. A veces el scheme se llama diferente al nombre del proyecto y te ahorra horas saberlo antes.

4. Archive

xcodebuild clean archive \
  -workspace MyApp.xcworkspace \
  -scheme MyApp \
  -configuration Release \
  -archivePath build/MyApp.xcarchive

5. Export

Necesitas un ExportOptions.plist con el method correcto (ad-hoc o app-store). Sin ese archivo, el export falla sin mensaje útil.

Conclusión

React Native es fantástico para construir, pero el toolchain de iOS sigue siendo dolor. Documentar tu checklist te ahorra horas en cada release.