Instalar y configurar el SDK de iOS

El SDK de Adapty incluye dos módulos clave para integrarse fácilmente en tu app:

• Core Adapty: El SDK esencial, necesario para que Adapty funcione correctamente en tu app.
• AdaptyUI: Módulo opcional que necesitas si usas el Adapty Paywall Builder, una herramienta visual sin código para crear paywalls multiplataforma de forma sencilla.

Para ver una implementación completa paso a paso, también puedes ver los vídeos:

Requisitos

Aunque el SDK es técnicamente compatible con iOS 13.0+ para el módulo principal, en la práctica se requiere iOS 15.0+ porque:

• Todas las funciones de StoreKit 2 requieren iOS 15.0+
• El módulo AdaptyUI solo es compatible con iOS 15.0+

Instalar el SDK de Adapty

Activar el módulo Adapty del SDK de Adapty

Activa el SDK de Adapty en el código de tu app.

Para obtener tu Public SDK Key:

1. Ve al Adapty Dashboard y navega a App settings → General.
2. En la sección Api keys, copia la Public SDK Key (NO la Secret Key).
3. Reemplaza "YOUR_PUBLIC_SDK_KEY" en el código.

@main
struct YourApp: App {
  init() {
    // Configure Adapty SDK
    let configurationBuilder = AdaptyConfiguration
      .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Get from Adapty dashboard

   Adapty.logLevel = .verbose // recommended for development and the first production release

    let config = configurationBuilder.build()

    // Activate Adapty SDK asynchronously
    Task {
      do {
        try await Adapty.activate(with: config)
      } catch {
        // Handle error appropriately for your app
        print("Adapty activation failed: ", error)
      }
    }

    var body: some Scene {
      WindowGroup {
        // Your content view
      }
    }
  }
}

// In your AppDelegate class:
// If you only use an AppDelegate, place the following code in the
// application(_:didFinishLaunchingWithOptions:) method.

// If you use a SceneDelegate, place the following code in the
// scene(_:willConnectTo:options:) method.


Task {
  do {
    let configurationBuilder = AdaptyConfiguration
      .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Get from Adapty dashboard
      .with(logLevel: .verbose) // recommended for development and the first production release

    let config = configurationBuilder.build()
    try await Adapty.activate(with: config)
  } catch {
    // Handle error appropriately for your app
    print("Adapty activation failed: ", error)
  }
}

Ahora configura los paywalls en tu app:

• Si usas el Adapty Paywall Builder, primero activa el módulo AdaptyUI a continuación, y luego sigue la guía de inicio rápido del Paywall Builder.
• Si construyes tu propia interfaz de paywall, consulta la guía de inicio rápido para paywalls personalizados.

Activar el módulo AdaptyUI del SDK de Adapty

Si planeas usar el Paywall Builder y has instalado el módulo AdaptyUI, también necesitas activar AdaptyUI.

@main
struct YourApp: App {
  init() {
    // ...ConfigurationBuilder steps

    // Activate Adapty SDK asynchronously
    Task {
      do {
        try await Adapty.activate(with: config)
        try await AdaptyUI.activate()
      } catch {
        // Handle error appropriately for your app
        print("Adapty activation failed: ", error)
      }
    }

    // main body...
  }
}

// If you only use an AppDelegate, place the following code in the
// application(_:didFinishLaunchingWithOptions:) method.

// If you use a SceneDelegate, place the following code in the
// scene(_:willConnectTo:options:) method.


Task {
   do {
      let configurationBuilder = AdaptyConfiguration
         .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Get from Adapty dashboard
         .with(logLevel: .verbose) // recommended for development

   let config = configurationBuilder.build()
   try await Adapty.activate(with: config)
   try await AdaptyUI.activate()
      } catch {
      // Handle error appropriately for your app
      print("Adapty activation failed: ", error)
   }
}

Configuración opcional

Registro de eventos

Configurar el sistema de registro

Adapty registra errores e información importante para ayudarte a entender qué está ocurriendo. Los niveles disponibles son:

 let configurationBuilder = AdaptyConfiguration
         .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
         .with(logLevel: .verbose) // recommended for development

Redirigir los mensajes del sistema de registro

Si necesitas enviar los mensajes de registro de Adapty a tu sistema o guardarlos en un archivo, usa el método setLogHandler e implementa tu lógica de registro personalizada dentro de él. Este handler recibe registros con el contenido del mensaje y su nivel de severidad.

Adapty.setLogHandler { record in
    writeToLocalFile("Adapty \(record.level): \(record.message)")
}

Políticas de datos

Adapty no almacena datos personales de tus usuarios a menos que los envíes explícitamente, pero puedes implementar políticas adicionales de seguridad de datos para cumplir con las directrices de la store o de tu país.

Deshabilitar la recopilación y el uso compartido del IDFA

Al activar el módulo Adapty, establece idfaCollectionDisabled en true para deshabilitar la recopilación y el uso compartido del IDFA.

