Skip to content


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 Embed & Sign 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 File > Add Files > Project_Name.

  4. Añade las carpetas AppboyKit y AppboyUI a tu proyecto como un grupo.
    • Asegúrate de que la opción Copy items into destination group’s folder está seleccionada si es la primera vez que realizas la integración. Amplía Options en el SELECTOR de archivos para seleccionar Copy items if needed y Create groups.
    • Elimina los directorios AppboyKit/include y AppboyUI/include.

  5. (Opcional) Si se te aplica una de las siguientes opciones:
    • Solo 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 Content Cards).
    • Dispones de una interfaz de usuario personalizada para las características de la interfaz de usuario de Braze 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 las bibliotecas de iOS necesarias

  1. Haz clic en el objetivo de tu proyecto (utilizando la navegación de la izquierda) y selecciona la pestaña Build Phases.

  2. Haz clic en el botón situado debajo de Link Binary With Libraries.

  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 “required”.
    • QuartzCore.framework
    • libz.tbd
    • CoreImage.framework
    • CoreText.framework
    • WebKit.framework

  6. Añade los siguientes frameworks y márcalos como opcionales:
    • CoreTelephony.framework

  7. Selecciona la pestaña Build Settings. En la sección Linking, localiza la configuración Other Linker Flags y añade el indicador -ObjC.

  8. El framework SDWebImage es necesario para que Content Cards 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 Content Cards 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 cabecera puente.

Si no tienes un archivo de cabecera puente, crea uno y nómbralo your-product-module-name-Bridging-Header.h eligiendo File > New > File > (iOS o OS X) > Source > Header File. 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 Build Settings 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.
New Stuff!