1. Descargue e instale la última versión de CocoaPods.

2. Para crear un archivo podfile, vaya a la carpeta raíz del proyecto en el Terminal y escriba:

   pod init

3. Para añadir la dependencia de Singular SDK, añada lo siguiente al Podfile de su proyecto:

   pod 'Singular-SDK'

   Por ejemplo

   

4. En su Terminal, navegue hasta la carpeta raíz del proyecto y ejecute:

   pod install

5. A partir de este momento, abra el archivo de espacio de trabajo de Xcode .xcworkspace para abrir el proyecto, en lugar del archivo .xcodeproj.
6. Cree una cabecera puente Swift siguiendo las instrucciones que se indican a continuación.

1. En Xcode, ve a Archivo > Añadir paquetes y entra en el repositorio de GitHub de Singular SDK:

   https://github.com/singular-labs/Singular-iOS-SDK

   

2. Actualiza la versión de Singular SDK:

   

3. Haz clic en el botón Añadir Paquete.

4. Ve a Build Phases > Link Binary with Libraries y añade la librería AdServices.framework. Asegúrate de marcarla como Opcional ya que solo está disponible para dispositivos con iOS 14.3 y superior.

   

5. Vaya a Build Settings > Linking > Other Linker Flags y actualice Other Linker Flags con los siguientes elementos:
   
   $(inherited) -ObjC -l "sqlite3.0" -l "z" -framework "AdSupport" -framework "Security" -framework "Singular" -framework "StoreKit" -framework "SystemConfiguration" -framework "WebKit" -framework "iAd"

   

   

6. Cree una cabecera puente Swift siguiendo las instrucciones que se indican a continuación.

¿Está actualizando desde Singular SDK 12.3.2 o inferior?

Siga los pasos que se indican a continuación para eliminar la antigua biblioteca estática

1. Vaya a los archivos del proyecto y elimine la biblioteca estática de Singular. Normalmente, debería tener una carpeta llamada algo así como Singular-iOS-sdk-v12.3.2. Haga clic con el botón derecho en la carpeta y elimínela del proyecto.
2. Proceda a la siguiente sección para instalar el nuevo Framework

Añadir Singular Framework por primera vez

1. Descargue y descomprima el SDK Framework.

   Seleccione el Framework correcto para su implementación:

   • Para Xcode 12 y superiores utilice el .xcframework [DESCARGAR AQUÍ].
   • Para Xcode 11 e inferiores utilice el .framework [DESCARGAR AQUÍ].

2. Añada la carpeta descomprimida a una carpeta de su proyecto Xcode:

   En Xcode, haga clic con el botón derecho en Nombre de su aplicación > Añadir archivos a [Nombre de su proyecto]. En el cuadro de diálogo que se abre, seleccione Opciones > Crear grupos y añada la carpeta donde descomprimió el SDK.
   
   
   
   
   
   El framework Singular debería estar ahora en su proyecto.
   
   

3. Para añadir las bibliotecas necesarias

   • En Xcode, selecciona Build Phases > Link Binary With Libraries.

   • Haz clic en + y añade las siguientes bibliotecas:

     Libsqlite3.0.tbd
     SystemConfiguration.framework
     Security.framework
     Libz.tbd
     AdSupport.framework
     WebKit.framework
     StoreKit.framework
     AdServices.framework (mark as Optional since it's only
         available for devices with iOS 14.3 and higher).

4. Embed & Sign the Singular Framework
   • Navega a General > Frameworks, Libraries, and Embedded Content
   • Ajusta el Singular Framework para que sea "Embed & Sign".
     
     

Si ha instalado el SDK utilizando CocoaPods o el gestor de paquetes de Swift, debe crear un Bridging Header para que Swift utilice las bibliotecas Obj-C del SDK de Singular.

1. En su proyecto, cree un nuevo archivo de tipo Header , y nómbrelo YourProjectName-Bridging-Header.

   

2. Abra el archivo y añada lo siguiente:

   #import <Singular/Singular.h>

   Por ejemplo

   

3. Vaya a Build Settings > Objective-C Bridging Header y añada la ruta relativa del archivo:

   

Si desea actualizar el valor de conversión por su cuenta utilizando el código de la app, primero debe establecer el flag manualSkanConversionManagement en el Singular Config. Esto le permite utilizar varios métodos del SDK para recuperar y actualizar el valor de conversión manualmente.

Para activar el modo manual:

func getConfig() -> SingularConfig? {
     
     // Singular Config Options


     guard let config = SingularConfig(apiKey: Constants.APIKEY,
       andSecret: Constants.SECRET) else {
         return nil
         }
     
     //...
     config.manualSkanConversionManagement = true
     //...
     
     return config
}