Usa este parámetro para cumplir con las directrices de revisión del App Store o para evitar activar el prompt de App Tracking Transparency cuando el IDFA no es necesario para tu app. El valor predeterminado es false. Para más detalles sobre la recopilación del IDFA, consulta la sección de Integración de analíticas.

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
        .with(idfaCollectionDisabled: true)

Deshabilitar la recopilación y el uso compartido de la IP

Al activar el módulo Adapty, establece ipAddressCollectionDisabled en true para deshabilitar la recopilación y el uso compartido de la dirección IP del usuario. El valor predeterminado es false.

Usa este parámetro para mejorar la privacidad del usuario, cumplir con normativas regionales de protección de datos (como el RGPD o el CCPA) o reducir la recopilación de datos innecesaria cuando las funciones basadas en IP no son necesarias para tu app.

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
        .with(ipAddressCollectionDisabled: true)

Configuración de caché de medios para paywalls en AdaptyUI

Ten en cuenta que la configuración de AdaptyUI es opcional. Puedes activar el módulo AdaptyUI sin su configuración. Sin embargo, si usas la configuración, todos los parámetros son obligatorios.

// Configure AdaptyUI
        let adaptyUIConfiguration = AdaptyUI.Configuration(
            mediaCacheConfiguration: .init(
                memoryStorageTotalCostLimit: 100 * 1024 * 1024,
                memoryStorageCountLimit: .max,
                diskStorageSizeLimit: 100 * 1024 * 1024
            )
        )

        // Activate AdaptyUI
        AdaptyUI.activate(configuration: adaptyUIConfiguration)

Parámetros:

Comportamiento de finalización de transacciones

Por defecto, Adapty finaliza las transacciones automáticamente tras una validación exitosa. Sin embargo, si necesitas una validación avanzada de transacciones (como validación de recibos en el servidor, detección de fraude o lógica de negocio personalizada), puedes configurar el SDK para usar la finalización manual de transacciones.

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(transactionsFinishBehavior: .manual) // .auto is the default

Consulta más detalles sobre cómo finalizar transacciones en la guía.

Borrar datos al restaurar desde copia de seguridad

Cuando clearDataOnBackup está establecido en true, el SDK detecta cuándo la app se restaura desde una copia de seguridad de iCloud y elimina todos los datos del SDK almacenados localmente, incluida la información de perfil en caché, los detalles de productos y los paywalls. El SDK se inicializa entonces con un estado limpio. El valor predeterminado es false.

let configurationBuilder = AdaptyConfiguration
    .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY")
    .with(clearDataOnBackup: true) // default – false

Resolución de problemas

Error de concurrencia de Swift 6 con Tuist

Al compilar con Tuist, puede que veas errores de compilación de concurrencia estricta de Swift 6. Los síntomas habituales incluyen errores de compatibilidad con el atributo @Sendable en AdaptyUIBuilderLogic u otros errores de Sendability entre módulos.

Esto ocurre porque Tuist genera proyectos Xcode a partir de paquetes SPM pero no conserva la configuración swift-tools-version: 6.0. Como resultado, algunos targets de Adapty (Adapty, AdaptyUI, AdaptyUIBuilder) se compilan con las reglas de Swift 5 mientras que otros usan Swift 6, lo que genera errores de @Sendable entre módulos.

Solución: Actualiza al SDK de Adapty 3.15.5 o posterior, que resuelve el problema independientemente de las versiones mixtas de Swift.

Solución alternativa: Si no puedes actualizar, establece explícitamente Swift 6 para los tres targets de Adapty en tu configuración de Tuist:

targetSettings: [
  "Adapty": .init().swiftVersion("6"),
  "AdaptyUI": .init().swiftVersion("6"),
  "AdaptyUIBuilder": .init().swiftVersion("6"),
]

Errores de compilación de Swift 6 causados por la sobreescritura de SWIFT_VERSION en el Podfile

Al compilar para iOS con CocoaPods, puede que veas errores de compilación de Swift 6 en los targets de los pods de Adapty. Los síntomas habituales incluyen errores de @Sendable en AdaptyUIBuilderLogic, falta de conformidad con Sendable en tipos de Adapty, o errores de aislamiento de actores.

Los pods de Adapty declaran s.swift_version = '6.0' y requieren Swift 6 para compilar. Tu propio código de la app puede permanecer en Swift 5 — solo los targets de los pods de Adapty (Adapty, AdaptyUI, AdaptyUIBuilder, AdaptyLogger) necesitan compilarse con Swift 6.

La causa más común es un hook post_install en tu Podfile que sobreescribe SWIFT_VERSION para cada target de pod:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['SWIFT_VERSION'] = '5.9'
    end
  end
end

Solución: Excluye los targets de los pods de Adapty de la sobreescritura:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    next if %w[Adapty AdaptyUI AdaptyUIBuilder AdaptyLogger].include?(target.name)
    target.build_configurations.each do |config|
      config.build_settings['SWIFT_VERSION'] = '5.9'
    end
  end
end

Luego ejecuta pod install y vuelve a compilar.

Para verificarlo, abre Pods.xcodeproj, selecciona el target del pod Adapty → Build Settings → Swift Language Version. Debería ser Swift 6.