CocoaPods anunció que se convertirá en un repositorio de solo lectura en diciembre de 2026, por lo que 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.
- ¿Mi app dejará de funcionar? No. Las versiones existentes de las bibliotecas de Firebase seguirán disponibles de forma indefinida en el registro de CocoaPods, y las apps que usen esas versiones de CocoaPods seguirán funcionando.
- ¿Por qué migrar? Para seguir recibiendo las funciones, las mejoras de rendimiento y las correcciones críticas más recientes, 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 |
Estos cambios también afectarán a todas las distribuciones de Firebase que encapsulan el SDK de Firebase para Apple nativo, incluidos el SDK de Firebase Unity, el SDK de Firebase C++ y FlutterFire.
Migra tus apps para Apple
Si migras 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. Mezclar CocoaPods y Swift Package Manager (SPM) en el 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, la instalación manual de 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 elimina la necesidad de un .xcworkspace para la mayoría de las configuraciones estándar.
Migra al uso de Swift Package Manager
En la mayoría de los proyectos, la migración a Swift Package Manager no requiere que cambies el código de la aplicación, a menos que tu proyecto tenga configuraciones personalizadas de Xcode o dependencias que usen mucho los scripts de instalación de CocoaPods.
Sigue estos pasos para migrar de CocoaPods a Swift Package Manager:
- Verifica que cada una de las dependencias de tu app sea compatible con Swift Package Manager. Todas las bibliotecas de Firebase admiten SPM, pero deberás verificar la compatibilidad con SPM de 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, 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:
- Ejecuta el siguiente comando en el directorio de tu proyecto para desinstalar las dependencias de CocoaPods:
pod deintegrate
- Borra el archivo
.xcworkspacegenerado por CocoaPods.
- Ejecuta el siguiente comando en el directorio de tu proyecto para desinstalar las dependencias de CocoaPods:
- 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 SDKs específicos directamente en tu proyecto de Xcode sin usar un administrador de dependencias.
Migra a la instalación manual
- Con Xcode cerrado, quita CocoaPods de tu proyecto:
- Ejecuta el siguiente comando en el directorio de tu proyecto para desinstalar las dependencias de CocoaPods:
pod deintegrate
- Borra el archivo
.xcworkspacegenerado por CocoaPods.
- Ejecuta el siguiente comando en el directorio de tu proyecto para desinstalar las dependencias de CocoaPods:
- 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
La mayoría de los desarrolladores de Unity y Flutter no deben realizar ninguna acción. 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 las 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 Firebase CocoaPod y usar Swift Package Manager en su lugar.
Preguntas frecuentes
Necesito seguir usando CocoaPods después de octubre de 2026. ¿Cómo mantengo mi app en ejecución?
Puedes usar las versiones anteriores de los pods de Firebase o copiar los podspecs de Firebase desde GitHub y alojarlos 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 el podspec después de que se descontinúe la asistencia de CocoaPods en octubre de 2026. Si decides alojar tus propios podspecs, serás responsable de mantenerlos actualizados.
¿Por qué se descontinuará la compatibilidad con CocoaPods en octubre de 2026 si se pueden publicar CocoaPods hasta diciembre de 2026?
Elegimos octubre para garantizar que las versiones finales publicadas en CocoaPods sean estables antes de que se bloquee el registro en diciembre. Este cronograma proporciona un margen necesario para coordinar de forma segura estas actualizaciones finales y garantiza que los SDKs multiplataforma, que dependen del SDK nativo pero tienen ciclos de lanzamiento retrasados, tengan tiempo suficiente para preparar sus propios lanzamientos.
¿Mi app dejará de funcionar si no la actualizo?
No, esta baja solo afecta 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 Pod no se verán afectadas.
¿Esto afecta la facturación del proyecto?
No.
Aparece el 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 los 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 haya agregado 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 lanzada después de octubre de 2026.