iOS Get started

Connectif Support

Creación 2 de octubre de 2024 11:52

Actualización 22 de octubre de 2024 10:21

En este artículo tienes las instrucciones paso a paso para añadir Connectif Mobile SDK a tu proyecto iOS. Este comienzo de la integración de tu App Móvil con Connectif, una vez hayas revisado que cumples los requisitos previos para poder realizarla.

Para realizar esta integración, necesitarás de un experto con conocimientos de programación.

1. Requisitos para poder añadir Connectif Mobile SDK a tu proyecto iOS

Necesitaremos tener activada nuestra integración App Mobil en Connectif para tener acceso en la configuración de la integración a nuestra key. Puede consultar nuestra guía de implementación.
Desarrollado como librería de iOS en Swift
iOS 13 como versión mínima de soportada.
Implementado en la app Apple Push Notification Service para la recepción de notificaciones push.

2. Cómo añadir Connectif Mobile SDK a tu proyecto iOS

1. Añadir el SDK

Actualmente Connectif iOS SDK puede ser instalado mediante Swift Package Manager (SPM), si necesita de un repositorio distinto no dude en comunicarse con nosotros para estudiar su caso.

Para añadir la dependencia de iOS SDK a través de Swift Package Manager:

Dirígete a File> Add Package Depenencies.
Asegúrate de que tienes una cuenta de GitHub asociada a Xcode (debería de aparecer en la columna de la izquierda como Source Control Account. En caso negativo, puedes añadirla haciendo en el símbolo "+" que encontrarás en esa misma columna.
Introduce la URLde nuestro repositorio en el buscador de la derecha, por ejemplo:
```
https://github.com/connectif/Connectif-iOS-SDK
```
En la vista central, selecciona el SDK cuando aparezca.
Haz clic en la opción Add Package.
En el diálogo de selección de targets, selecciona tu app como target del Connectif iOS SDK y haz clic en Add Package.

2. Iniciar el SDK

Un buen lugar para iniciar el SDK es el AppDelegate application(_:didFinishLaunchingWithOptions:), aunque esto de penderá de la naturaleza de tu aplicación.

De forma opcional, puedes obtener el email de usuarios que se registraron o iniciaron sesión antes de implementar el Mobile SDK de Connectif, añadiendo el email del usuario al iniciar el SDK.

El email deberá de cumplir estos requisitos:

Un correo válido debe tener un nombre de usuario, seguido por @, un dominio y una extensión, sin espacios ni caracteres especiales
Un máximo de 200 caracteres.

Ejemplo del email:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
        Connectif.initialize(apiKey: "YOUR_API_KEY",email: "useremail@example.com")
        return true
    }
}

3. (Opcional). Configuración Log

Al iniciar el SDK, podrás indicar el nivel de Logs que quieres mostrar (default: LogLevel.NONE).

Cada nivel mantiene los logs del nivel anterior, por lo que el nivel INFO mostrará todos los logs.

NONE: Desactiva todos los registros.
ERROR: Solo se registran errores.
WARN: Se registran advertencias y errores.
INFO: Se registran mensajes de información, advertencias y errores.

4. Implementar el tracking de los usuarios

Una vez tengas configurada la inicialización podrás comenzar con el tracking del usuario, a través de la implementación de las diferentes notificaciones.

¡Enhorabuena!
Has llegado al final de la lección.

¿Te han quedado dudas sin resolver?
Recuerda que tienes a tu disposición a nuestros especialistas en Connectif. Para contactar con ellos, tan solo tendrás que abrir ticket a Soporte haciendo clic en el botón azul de “Ayuda” de tu dashboard.

¡Sigue aprendiendo!

Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:

Guía completa para integrar Connectif con tu App Móvil, para conocer en profundidad todos los cambios de esta integración.
Configuración Apple Push Notifications Service, para activar el envío y recepción de push mediante el Mobile SDK de iOS.
Android SDK Get Started, para añadir Connectif Mobile SDK a tu proyecto Android.
Configuración Firebase Cloud Messaging, para activar el envío y recepción de push mediante el Mobile SDK de Android.