التوثيق · التكامل مع iOS

نظرة عامة

يغطي هذا الدليل كل ما تحتاج إليه لدمج AppsKitSDK (AKS) في تطبيق iOS: إضافة أطر العمل إلى مشروعك، وإعداد Podfile وInfo.plist، وتهيئة SDK، واستدعاء جميع تنسيقات الإعلانات، والأحداث وتسجيل السجلات، والتخزين المحلي، وأدوات تصحيح الأخطاء المدمجة.

نزّل SDK من بوابة AKS: اختر iOS وانقر على Download — سيؤدي ذلك إلى تنزيل ملف .zip يحتوي على مجلدات .xcframework.

يُوزَّع AKS على هيئة حزمتين ثنائيتين جاهزتين بصيغة .xcframework تضيفهما مباشرةً إلى مشروع Xcode — ولا يتوفر AKS نفسه كحزمة يمكن إضافتها عبر CocoaPods أو SPM:

  • AKSKit.xcframework — المحرك الأساسي: تحميل الإعلانات والتوسّط الإعلاني، والإعدادات عن بُعد، والأحداث، وتسجيل السجلات. تُصدَّر أصنافه عبر آلية التشغيل البيني مع Objective-C، لذا تتضمن بعض تواقيع الدوال أنواعًا ذات طابع Kotlin (مثل PlatformContext وKotlinInt? وغيرها) بدلًا من أنواع Swift الأصلية بالكامل — وستلاحظ ذلك في مواضع متعددة من الدليل.
  • AppsKit.xcframework — واجهة مبسّطة مكتوبة بلغة Swift تغلّف AKSKit وتوفّر واجهة أسهل استخدامًا ومتوافقة مع أسلوب Swift المعتاد: AppsKitSDKAdsManagerIOS وAKSBaseAppDelegate ومعالجات الإعلانات الخاصة بكل شبكة. يعتمد هذا الدليل على هذه الواجهة المبسّطة.

احصل على أحدث إصدار من مجلدَي .xcframework بتنزيل أحدث ملف zip من بوابة AKS — لا يتوفر حاليًا بديل عبر سجل حزم لنظام iOS، لذا فإن «أحدث إصدار من AKS لنظام iOS» يعني «أحدث ملف zip متاح للتنزيل»، وليس رقم إصدار ترفعه في ملف تعريف الحزمة.