Tổng quan

Hướng dẫn này trình bày mọi thứ bạn cần để tích hợp AppsKitSDK (AKS) vào ứng dụng iOS: thêm các framework vào dự án, cấu hình 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 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ộ nhị phân .xcframework đã biên dịch 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 để cài qua CocoaPods/SPM:

• AKSKit.xcframework — bộ máy cốt lõi: tải quảng cáo/mediation, cấu hình từ xa, sự kiện và ghi log. Các lớp của framework này được xuất 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 facade bằng Swift bao bọc AKSKit, cung cấp giao diện dễ dùng hơn và theo quy ước Swift: AppsKitSDKAdsManagerIOS, AKSBaseAppDelegate và các trình xử lý quảng cáo riêng cho từng mạng quảng cáo. Đây là lớp facade đượ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 hệ thống phân phối gói dành cho iOS, nên "AKS mới nhất cho iOS" có nghĩa 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.