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 các 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ộ 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ó mã định danh gói để cài đặt qua CocoaPods/SPM:

• AKSKit.xcframework — bộ xử lý cốt lõi: tải/mediation quảng cáo, cấu hình từ xa, sự kiện và ghi log. Các lớp đượ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 thuần Swift — bạn sẽ gặp điều này xuyên suốt hướng dẫn.
• AppsKit.xcframework — lớp facade 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 cho từng mạng quảng cáo. Hướng dẫn này tập trung vào cách sử dụng lớp facade 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 đăng ký gói dành cho iOS, nên "AKS mới nhất cho iOS" 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.