تثبيت SDK — iOS
1. أضف حزمة SDK
Section titled “1. أضف حزمة SDK”يرسل لك AD80 الملف AD80-iOS-SDK-<version>.zip مع مجموع التحقق SHA-256 الخاص به. استخدم الإصدار الذي يصلك من
AD80؛ لا تحتاج إلى تنزيل SDK من GitHub أو إضافة مستودع AD80 بعيد في Xcode.
قارن مجموع التحقق للملف بالقيمة التي أرسلها لك AD80، ثم فك الضغط. داخل مجلد AD80-iOS-SDK تحقّق من محتوياته:
shasum -a 256 -c SHA256SUMSيحتوي المجلد على:
Frameworks/Ad80Core.xcframeworkFrameworks/Ad80.xcframeworkFrameworks/Ad80GoogleMobileAds.xcframeworkPackage.swiftSources/Ad80GoogleMobileAdsSupport/README.md, INTEGRATION.md, CHANGELOG.md, SHA256SUMSSDK مترجم داخل ملفات XCFramework. أما Package.swift والملفات الصغيرة المساعدة للحزمة فتتيح لـ Xcode إضافة
الأطر المترجمة واعتمادياتها، ولا تحتوي على الشيفرة التي تنفّذ وظائف SDK.
أضف حزمة Swift المحلية (الموصى به)
Section titled “أضف حزمة Swift المحلية (الموصى به)”- ضع مجلد
AD80-iOS-SDKبعد فك الضغط في مكان ثابت بجانب مشروع Xcode، واحتفظ باسم المجلد. - في Xcode اختر File → Add Package Dependencies → Add Local… وحدّد المجلد.
- أضف المنتجين Ad80 وAd80GoogleMobileAds إلى هدف التطبيق. يضيف Xcode تلقائياً Google Mobile Ads 13.11.0 ويضمّن الأطر الديناميكية المطلوبة.
إن كان تطبيقك يستخدم Google Mobile Ads بالفعل، فأبقِه على الإصدار 13.11.0 بالضبط؛ اختلاف الإصدارات في مجموعة الاعتماديات نفسها يمنع إضافتها. تُجلب مكتبة Google من حزمة Google، بينما يبقى SDK الخاص بـ AD80 محلياً.
إن كنت تستخدم ملف حزمة خاصاً بك، فالاعتمادية هي مسار محلي:
// In your Package.swift:dependencies: [.package(path: "../AD80-iOS-SDK")],targets: [.target(name: "App", dependencies: [ .product(name: "Ad80", package: "AD80-iOS-SDK"), .product(name: "Ad80GoogleMobileAds", package: "AD80-iOS-SDK"),])]إضافة الأطر يدوياً
Section titled “إضافة الأطر يدوياً”يمكنك بدلاً من ذلك إضافة ملفات XCFramework الثلاثة إلى هدف التطبيق. اختر Embed & Sign لـ Ad80 وAd80Core،
وDo Not Embed لـ Ad80GoogleMobileAds لأنه ثابت. أضف Google Mobile Ads 13.11.0 بشكل منفصل، وأضف -ObjC
إلى Other Linker Flags. يحتوي إطار Ad80 على بيان الخصوصية؛ احتفظ به عند تضمين الإطار.
2. سجّل التطبيق وأعدّ Info.plist
Section titled “2. سجّل التطبيق وأعدّ Info.plist”من لوحة المتابعة افتح التطبيقات وSDK، وسجّل معرّف الحزمة (bundle identifier) المطابق للبناء الذي تستخدمه،
وأنشئ مفتاح رفع (ad80_ik_...). راجع التطبيقات وإعداد SDK. كل بناء بمعرّف حزمة
مختلف يحتاج إلى تطبيق ومفتاح خاصين به.
أضف الإدخالات التالية داخل قاموس Info.plist الخاص بتطبيقك. استخدم مفتاح الرفع ونقطة الاتصال المخصّصين لإعداد AD80 لديك:
<key>AD80PublisherKey</key><string>ad80_ik_YOUR_KEY</string><key>AD80Endpoint</key><string>https://api.ad80.dev</string><!-- Optional: false disables the SDK for this process. --><key>AD80Enabled</key><true/>إن غاب المفتاح أو كانت نقطة الاتصال غير صالحة، يبقى SDK غير نشط (configInvalid). قيمة AD80Enabled من نوع
Boolean، وافتراضياً هي true إن لم تضفها. لإبقاء مفتاح الرفع خارج الشيفرة المحفوظة في مستودعك، استخدم إعداد بناء
مثل $(AD80_PUBLISHER_KEY) وحدّده لكل إعداد بناء توزّعه.
3. ابدأ SDK وامنح الموافقة
Section titled “3. ابدأ SDK وامنح الموافقة”استدعِ البدء مرة واحدة على الخيط الرئيسي في مفوّض التطبيق، قبل ظهور أول عرض إعلاني:
import UIKitimport Ad80import Ad80GoogleMobileAds
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { Ad80.start(integrations: [Ad80GoogleMobileAds.integration]) return true}احتفظ بتهيئة Google Mobile Ads ومسار الموافقة الموجودين في تطبيقك. لا يلتقط SDK شيئاً ولا يرسل شيئاً حتى تمنحه
الموافقة عبر Ad80.setConsent(...) عند كل بدء للتطبيق، بعد اكتمال مسار الموافقة. لشرح SwiftUI وObjective-C
وأمثلة الموافقة، راجع الموافقة والتحكم.
بعد ذلك يكتشف SDK إعلانات البانر والإعلانات الأصلية تلقائياً. أما إعلانات ملء الشاشة فتحتاج إلى استدعاء منفصل قبل كل عرض مباشرة؛ راجع الإعلانات والشبكات المدعومة. وفي النهاية اختبر الاتصال من لوحة المتابعة.