CocoaPods anunció que se volverá de solo lectura en diciembre de 2026, después de lo cual ya no se podrán publicar versiones nuevas de pods. En las siguientes secciones, se proporciona más información sobre este cambio y se explica cómo migrar tus apps a otros administradores de instalación.
Descripción general
- ¿Qué cambiará? CocoaPods pasará a un estado de solo lectura, y Firebase dejará de publicar versiones nuevas en CocoaPods en octubre de 2026.
- ¿Se interrumpirá mi app? No. Las versiones existentes de las bibliotecas de Firebase permanecerán disponibles de forma indefinida en el registro de CocoaPods, y tus apps que usen esas versiones de CocoaPod seguirán funcionando.
- ¿Por qué migrar? Para seguir recibiendo las funciones más recientes, las mejoras de rendimiento y las correcciones críticas, debes migrar el uso a Swift Package Manager o a la instalación manual.
Para adaptarse al anuncio de CocoaPods, Firebase dejará de publicar versiones nuevas en CocoaPods en octubre de 2026. Estos cambios afectan a todos los siguientes pods y sus subdependencias:
| Pods de Firebase afectados | ||
|---|---|---|
Firebase |
FirebaseAuth |
FirebaseInstallations |
FirebaseABTesting |
FirebaseCore |
FirebaseMessaging |
FirebaseAI |
FirebaseCrashlytics |
FirebaseMLModelDownloader |
FirebaseAILogic |
FirebaseDatabase |
FirebasePerformance |
FirebaseAnalytics |
FirebaseFirestore |
FirebaseRemoteConfig |
FirebaseAppCheck |
FirebaseFunctions |
FirebaseStorage |
FirebaseAppDistribution |
FirebaseInAppMessaging |
Además, estos cambios afectarán a todas las distribuciones de Firebase que encapsulan el SDK de Firebase para Apple nativo, incluidos el SDK de Firebase Unity, SDK de Firebase C++ y FlutterFire.
Migra tus apps para Apple
Si vas a migrar otras dependencias (que no son de Firebase) de CocoaPods, ten en cuenta que la práctica recomendada de la industria es usar un solo método de instalación para todo el proyecto. La combinación de CocoaPods y Swift Package Manager (SPM) dentro del mismo destino puede generar ciclos de dependencia complejos y errores de compilación. Si tus dependencias que no son de Firebase aún no admiten SPM, usar la instalación manual para las bibliotecas de Firebase es la forma más estable de consolidar tu flujo de trabajo a medida que migras.
Swift Package Manager (SPM)
¿Qué es Swift Package Manager?
Swift Package Manager (SPM) es la herramienta nativa de Apple para administrar la distribución de código. Se integra directamente en Xcode, lo que elimina la necesidad de herramientas externas de CLI como CocoaPods y simplifica la estructura de tu proyecto, ya que quita la necesidad de un .xcworkspace para la mayoría de las configuraciones estándar.
Migra para usar Swift Package Manager
En la mayoría de los proyectos, la migración a Swift Package Manager no requiere cambiar el código de la aplicación, a menos que tu proyecto tenga configuraciones o dependencias personalizadas de Xcode que hagan un uso intensivo de las secuencias de comandos de instalación de CocoaPods.
Para migrar a Swift Package Manager desde CocoaPods, haz lo siguiente:
- Verifica que cada una de las dependencias de tu app admita Swift Package Manager. Todas las bibliotecas de Firebase admiten SPM, pero deberás verificar la compatibilidad con SPM para tus dependencias que no son de Firebase en sus repositorios de GitHub o páginas de productos. Si algunas de tus dependencias que no son de Firebase no admiten SPM, usar la instalación manual en lugar de SPM es la ruta de migración más estable desde CocoaPods.
- Con Xcode cerrado, quita CocoaPods de tu proyecto:
- Para desinstalar las dependencias de CocoaPods, ejecuta el siguiente comando en el directorio de tu proyecto:
pod deintegrate
- Borra el
.xcworkspacegenerado por CocoaPods.
- Para desinstalar las dependencias de CocoaPods, ejecuta el siguiente comando en el directorio de tu proyecto:
- En Xcode, actualiza tu proyecto con las dependencias de Swift Package Manager:
- Abre el archivo
.xcodeprojde tu proyecto a través de Xcode. - Vuelve a agregar las dependencias de tu app con File > Add Package Dependencies.
- Abre el archivo
- Una vez que se agrega el paquete de Firebase, puedes actualizar las bibliotecas de Firebase de las que dependes. Para ello, navega a la configuración del proyecto en Xcode, selecciona el destino de tu app y actualiza las bibliotecas en Frameworks, Libraries, and Embedded Content. Obtén más información para usar SPM en Xcode en la documentación de Apple.
Instalación manual
¿Qué es la instalación manual?
La instalación manual implica descargar el archivo Firebase.zip, que contiene XCFrameworks precompilados para todos los productos de Firebase. Esto te permite arrastrar y soltar SDK específicos directamente en tu proyecto de Xcode sin usar un administrador de dependencias.
Migra para usar la instalación manual
- Con Xcode cerrado, quita CocoaPods de tu proyecto:
- Para desinstalar las dependencias de CocoaPods, ejecuta el siguiente comando en el directorio de tu proyecto:
pod deintegrate
- Borra el
.xcworkspacegenerado por CocoaPods.
- Para desinstalar las dependencias de CocoaPods, ejecuta el siguiente comando en el directorio de tu proyecto:
- Sigue los pasos de nuestra guía de instalación para agregar Firebase a tu proyecto de forma manual.
Migra tus apps de Unity, C++ y Flutter
SDK de Firebase Unity y FlutterFire
No se requiere ninguna acción para la mayoría de los desarrolladores de Unity y Flutter. Si actualizas a la versión más reciente de Firebase en Unity o Flutter, se migrará automáticamente tu administrador de dependencias subyacente en plataformas de Apple a Swift Package Manager.
Ten en cuenta que, si administras dependencias que no son de Firebase a través de CocoaPods, es posible que debas migrarlas de forma manual.
SDK de Firebase C++
Si incluías las dependencias subyacentes de iOS a través de CocoaPods, puedes seguir las instrucciones de migración anteriores para actualizar tus dependencias de CocoaPod de Firebase para usar Swift Package Manager en su lugar.
Preguntas frecuentes
Necesito seguir usando CocoaPods después de octubre de 2026. ¿Cómo puedo mantener mi app en funcionamiento?
Puedes usar las versiones anteriores de los pods de Firebase o copiar las especificaciones de pods de Firebase de GitHub y alojarlas en tu propio repositorio de especificaciones.
En cualquier caso, te recomendamos que migres de CocoaPods lo antes posible. No proporcionaremos asistencia oficial para instalar Firebase directamente desde la especificación de pods después de que se interrumpa la compatibilidad con CocoaPods en octubre de 2026. Si decides alojar tus propias especificaciones de pods, serás responsable de mantenerlas actualizadas.
¿Por qué se interrumpirá la compatibilidad con CocoaPods en octubre de 2026 cuando CocoaPods se puede publicar hasta diciembre de 2026?
Elegimos octubre para garantizar que las versiones finales publicadas en CocoaPods sean estables antes de que el registro se bloquee en diciembre. Esta cronología proporciona un margen necesario para coordinar de forma segura estas actualizaciones finales y garantiza que los SDK multiplataforma, que dependen del SDK nativo, pero tienen ciclos de lanzamiento retrasados, tengan mucho tiempo para preparar sus propios lanzamientos.
¿Mi app dejará de funcionar si no la actualizo?
No, esta baja solo afecta a las versiones futuras de las bibliotecas de Firebase. Las versiones existentes en CocoaPods seguirán siendo instalables, y las apps implementadas que usen esas versiones de pods no se verán afectadas.
¿Esto afecta la facturación del proyecto?
No.
Recibo un error "FirebaseLibrary not found" cuando compilo mi proyecto después de migrar a Swift Package Manager. ¿Qué procedimiento debo seguir para solucionar el problema?
Asegúrate de haber agregado el paquete de Firebase a tu proyecto de Xcode.
Cuando agregues el paquete de Firebase, Xcode te pedirá que agregues frameworks de Firebase a los destinos de compilación de tu app. Si olvidas agregar un framework durante este paso, siempre puedes agregarlo más tarde en la configuración de tu destino en Build Phases > Link Binary with Libraries. Si tu proyecto contiene varios destinos, asegúrate de que Firebase se agregue a los destinos correctos.
¿Esta transición interrumpirá mis canalizaciones de CI/CD?
No, las canalizaciones que ejecutan pod install o pod update seguirán funcionando para las versiones existentes. Sin embargo, no extraerán ninguna actualización nueva de la biblioteca de Firebase publicada después de octubre de 2026.