Apps Kit SDK logoApps Kit SDK
Documentación · Integración en iOS

1. Dependencias (Podfile)

1.1 Por qué sigues necesitando un Podfile

AKSKit.xcframework/AppsKit.xcframework se enlazan directamente como frameworks binarios (§2), no como pods, pero el módulo Swift compilado de AppsKit.xcframework hace referencia a símbolos de varios SDK de terceros (Firebase, Google Mobile Ads, IronSource, Adjust, AppsFlyer, AppLovin). Estos deben estar presentes en tu árbol de dependencias a través de CocoaPods; de lo contrario, fallará el enlazado durante la compilación, aunque nunca llames directamente a la mayoría de ellos.

1.2 Pods obligatorios (siempre necesarios)

ruby
source 'https://cdn.cocoapods.org'

platform :ios, '15.0'

target 'YourApp' do
  use_frameworks!

  # Remote Config drives almost all AKS behavior; Analytics/Crashlytics back AKS events and crash reporting
  pod 'Firebase/Analytics',    '~> 12.15.0'
  pod 'Firebase/Crashlytics',  '~> 12.15.0'
  pod 'Firebase/RemoteConfig', '~> 12.15.0'

  pod 'Google-Mobile-Ads-SDK'

  # Required by AppsKit.xcframework's compiled swiftinterface — these are transitive
  # dependencies of the AKS facade itself, not direct calls you make.
  pod 'IronSourceSDK',         '~> 9.1.0.0'
  pod 'Adjust',                '~> 5.4.6'
  pod 'AppsFlyerFramework'
  pod 'AppsFlyer-AdRevenue'

  pod 'AppLovinSDK'
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'
      config.build_settings['DEBUG_INFORMATION_FORMAT'] = 'dwarf-with-dsym'
    end
  end
end

Las versiones anteriores son las que se resuelven actualmente en una integración de referencia cuyo funcionamiento está comprobado (Podfile.lock): Firebase/* 12.15.0, Google-Mobile-Ads-SDK sin fijar una versión para usar la más reciente (que incorpora GoogleUserMessagingPlatform como dependencia transitiva), IronSourceSDK 9.1.0.0, Adjust 5.4.6, AppsFlyerFramework/AppsFlyer-AdRevenue 6.14.3, AppLovinSDK 13.5.0. Considéralas una base de funcionamiento comprobado, no versiones fijas obligatorias: actualízalas según las necesidades de tu aplicación, pero mantén IPHONEOS_DEPLOYMENT_TARGET en 15.0 o superior para que sea compatible con la versión de destino usada al compilar AppsKit.xcframework/AKSKit.xcframework.

La línea DEBUG_INFORMATION_FORMAT = 'dwarf-with-dsym' de post_install no es un ajuste meramente estético ni opcional: sin ella, algunos de estos pods (en particular AppLovinSDK) no generan archivos dSYM, lo que impide la simbolicación de los informes de fallos y puede provocar errores en la validación de dSYM de App Store Connect durante la carga.

1.3 SDK de MMP

Solar Engine no es un pod que debas añadir: ya está compilado dentro del propio AKSKit.xcframework, por lo que no lo encontrarás en tu Podfile (ni necesitas añadirlo). En cambio, AppsFlyer y Adjust sí son pods que debe incluir la aplicación que integra el SDK (§1.2 anterior), porque el código Swift de AppsKit.xcframework llama directamente a los métodos de sus SDK (initializeAppsFlyer/initializeAdjust en IOSBridgeImp.swift).

1.4 SDK de redes publicitarias y mediación

El Podfile de referencia solo añade Google-Mobile-Ads-SDK, IronSourceSDK y AppLovinSDK, sin pods independientes de «adaptadores de mediación de AdMob». Si la configuración de tu portal AKS habilita la mediación por pujas (bidding) o en cascada (waterfall) a través de AdMob para otras redes además de las indicadas, comprueba si esa red necesita su propio adaptador de CocoaPods (por ejemplo, un pod GoogleMobileAdsMediation*). Esta guía solo puede documentar lo que se ha confirmado que funciona en la aplicación de referencia.