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 dưới dạng 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 dự á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 phân giải 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 ghim phiên bản để luôn dùng bản mới nhất (đồng thời kéo theo GoogleUserMessagingPlatform dưới dạng phụ thuộc bắc cầu), IronSourceSDK 9.1.0.0, Adjust 5.4.6, AppsFlyerFramework/AppsFlyer-AdRevenue 6.14.3, AppLovinSDK 13.5.0. Hãy xem đây là bộ phiên bản cơ sở đã được xác nhận hoạt động, không phải các phiên bản bắt buộc phải ghim — bạn có thể nâng phiên bản theo nhu cầu của ứng dụng, nhưng phải giữ IPHONEOS_DEPLOYMENT_TARGET ở mức 15.0 trở lên để khớp với phiên bản iOS mục tiêu dùng khi build AppsKit.xcframework/AKSKit.xcframework.

Dòng DEBUG_INFORMATION_FORMAT = 'dwarf-with-dsym' trong post_install không phải là cấu hình tùy chọn chỉ để cho đẹp — 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 crash không hoạt động và có thể khiến quá trình 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 vào chính AKSKit.xcframework, nên bạn sẽ không thấy (và không cần thêm) nó trong Podfile. Ngược lại, AppsFlyer và Adjust là các pod mà ứng dụng tích hợp cần 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 Các 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 quản trị AKS của bạn bật mediation theo cơ chế bidding/waterfall thông qua AdMob cho các mạng ngoài danh sách này, hãy kiểm tra xem mạng đó có cần adapter CocoaPods riêng hay không (ví dụ: một pod GoogleMobileAdsMediation*) — hướng dẫn này chỉ mô tả những thành phần đã được xác nhận hoạt động trong ứng dụng tham chiếu.