概要

このガイドでは、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 らしい使いやすい API を提供するファサードです。AppsKitSDKAdsManagerIOS、AKSBaseAppDelegate、広告ネットワークごとの広告ハンドラーが含まれます。このガイドでは、このファサードを中心に説明します。

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