نظرة عامة

يغطي هذا الدليل كل ما تحتاج إليه لدمج 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 مُنزَّل»، وليس سلسلة إصدار تُحدّثها في ملف بيان الحزمة.