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 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 một bản tích hợp tham chiếu đã xác nhận hoạt động (Podfile.lock): Firebase/* 12.15.0, Google-Mobile-Ads-SDK không bị cố định phiên bản để luôn lấy bản mới nhất (đồng thời kéo theo GoogleUserMessagingPlatform dưới dạng 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 xem đây là bộ phiên bản cơ sở đã 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 phiên bản theo nhu cầu của ứng dụng, nhưng hãy giữ IPHONEOS_DEPLOYMENT_TARGET ở mức 15.0 trở lên để phù hợp với mức mà AppsKit.xcframework/AKSKit.xcframework được build cho.

Dòng DEBUG_INFORMATION_FORMAT = 'dwarf-with-dsym' trong post_install không phải là thiết lập 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 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 (và cũng 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 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 hình thức 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 thành phần đã được xác nhận hoạt động trong ứng dụng tham chiếu.