Estamos fusionando nuestros SDK de extensión de Swift con los SDK principales para que las API nativas de Swift estén más ampliamente disponibles y aumentar nuestra capacidad para admitir nuevas funciones del lenguaje Swift en el futuro. Los cambios que estamos realizando y los impactos esperados en sus proyectos se documentan a continuación.
¿Qué está cambiando?
A partir de Firebase para Apple SDK 10.17.0, los SDK de extensión de Swift se fusionaron en sus SDK principales correspondientes. Por ejemplo, todas las API del módulo FirebaseFirestoreSwift se agregaron a FirebaseFirestore , por lo que ya no es necesario importar el módulo FirebaseFirestoreSwift para acceder a esas API.
Como todas las extensiones de Swift ahora forman parte de los módulos principales, los SDK de extensión ya no son necesarios y están en desuso. Incluir o usar los SDK de la extensión Swift generará una advertencia del compilador y, a partir de febrero de 2024, dejaremos de publicar las extensiones Swift por completo.
★ Nota: Cualquier versión actual o publicada anteriormente de las extensiones Swift seguirá funcionando. Sin embargo, le recomendamos que migre su aplicación para usar las API de Swift desde el módulo principal para asegurarse de continuar recibiendo correcciones y poder aprovechar los cambios y las nuevas funciones.
Fechas importantes para este cambio
En octubre de 2023
Los SDK de extensión de Swift se fusionaron con los SDK principales y luego quedaron obsoletos en favor de los SDK principales. Consulte las notas de la versión 10.17.0 que anuncian este cambio.
Ahora puede utilizar las API del SDK de la extensión Swift directamente desde los módulos principales del SDK. El uso de la extensión SDK seguirá siendo posible hasta el próximo lanzamiento de la versión principal, pero generará una advertencia de obsolescencia cuando se use.
Ya en febrero de 2024
Dejaremos de publicar nuevas versiones de las extensiones Swift y las eliminaremos del Package.swift de Firebase. Las versiones anteriores seguirán funcionando pero no recibirán actualizaciones.
Cómo migrar para usar API nativas de Swift desde el módulo principal
Si actualmente no utiliza los SDK de la extensión Swift, no es necesario realizar ninguna acción. Si utiliza un SDK de extensión Swift, realice los siguientes cambios en su proyecto.
Cambios en el espacio de trabajo
Administrador de paquetes rápido
Después de actualizar Firebase a la versión 10.17.0+, navegue hasta la sección Marcos, bibliotecas y contenido incrustado en la pestaña General de la configuración de su objetivo y elimine el SDK de la extensión Swift (como FirebaseFirestoreSwift ).
CacaoPods
Después de actualizar Firebase a la versión 10.17.0+, navegue hasta su Podfile y elimine la línea correspondiente a la dependencia de su proyecto al agregar la sección de marcos para su objetivo y elimine el SDK de la extensión Swift (como el pod FirebaseFirestoreSwift ). Luego, vuelva a ejecutar el comando pod install .
Distribución de cremalleras y Cartago.
Después de actualizar Firebase a la versión 10.17.0+, elimine cualquier extensión de Swift xcframeworks dentro de su proyecto (como FirebaseFirestoreSwift.xcframework ).
Cambios en el código fuente
Para todos los SDK de extensión Swift que utilizó anteriormente, realice las siguientes acciones:
- Elimine cualquier declaración de importación que haga referencia al SDK de la extensión Swift. Si el SDK principal no se importó por separado, deberá reemplazar la importación de la extensión Swift con la importación del SDK principal eliminando el
Swiftal final de la línea. - Si utilizó el espacio de nombres del módulo explícito de Swift para hacer referencia a cualquier tipo de SDK de extensión de Swift, deberá reemplazarlos con el SDK principal correspondiente. Por ejemplo, sería necesario cambiar el nombre de
FirebaseFirestoreSwift.QueryPredicateaFirebaseFirestore.QueryPredicate.