概要

このガイドでは、AppsKitSDK (AKS) を iOS アプリに組み込むために必要な手順をすべて説明します。フレームワークのプロジェクトへの追加、Podfile と Info.plist の設定、SDK の初期化、各広告フォーマットの呼び出し、イベントとログ、ローカルストレージ、組み込みのデバッグツールを取り上げます。

AKS Portal から SDK をダウンロードします。iOS を選択し、Download をクリックすると、.xcframework フォルダを含む .zip ファイルがダウンロードされます。

AKS は、ビルド済みの 2 つの .xcframework バイナリとして配布されており、Xcode プロジェクトに直接追加して使用します。AKS 自体には、CocoaPods/SPM で依存関係として指定できるパッケージはありません。

• AKSKit.xcframework — コアエンジンです。広告の読み込みとメディエーション、リモート設定、イベント、ログを処理します。クラスは Objective-C 相互運用機能を通じて公開されるため、一部のシグネチャでは、Swift ネイティブの型ではなく Kotlin 由来の型（PlatformContext、KotlinInt? など）が使われています。こうした型は、このガイドの各所に登場します。
• AppsKit.xcframework — AKSKit をラップし、より使いやすく Swift らしいインターフェースを提供する Swift ファサードです。AppsKitSDKAdsManagerIOS、AKSBaseAppDelegate、広告ネットワークごとの広告ハンドラーが含まれます。このガイドでは、このファサードを中心に説明します。

AKS Portal から最新の zip ファイルをダウンロードして、最新の .xcframework フォルダ 2 つを取得してください。現時点では、iOS 向けにパッケージレジストリ経由の配布は行われていません。そのため、「iOS 向け AKS の最新版」とは、マニフェスト内のバージョン文字列を更新して取得するものではなく、「ダウンロードした最新の zip ファイル」を指します。