Instalar y configurar el SDK de iOS

El SDK de Adapty incluye dos módulos clave para una integración fluida en tu app móvil:

• Core Adapty: Este SDK esencial es necesario para que Adapty funcione correctamente en tu app.
• AdaptyUI: Este módulo opcional es necesario si usas el Adapty Paywall Builder, una herramienta no-code y fácil de usar para crear paywalls multiplataforma.

Para una guía completa de implementación, 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

El SDK de Adapty se instala mediante Swift Package Manager. En Xcode, ve a File -> Add Package Dependency…. Ten en cuenta que los pasos para añadir dependencias de paquetes pueden variar entre versiones de Xcode, así que consulta la documentación de Xcode si es necesario.

1. Introduce la URL del repositorio:

   https://github.com/adaptyteam/AdaptySDK-iOS.git

2. Selecciona la versión (se recomienda la última versión estable) y haz clic en Add Package.
3. En la ventana Choose Package Products, selecciona los módulos que necesites:
   • Adapty (módulo principal)
   • AdaptyUI (opcional - solo si piensas usar el Paywall Builder)
   Nota:

   • Para activar el modo Kids, selecciona Adapty_KidsMode en lugar de Adapty.
   • No selecciones ningún otro paquete de la lista — no los necesitarás.
4. Haz clic en Add Package para completar la instalación.
5. Verifica la instalación: En el navegador de tu proyecto deberías ver “Adapty” (y “AdaptyUI” si lo seleccionaste) bajo Package Dependencies.

Activar el módulo Adapty del SDK

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 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 UI para los paywalls, consulta la guía de inicio rápido para paywalls personalizados.

Activar el módulo AdaptyUI del SDK

Si planeas usar 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

Configurar el sistema de registro

Adapty registra errores y otra información importante para ayudarte a entender qué está ocurriendo. Hay los siguientes niveles disponibles:

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

Redirigir los mensajes del sistema de logging

Si necesitas enviar los mensajes de log de Adapty a tu propio sistema o guardarlos en un archivo, usa el método setLogHandler e implementa tu lógica de logging personalizada dentro de él. Este handler recibe registros de log que contienen el contenido del mensaje y el 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 de seguridad de datos adicionales para cumplir con las directrices del store o del país.

Desactivar la recopilación y el uso compartido del IDFA

Al activar el módulo de Adapty, establece idfaCollectionDisabled en true para desactivar la recopilación y el uso compartido del IDFA. Utiliza este parámetro para cumplir con las directrices de revisión de la App Store o evitar que aparezca el aviso de App Tracking Transparency cuando tu app no necesita el IDFA. El valor predeterminado es false. Para más información sobre la recopilación del IDFA, consulta la sección 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 de 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 reforzar la privacidad del usuario, cumplir con normativas regionales de protección de datos (como GDPR o 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 al finalizar 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 fraudes 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á configurado como true, el SDK detecta si la app se ha restaurado desde una copia de seguridad de iCloud y elimina todos los datos almacenados localmente por el SDK, incluida la información de perfil en caché, los detalles de productos y los paywalls. A continuación, el SDK se inicializa con un estado limpio. El valor predeterminado es false.

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

Solució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 más comunes incluyen discrepancias del 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) compilan con las reglas de Swift 5 mientras que otros usan Swift 6, lo que genera incompatibilidades @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 del lenguaje Swift.

Solución temporal: 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"),
]