تخطَّ إلى المحتوى

تثبيت SDK — iOS

يرسل لك AD80 الملف AD80-iOS-SDK-<version>.zip مع مجموع التحقق SHA-256 الخاص به. استخدم الإصدار الذي يصلك من AD80؛ لا تحتاج إلى تنزيل SDK من GitHub أو إضافة مستودع AD80 بعيد في Xcode.

قارن مجموع التحقق للملف بالقيمة التي أرسلها لك AD80، ثم فك الضغط. داخل مجلد AD80-iOS-SDK تحقّق من محتوياته:

Terminal window
shasum -a 256 -c SHA256SUMS

يحتوي المجلد على:

Frameworks/Ad80Core.xcframework
Frameworks/Ad80.xcframework
Frameworks/Ad80GoogleMobileAds.xcframework
Package.swift
Sources/Ad80GoogleMobileAdsSupport/
README.md, INTEGRATION.md, CHANGELOG.md, SHA256SUMS

SDK مترجم داخل ملفات XCFramework. أما Package.swift والملفات الصغيرة المساعدة للحزمة فتتيح لـ Xcode إضافة الأطر المترجمة واعتمادياتها، ولا تحتوي على الشيفرة التي تنفّذ وظائف SDK.

أضف حزمة Swift المحلية (الموصى به)

Section titled “أضف حزمة Swift المحلية (الموصى به)”
  1. ضع مجلد AD80-iOS-SDK بعد فك الضغط في مكان ثابت بجانب مشروع Xcode، واحتفظ باسم المجلد.
  2. في Xcode اختر File → Add Package Dependencies → Add Local… وحدّد المجلد.
  3. أضف المنتجين 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"),
])]

يمكنك بدلاً من ذلك إضافة ملفات 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 لديك:

Info.plist
<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 UIKit
import Ad80
import 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 إعلانات البانر والإعلانات الأصلية تلقائياً. أما إعلانات ملء الشاشة فتحتاج إلى استدعاء منفصل قبل كل عرض مباشرة؛ راجع الإعلانات والشبكات المدعومة. وفي النهاية اختبر الاتصال من لوحة المتابعة.