Tổng quan

Hướng dẫn này trình bày mọi bước cần thiết để tích hợp AppsKitSDK (AKS) vào ứng dụng iOS: thêm framework vào dự án, thiết lập Podfile và Info.plist, khởi tạo SDK, gọi từng định dạng quảng cáo, xử lý sự kiện và ghi log, lưu trữ cục bộ, cũng như sử dụng các công cụ gỡ lỗi tích hợp sẵn.

Tải SDK từ AKS Portal: chọn iOS rồi nhấp vào Download — thao tác này sẽ tải xuống một tệp .zip chứa các thư mục .xcframework.

AKS được phân phối dưới dạng hai bộ thư viện nhị phân .xcframework dựng sẵn để bạn thêm trực tiếp vào dự án Xcode — bản thân AKS không có định danh gói trên CocoaPods/SPM:

• AKSKit.xcframework — bộ xử lý cốt lõi: tải quảng cáo/điều phối quảng cáo (mediation), cấu hình từ xa, sự kiện và ghi log. Các lớp của thư viện được cung cấp thông qua cơ chế tương tác với Objective-C, nên một số chữ ký hàm sử dụng các kiểu mang đặc trưng Kotlin (PlatformContext, KotlinInt?, v.v.) thay vì các kiểu Swift thuần — bạn sẽ gặp điều này xuyên suốt hướng dẫn.
• AppsKit.xcframework — lớp giao diện Swift (facade) bọc AKSKit, cung cấp API dễ dùng hơn và phù hợp với phong cách Swift: AppsKitSDKAdsManagerIOS, AKSBaseAppDelegate và các trình xử lý quảng cáo cho từng mạng quảng cáo. Đây là lớp giao diện được sử dụng xuyên suốt hướng dẫn này.

Để lấy cặp thư mục .xcframework mới nhất, hãy tải tệp zip mới nhất từ AKS Portal — hiện chưa có gói tương ứng trên kho quản lý gói cho iOS, nên "AKS mới nhất cho iOS" chính là "tệp zip mới nhất được tải xuống", chứ không phải một chuỗi phiên bản mà bạn cập nhật trong tệp manifest.