개요

이 가이드는 iOS 앱에 AppsKitSDK (AKS)를 연동하는 데 필요한 모든 과정을 다룹니다. 프로젝트에 프레임워크 추가, Podfile 및 Info.plist 설정, SDK 초기화, 각 광고 형식 호출, 이벤트 및 로깅, 로컬 저장소, 내장 디버그 도구까지 안내합니다.

AKS Portal에서 SDK를 다운로드하세요. iOS를 선택하고 Download를 클릭하면 .xcframework 폴더가 포함된 .zip 파일이 다운로드됩니다.

AKS는 Xcode 프로젝트에 직접 추가하는 사전 빌드된 .xcframework 바이너리 두 개로 배포됩니다. AKS 자체는 CocoaPods/SPM 패키지로 제공되지 않습니다.

• AKSKit.xcframework — 광고 로드 및 미디에이션, 원격 구성, 이벤트, 로깅을 담당하는 핵심 엔진입니다. 클래스는 Objective-C 상호 운용 계층을 통해 노출되므로, 일부 시그니처에는 네이티브 Swift 타입 대신 Kotlin 계열 타입(PlatformContext, KotlinInt? 등)이 사용됩니다. 이 가이드 전반에서 이러한 타입을 볼 수 있습니다.
• AppsKit.xcframework — AKSKit을 감싸 더 쉽고 Swift 스타일에 맞는 인터페이스를 제공하는 Swift 파사드입니다. AppsKitSDKAdsManagerIOS, AKSBaseAppDelegate, 광고 네트워크별 광고 핸들러가 포함됩니다. 이 가이드는 이 파사드를 중심으로 설명합니다.

AKS Portal에서 최신 zip 파일을 다운로드하여 최신 .xcframework 폴더 두 개를 받으세요. 현재 iOS용 AKS는 패키지 레지스트리를 통해 제공되지 않습니다. 따라서 "최신 iOS용 AKS"란 매니페스트에서 버전 문자열을 올리는 것이 아니라 "가장 최근에 배포된 zip 파일"을 의미합니다.