1. Dependências (Podfile)

1.1 Por que você ainda precisa de um Podfile

AKSKit.xcframework/AppsKit.xcframework são vinculados diretamente como frameworks binários (§2), não como pods — mas o módulo Swift compilado de AppsKit.xcframework referencia símbolos de vários SDKs de terceiros (Firebase, Google Mobile Ads, IronSource, Adjust, AppsFlyer, AppLovin). Eles precisam estar presentes no seu grafo de dependências via CocoaPods, caso contrário, a etapa de vinculação do build falhará, mesmo que você nunca chame a maioria deles diretamente.

1.2 Pods obrigatórios (sempre necessários)

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

As versões acima correspondem às dependências atualmente resolvidas em uma integração de referência com funcionamento validado (Podfile.lock): Firebase/* 12.15.0, Google-Mobile-Ads-SDK sem versão fixada para acompanhar a mais recente (que inclui GoogleUserMessagingPlatform como dependência transitiva), IronSourceSDK 9.1.0.0, Adjust 5.4.6, AppsFlyerFramework/AppsFlyer-AdRevenue 6.14.3, AppLovinSDK 13.5.0. Use essas versões como uma base validada, não como uma restrição rígida — atualize conforme as necessidades do seu app, mas mantenha IPHONEOS_DEPLOYMENT_TARGET em 15.0 ou superior para corresponder à versão mínima usada na compilação de AppsKit.xcframework/AKSKit.xcframework.

A linha DEBUG_INFORMATION_FORMAT = 'dwarf-with-dsym' em post_install não é um mero detalhe opcional — sem ela, alguns desses pods (principalmente AppLovinSDK) não geram dSYMs, o que impede a simbolicação de relatórios de falhas e pode causar falha na validação de dSYMs do App Store Connect durante o upload.

1.3 SDKs de MMP

Solar Engine não é um pod que você precisa adicionar — ele já está compilado no próprio AKSKit.xcframework, portanto você não o encontrará (nem precisará adicioná-lo) no seu Podfile. AppsFlyer e Adjust, por outro lado, são pods que devem ser adicionados pelo app que integra o SDK (§1.2 acima), porque o código Swift de AppsKit.xcframework chama diretamente os métodos reais desses SDKs (initializeAppsFlyer/initializeAdjust em IOSBridgeImp.swift).

1.4 SDKs de redes de anúncios / mediação

O Podfile de referência adiciona apenas Google-Mobile-Ads-SDK, IronSourceSDK e AppLovinSDK — sem pods separados de "adaptadores de mediação do AdMob". Se a configuração do seu portal AKS habilitar a mediação por lances (bidding) ou em cascata (waterfall) pelo AdMob para redes além das listadas, verifique se cada rede precisa de um adaptador CocoaPods próprio (por exemplo, um pod GoogleMobileAdsMediation*) — este guia só documenta o que tem funcionamento confirmado no app de referência.