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 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 versões atualmente resolvidas em uma integração de referência com funcionamento comprovado (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 versões obrigatórias — 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' no post_install não é um mero ajuste estético 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 precisa adicioná-lo) no seu Podfile. AppsFlyer e Adjust, por outro lado, são pods que precisam ser adicionados pelo app que integra o SDK (§1.2 acima), pois o código Swift de AppsKit.xcframework chama diretamente os métodos dos SDKs correspondentes (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 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 só pode documentar o que tem funcionamento confirmado no app de referência.