- (SingularConfig *)getConfig {
     
     // Singular Config Options


     SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY
       andSecret:SECRET];
     
     //...
     config.manualSkanConversionManagement = YES;
     //...
     
     return config;
}

Para actualizar el valor de conversión:

En Modo Manual, para actualizar el valor de conversión, debe utilizar el método skanUpdateConversionValue. Puedes utilizarlo siempre que sea necesario en el ciclo de vida de tu aplicación.

// Sending a Standard Event for Login


Singular.event(EVENT_SNG_LOGIN)
      
// Manually updating the conversion value to 7 after the Event


Singular.skanUpdateConversionValue(7)

// Sending a Standard Event for Login


[Singular event:EVENT_SNG_LOGIN];
      
// Manually updating the conversion value to 7 after the Event


[Singular skanUpdateConversionValue:7];

Otros métodos de SKAdNetwork:

Para obtener el valor de conversión actual, utilice el método skanGetConversionValue o conversionValueUpdatedCallback. Ambos funcionan en modo gestionado y manual.

let conversionValue = Singular.skanGetConversionValue()

NSNumber* conversionValue = [Singular skanGetConversionValue]; 

func getConfig() -> SingularConfig? {
     // Singular Config Options


     guard let config = SingularConfig(apiKey: Constants.APIKEY,
       andSecret: Constants.SECRET) else {         
         return nil
         }     
     //...
     config.conversionValueUpdatedCallback = { conversionValue in
     // Here you have access to the latest conversion value


     }
     //...
     return config
}

- (SingularConfig *)getConfig {
     // Singular Config Options


     SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY
       andSecret:SECRET];
     //...
     config.conversionValueUpdatedCallback=^(NSNumber *conversionValue, 
       NSNumber *coarse, BOOL lock) {
         // Here you have access to the CV + coarse CV


       };
     //...
     return config;
}

La siguiente tabla resume los posibles escenarios utilizando esta integración:

// INITIALIZE THE SDK IN THE FOLLOWING SCENEDELEGATE FUNCTIONS]


     
// willConnectTo session


func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
  options connectionOptions: UIScene.ConnectionOptions) {
    let userActivity = connectionOptions.userActivities.first
    // Print IDFV to Console for use in Singular SDK Console


    print(Date(), "-- Scene Delegate IDFV:", 
    UIDevice().identifierForVendor!.uuidString as Any)
    
    //Initialize the Singular SDK here:
    if let config = self.getConfig() {
      config.userActivity = userActivity
      Singular.start(config)
    }
}
      
// continue userActivity


      
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  // Starts a new Singular session on continueUserActivity


  if let config = self.getConfig() {
    config.userActivity = userActivity
    Singular.start(config)
  }
}
      
//openURLContexts URLContexts
      
func scene(_ scene: UIScene, openURLContexts URLContexts: 
  Set<UIOpenURLContext>) {
    // Starts a new Singular session on cold start from deeplink scheme


    if let config = self.getConfig() {
      config.openUrl = openurlString
      Singular.start(config)
    }
    
    // Add custom code here to Redirect to non-Singular deep links


    //...
}

// INITIALIZE THE SDK IN THE FOLLOWING WINDOWGROUP FUNCTIONS


var body: some Scene {
    WindowGroup {
        ContentView()
            .onOpenURL(perform: { url in
                openURL = url
                // Initialize Singular from an openURL


                if let config = self.getConfig() {
                    config.openUrl = url
                    Singular.start(config)
                }
            })
    }
    .onChange(of: scenePhase) { oldValue, phase in
        // The SwiftUI ScenePhases replaces the old SceneDelegate lifecycle events


        switch phase {
        case .background:
            print("App Scene: backgrounded")
        case .inactive:
            print("App Scene: inactive")
        case .active:
            print("App Scene: active")
            
            // Initialize Singular


            if let config = self.getConfig() {
                Singular.start(config)
            }
        @unknown default:
            print("App Scene: unknown")
        }
    }
}

// INITIALIZE THE SDK IN THE FOLLOWING SCENEDELEGATE FUNCTIONS


     
// willConnectToSession


- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session 
  options:(UISceneConnectionOptions *)connectionOptions {
    NSUserActivity* userActivity = [[[connectionOptions userActivities] allObjects] 
      firstObject];
    // Print identifier for Vendor (IDFV) to Xcode Console for use in Singular SDK Console


    NSLog(@"-- Scene Delegate IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);
    
    // Start a new Singular session from a backgrounded app


    SingularConfig *config = [self getConfig];
    config.userActivity = userActivity;
    [Singular start:config];
}
    
// continueUserActivity


- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity{
  // Starts a new Singular session from a backgrounded App


  SingularConfig *config = [self getConfig];
  config.userActivity = userActivity;
  [Singular start:config];
}
    
// openURLContexts


- (void)scene:(UIScene *)scene openURLContexts:(nonnull NSSet *)URLContexts {
  // Starts a new Singular session on cold start from deeplink scheme


  SingularConfig *config = [self getConfig];
  config.openUrl = url;
  [Singular start:config];
  
  // Add custom code here to Redirect to Non-Singular deep links


  //...
}

// INITIALIZE THE SDK IN THE FOLLOWING APPDELEGATE FUNCTIONS


    
// didFinishLaunchingWithOptions


- (BOOL)application:(UIApplication *)application 
  didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Starts  new session when  user opens the app if session timeout passed/opened using Singular Link


    SingularConfig *config = [self getConfig];
    config.launchOptions = launchOptions;
    [Singular start:config];
    return YES;
}
    
// continueUserActivity


- (BOOL)application:(UIApplication *)application 
  continueUserActivity:(NSUserActivity *)userActivity 
    restorationHandler:(void (^)(NSArray<id> *restorableObjects))restorationHandler {
      // Starts a new session when the user opens the app using a Singular Link while it was in the background


      SingularConfig *config = [self getConfig];
      config.userActivity = userActivity;
      [Singular start:config];
      return YES;
}
    
// openURL


- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url 
  options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options{
    // Starts new session when user opens the app using a non-Singular link, like a traditional app scheme.


    SingularConfig *config = [self getConfig];
    config.openUrl = url;
    [Singular start:config];
    // Add custom code here to Redirect to non-Singular deep links


    //...
    return YES;
}

// INITIALIZE THE SDK IN THE FOLLOWING APPDELEGATE FUNCTIONS


    
// didFinishLaunchingWithOptions


func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) - Bool {
     // Print IDFV to Console for use in Singular SDK Console 


     print(Date(), "-- Scene Delegate IDFV:", UIDevice().identifierForVendor!.uuidString as Any)
     
     //Initialize the Singular SDK here: 
     if let config = self.getConfig() { 
          config.launchOptions = launchOptions 
          Singular.start(config) 
     }
     
     return true
}
    
// continue userActivity


func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([any UIUserActivityRestoring]?) - Void) - Bool {
     
     //Initialize the Singular SDK here: 
     if let config = self.getConfig() {
          config.userActivity = userActivity
          Singular.start(config) 
     }
     
     return true
}
     
// open url


func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) - Bool {
     
     //Initialize the Singular SDK here: 
     if let config = self.getConfig() {
          config.openUrl = url
          Singular.start(config) 
     }
     
     return true
}

En Xcode 15, hay una nueva opción llamada "User Script Sandboxing" que juega un papel crucial en la compilación El propósito es evitar que los scripts realicen cambios no deseados en el sistema, mejorando así la estabilidad y la seguridad de la compilación. Cuando está activado, el sistema de compilación restringe los scripts de usuario para no permitir dependencias de entrada/salida no declaradas. Esto es problemático para Singular SDK, ya que necesita ejecutar scripts para vincular dinámicamente las dependencias.

Para resolver el problema

1. Vaya a Configuración de compilación > Opciones de compilación.
2. Ajuste "User Script Sandboxing " al valor "No".

1. Compruebe que se ha creado el Bridging Header.
2. Compruebe que el archivo Bridging Header está vinculado en Build Settings > Objective-C Bridging Header.

En algunos casos, el simulador de iOS requiere que arm64 se excluya en Build Settings > Excluded Architectures.

Las propiedades globales no se muestran actualmente en la consola de pruebas. Se añadirán en el futuro. Utilice Exportar registros para validar esta funcionalidad.

¿Por qué aparece un error de registro?

Los siguientes errores de registro comunes pueden ignorarse:

• [logging] nombre de columna duplicado: singular_link en "ALTER TABLE sessions ADD COLUMN singular_link TEXT DEFAULT NULL"
• [logging] nombre de columna duplicado: payload en "ALTER TABLE sessions ADD COLUMN payload TEXT DEFAULT NULL"
• [logging] duplicate column name: sequence in "ALTER TABLE events ADD COLUMN sequence INTEGER DEFAULT -1"
• [logging] duplicate column name: payload in "ALTER TABLE events ADD COLUMN payload TEXT DEFAULT NULL"