概要

このガイドでは、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、各広告ネットワーク用の広告ハンドラーが含まれます。このガイドでは、このファサードを使った実装を中心に解説します。

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