Instalar y configurar el SDK de iOS

El SDK de Adapty incluye dos módulos principales para integrarse fácilmente 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 sin código y fácil de usar para crear paywalls multiplataforma.

Para ver un recorrido completo de la 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 a través de 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 planeas usar Paywall Builder)
   Nota:

   • Para habilitar el Modo Kids en SDK 3.x, selecciona Adapty_KidsMode en lugar de Adapty. En SDK 4.0 y versiones posteriores, selecciona los módulos normales — el Modo Kids se habilita mediante el trait de paquete KidsMode.
   • 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) en Package Dependencies.

Activa el módulo Adapty del SDK

Activa el SDK 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.

O bien, obtenla de forma programática usando el Adapty CLI:

npm install -g adapty
adapty auth login
adapty apps list

O directamente:

npx adapty auth login
adapty apps list

• Asegúrate de usar la Public SDK key para inicializar Adapty; la Secret key solo debe usarse para la API del lado del servidor.
• Las SDK keys son únicas para cada app, así que si tienes varias apps asegúrate de elegir la correcta.

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

Activar el módulo AdaptyUI del SDK

Si tienes previsto 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

Configura el sistema de registro

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

 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 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 de la store o del país.

Deshabilitar la recopilación y el uso compartido de IDFA

Al activar el módulo de Adapty, establece idfaCollectionDisabled en true para deshabilitar la recopilación y el uso compartido de IDFA. Usa 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 detalles 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)

Desactivar 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 intercambio de la dirección IP del usuario. El valor predeterminado es false.

Usa este parámetro para mejorar la privacidad del usuario, cumplir con las 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 de finalización de transacciones

Por defecto, Adapty finaliza automáticamente las transacciones 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 que use 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 se establece 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

Solución de problemas

Error de concurrencia de Swift 6 con Tuist

Al compilar con Tuist, puedes encontrarte con errores de compilación de concurrencia estricta de Swift 6. Los síntomas habituales incluyen desajustes 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 el ajuste 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 incompatibilidades 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 del lenguaje Swift.

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"),
]