1. Thư viện phụ thuộc (Podfile)

1.1 Vì sao bạn vẫn cần Podfile

AKSKit.xcframework/AppsKit.xcframework được liên kết trực tiếp dưới dạng framework nhị phân (§2), không phải pod — nhưng mô-đun Swift đã biên dịch của AppsKit.xcframework tham chiếu đến các symbol từ một số SDK bên thứ ba (Firebase, Google Mobile Ads, IronSource, Adjust, AppsFlyer, AppLovin). Các SDK này phải có trong cây phụ thuộc của bạn thông qua CocoaPods, nếu không quá trình build sẽ thất bại ở bước liên kết, dù bạn không trực tiếp gọi hầu hết các SDK đó.

1.2 Các pod bắt buộc (luôn cần có)

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

Các phiên bản trên là những phiên bản hiện được xác định trong bản tích hợp tham chiếu đã được xác nhận hoạt động (Podfile.lock): Firebase/* 12.15.0, Google-Mobile-Ads-SDK không được cố định phiên bản để theo bản mới nhất (đồng thời kéo theo GoogleUserMessagingPlatform như một phụ thuộc gián tiếp), IronSourceSDK 9.1.0.0, Adjust 5.4.6, AppsFlyerFramework/AppsFlyer-AdRevenue 6.14.3, AppLovinSDK 13.5.0. Hãy coi đây là bộ phiên bản cơ sở đã được xác nhận hoạt động, không phải yêu cầu cố định phiên bản — bạn có thể nâng cấp theo nhu cầu của ứng dụng, nhưng cần giữ IPHONEOS_DEPLOYMENT_TARGET ở mức 15.0 trở lên để phù hợp với mục tiêu triển khai được dùng khi build AppsKit.xcframework/AKSKit.xcframework.

Dòng DEBUG_INFORMATION_FORMAT = 'dwarf-with-dsym' trong post_install không phải là thiết lập phụ có thể bỏ qua — nếu thiếu dòng này, một số pod (đặc biệt là AppLovinSDK) sẽ không tạo dSYM, khiến việc giải mã symbol trong báo cáo sự cố không hoạt động và có thể khiến bước xác thực dSYM của App Store Connect thất bại khi tải lên.

1.3 Các SDK MMP

Solar Engine không phải là pod bạn cần thêm — SDK này đã được biên dịch sẵn vào chính AKSKit.xcframework, nên bạn sẽ không thấy nó (và cũng không cần thêm nó) trong Podfile. Ngược lại, AppsFlyer và Adjust là các pod mà phía ứng dụng tích hợp phải thêm (§1.2 ở trên), vì mã Swift của AppsKit.xcframework gọi trực tiếp các phương thức SDK thực tế của chúng (initializeAppsFlyer/initializeAdjust trong IOSBridgeImp.swift).

1.4 SDK mạng quảng cáo / mediation

Podfile tham chiếu chỉ thêm Google-Mobile-Ads-SDK, IronSourceSDK và AppLovinSDK — không có pod "AdMob mediation adapter" riêng. Nếu cấu hình trên cổng AKS của bạn bật mediation theo cơ chế bidding/waterfall qua AdMob cho các mạng ngoài danh sách trên, hãy kiểm tra xem mạng đó có cần adapter CocoaPods riêng hay không (ví dụ: pod GoogleMobileAdsMediation*) — hướng dẫn này chỉ mô tả những gì đã được xác nhận hoạt động trong ứng dụng tham chiếu.