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

نظرة عامة

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

نزّل SDK من بوابة AKS: اختر iOS ثم انقر على تنزيل — سيؤدي ذلك إلى تنزيل ملف .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 تم تنزيله»، وليس سلسلة إصدار تُحدّثها في ملف تعريف الحزمة.