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). Esses SDKs precisam estar presentes no grafo de dependências via CocoaPods; caso contrário, a 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 são as resolvidas atualmente 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-as como uma base validada, não como versões obrigatoriamente fixas — atualize conforme as necessidades do seu app, mas mantenha IPHONEOS_DEPLOYMENT_TARGET em 15.0 ou superior para corresponder ao alvo de implantação usado na compilação de AppsKit.xcframework/AKSKit.xcframework.

A linha DEBUG_INFORMATION_FORMAT = 'dwarf-with-dsym' em post_install não é um mero ajuste cosmético opcional — sem ela, alguns desses pods (especialmente AppLovinSDK) não geram dSYMs, o que impede a simbolicação dos relatórios de crash 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á no seu Podfile (nem precisa adicioná-lo). Já AppsFlyer e Adjust são pods que precisam 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 no portal AKS habilitar mediação por lances (bidding) ou em cascata (waterfall) via AdMob para redes além das listadas, verifique se a rede precisa de um adaptador próprio via CocoaPods (por exemplo, um pod GoogleMobileAdsMediation*) — este guia documenta apenas o que tem funcionamento confirmado no app de referência.