Integración manual

Paso 1: Descarga del SDK de Braze

Opción 1: XCFramework dinámico

1. Descarga Appboy_iOS_SDK.xcframework.zip de la página de la versión y extrae el archivo.
2. En Xcode, arrastra y suelta este .xcframework en tu proyecto.
3. En la pestaña General del proyecto, selecciona **Incrustar signo & ** para Appboy_iOS_SDK.xcframework.

Opción 2: XCFramework estático para integración estática

1. Descarga Appboy_iOS_SDK.zip desde la página de la versión.
   
   
2. En Xcode, desde el navegador de proyectos, selecciona el proyecto o grupo de destino para Braze
   
   
3. Navega hasta Archivo > Añadir archivos > Project_Name.
   
   
4. Añade las carpetas AppboyKit y AppboyUI a tu proyecto como un grupo.
   • Asegúrate de que la opción Copiar elementos en la carpeta del grupo de destino está seleccionada si es la primera vez que realizas la integración. Amplía Opciones en el selector de archivos para seleccionar Copiar elementos si es necesario y Crear grupos.
   • Elimina los directorios AppboyKit/include y AppboyUI/include.
     
     
5. (Opcional) Si se te aplica una de las siguientes opciones:
   • Sólo quieres las características principales de análisis del SDK y no utilizas ninguna característica de la interfaz de usuario (por ejemplo, mensajes dentro de la aplicación o tarjetas de contenido).
   • Dispones de una interfaz de usuario personalizada para las características de Braze UI y te encargas tú mismo de la descarga de imágenes.
     
     Puedes utilizar la versión básica del SDK eliminando el archivo ABKSDWebImageProxy.m y Appboy.bundle. Esto eliminará la dependencia del framework SDWebImage y todos los recursos relacionados con la interfaz de usuario (por ejemplo, archivos Nib, imágenes, archivos de localización) del SDK.

Paso 2: Añadir bibliotecas iOS necesarias

1. Haz clic en el objetivo de tu proyecto (utilizando la navegación de la izquierda), y selecciona la pestaña Fases de construcción.
   
   
2. Haz clic en el botón situado debajo de Vincular binarios con bibliotecas.
   
   
3. En el menú, selecciona SystemConfiguration.framework.
   
   
4. Marca esta biblioteca como necesaria utilizando el menú desplegable situado junto a SystemConfiguration.framework.
   
   
5. Repite la operación para añadir a tu proyecto cada uno de los siguientes frameworks necesarios, marcando cada uno como “necesario”.
   • QuartzCore.framework
   • libz.tbd
   • CoreImage.framework
   • CoreText.framework
   • WebKit.framework
     
     
6. Añade los siguientes marcos y márcalos como opcionales:
   • CoreTelephony.framework
     
     
7. Selecciona la pestaña Configuración de construcción. En la sección Enlazar, localiza la configuración Otros indicadores del enlazador y añade el indicador -ObjC.
   
   
8. El framework SDWebImage es necesario para que las tarjetas de contenido y la mensajería dentro de la aplicación funcionen correctamente. SDWebImage se utiliza para descargar y mostrar imágenes, incluidos los GIF. Si pretendes utilizar tarjetas de contenido o mensajes dentro de la aplicación, sigue los pasos de integración de SDWebImage.

Integración de SDWebImage

Para instalar SDWebImage, sigue sus instrucciones y luego arrastra y suelta el XCFramework resultante en tu proyecto.

Seguimiento de ubicación opcional

1. Añade CoreLocation.framework para habilitar el seguimiento de ubicación.
2. Debes autorizar la ubicación de tus usuarios utilizando CLLocationManager en tu aplicación.

Paso 3: Cabecera de puente Objective-C

Si tu proyecto utiliza Swift, necesitarás un archivo de encabezado puente.

Si no tienes un archivo de cabecera puente, crea uno y nómbralo your-product-module-name-Bridging-Header.h eligiendo Archivo > Nuevo > Archivo > (iOS u OS X) > Fuente > Archivo de cabecera. A continuación, añade la siguiente línea de código al principio de tu archivo de cabecera puente:

1
#import "AppboyKit.h"

En la configuración de compilación de tu proyecto, añade la ruta relativa de tu archivo de cabecera a la configuración de compilación de Objective-C Bridging Header en Swift Compiler - Code Generation.

Próximos pasos

Sigue las instrucciones para completar la integración.