概述

本指南涵盖将 AppsKitSDK (AKS) 集成到 iOS 应用所需的全部内容：将框架添加到项目、配置 Podfile 和 Info.plist、初始化 SDK、调用各类广告格式、事件与日志、本地存储，以及内置调试工具。

从 AKS Portal 下载 SDK：选择 iOS，然后点击 Download，即可下载包含 .xcframework 文件夹的 .zip 文件。

AKS 以两个预编译的 .xcframework 二进制框架分发，需要直接添加到 Xcode 项目中；AKS 本身不提供 CocoaPods/SPM 包依赖：

• AKSKit.xcframework — 核心引擎：负责广告加载与聚合、远程配置、事件和日志。其类通过 Objective-C 互操作机制导出，因此部分签名使用带有 Kotlin 特征的类型（如 PlatformContext、KotlinInt? 等），而非完全原生的 Swift 类型。本指南中会多次出现这些类型。
• AppsKit.xcframework — Swift 封装层，为 AKSKit 提供更易用、更符合 Swift 习惯的接口，包括 AppsKitSDKAdsManagerIOS、AKSBaseAppDelegate 以及各广告平台的处理器。本指南以这一封装层为基础展开。

从 AKS Portal 下载最新的 zip 压缩包，即可获取最新的一对 .xcframework 文件夹。目前 iOS 版本尚未通过包注册中心分发，因此“最新版 iOS AKS”指的是“最新下载的 zip 压缩包”，而不是在依赖清单中更新某个版本号。