Guía de actualizaciones del SDK de Facebook para iOS

Revisión de cambios en la versión más reciente

Antes de actualizar a una nueva versión del SDK de Facebook, deberías consultar el registro de cambios en GitHub. El documento te ayudará a comprender si necesitas realizar cambios en el código a partir de la actualización.

Nota: Si vas a instalar la versión 9.0.0 o una versión posterior, ten en cuenta que se eliminó la opción autoInitEnabled del SDK. Debes inicializar el SDK de forma explícita con el método initializeSDK o de forma implícita mediante una llamada en applicationDidFinishLaunching. Para obtener más información, consulta la sección 9.0.0 del registro de cambios.

Actualización mediante el uso del administrador de paquetes de Swift (SPM)

Si tu app usa SPM para integrarse con el SDK de Facebook para iOS, sigue estos pasos.

Ten en cuenta que el inicio rápido del enlace anterior te indicará que selecciones Up to Next Major Version (Hasta la siguiente versión principal) para la opción Version (Versión), lo que significa que la herramienta no se actualizará automáticamente más allá de la versión principal que hayas especificado (por ejemplo, si seleccionaste 8.x.x, no se actualizará a una versión principal 9.x.x). Esta opción impide que se realice una actualización a una versión incompatible con tu paquete actual.

Actualización incremental

Si la actualización de la versión es incremental, se incrementará la versión secundaria o del parche.

En Xcode, haz clic en File > Swift Packages > Update to Latest Package Versions.

La siguiente imagen muestra un ejemplo:

Actualización de versión principal

Antes de actualizar la versión principal, asegúrate de consultar los registros de cambios. Si la actualización de versión conlleva un cambio de versión principal, es posible que necesites cambiar la configuración del paquete.

1. Ve a la configuración de tu proyecto y haz clic en la pestaña Swift Packages. La siguiente imagen muestra un ejemplo:


2. Selecciona el paquete Facebook para que se muestre la configuración. Cambia Version a la versión principal que quieres actualizar (en esta imagen de ejemplo, se realizó la actualización a la versión 9.0.0) y haz clic en Done.


3. Ahora, actualiza el paquete. En Xcode, haz clic en File > Swift Packages > Update to Latest Package Versions. La siguiente imagen muestra un ejemplo:
   

Ten en cuenta que puedes revertir la versión de destino si cambias el destino de la versión principal en la configuración del proyecto y vuelves a ejecutar Update to Latest Package Versions.

Actualización mediante CocoaPods

Si tu app usa CocoaPods para integrarse con el SDK de Facebook para iOS, sigue estos pasos.

1. Revisa si los puntos de distribución están desactualizados. El siguiente comando mostrará los puntos de distribución desactualizados.

   pod outdated
   

2. Actualiza los puntos de distribución desactualizados con el siguiente comando.

   pod update  [PODNAME]
   

Ten en cuenta que CocoaPods intentará encontrar una versión actualizada del punto de distribución especificado por [PODNAME], y luego actualizará el punto de distribución a la versión más reciente posible según las restricciones de versión que hayas establecido en tu Podfile. Si tienes restricciones de versión, es posible que necesites modificarlas para realizar actualizaciones de una versión principal a otra.

Nueva compilación y resolución de problemas

Una vez que hayas terminado de actualizar los SDK de destino, vuelve a compilar y resuelve los problemas que surjan. Por lo general, deberías ver problemas solo al actualizar a una nueva versión principal.

Asegúrate de consultar el registro de cambios en GitHub para comprender los problemas de compilación que puedan presentarse.

Actualización a una nueva versión de la API Graph

Si quieres actualizar a una nueva versión de la API Graph, puedes usar la herramienta de actualización para evaluar los cambios que tendrás que realizar en tu app. También puedes consultar el registro de cambios de la API Graph.