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

تثبيت SDK — Android

  1. أنشئ التطبيق ومفتاح رفع من لوحة المتابعة: التطبيقات وSDK ← أضف تطبيقاً (بمعرّف applicationId كما هو تماماً) ← أنشئ مفتاح رفع. انسخ المفتاح (ad80_ik_...)، فهو يظهر مرة واحدة فقط. راجع التطبيقات وإعداد SDK.

  2. فك ضغط الحزمة وأضف SDK (الشرح بالأسفل).

  3. أضف إدخالات ملف manifest (الشرح بالأسفل).

  4. امنح الموافقة في الكود عبر Ad80.setConsent(...). راجع الموافقة والتحكم.

  5. تحقّق من الاتصال في لوحة المتابعة. راجع اختبر الربط.

يرسل لك AD80 حزمة SDK المترجمة في ملف zip واحد مع مجموع التحقق (checksum) الخاص به. وفيها ملفات مترجمة فقط، بلا شيفرة مصدرية، ولا تحتاج إلى صلاحية الوصول إلى أي مستودع. أما مفتاح الناشر ونقطة الاتصال فتأتيك من لوحة المتابعة. و Google Mobile Ads SDK ليس في الحزمة: يبقى اعتمادية خاصة بك من مستودع Maven الخاص بـ Google.

محتويات الملف (والقيمة <version> هي الإصدار الظاهر في أسماء ملفات حزمتك):

maven/ Local Maven repository (dev.ad80:ad80-sdk-android and dev.ad80:ad80-sdk-core)
aar/ ad80-sdk-android-<version>.aar
jar/ ad80-sdk-core-<version>.jar
docs/ INTEGRATION.md
README.md, CHANGELOG.md, SHA256SUMS

بعد فك الضغط، تحقّق من الملفات بالأمر sha256sum -c SHA256SUMS (على macOS: shasum -a 256 -c SHA256SUMS).

الخيار أ: مستودع Maven المحلي (الموصى به)

Section titled “الخيار أ: مستودع Maven المحلي (الموصى به)”

فك ضغط الحزمة في مكان ثابت، مثل third_party/ad80/. عندها يحلّ Gradle اعتماديات SDK نفسه عنك.

settings.gradle.kts
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven { url = uri("third_party/ad80/maven") } // path to the unzipped maven/ folder
}
}
app/build.gradle.kts
dependencies {
implementation("dev.ad80:ad80-sdk-android:<version>")
// Your own Google Mobile Ads dependency, as before.
implementation("com.google.android.gms:play-services-ads:25.5.0")
}

الخيار ب: الملفات المنفردة

Section titled “الخيار ب: الملفات المنفردة”

انسخ المجلدين aar/ وjar/ إلى وحدة تطبيقك، مثلاً app/libs/. الملفات المنفردة لا تحمل معلومات الاعتماديات، فاكتب اعتماديات وقت التشغيل بنفسك:

app/build.gradle.kts
dependencies {
implementation(files("libs/ad80-sdk-core-<version>.jar", "libs/ad80-sdk-android-<version>.aar"))
// Runtime dependencies of the AD80 SDK (a file dependency does not bring them along).
implementation("com.google.code.gson:gson:2.14.0")
implementation("androidx.startup:startup-runtime:1.2.0")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.11.0")
// Your own Google Mobile Ads dependency, as before.
implementation("com.google.android.gms:play-services-ads:25.5.0")
}

SDK مكتوب بلغة Kotlin. لذلك إن كان تطبيقك مكتوباً بـ Java فقط (دون إضافة Kotlin لـ Gradle)، فهو يحتاج أيضاً مكتبة Kotlin القياسية بالإصدار 2.1 أو أحدث: implementation("org.jetbrains.kotlin:kotlin-stdlib:<version>").

داخل الوسم <application> في AndroidManifest.xml:

app/src/main/AndroidManifest.xml
<application>
<!-- Your app's upload key from the dashboard (Apps and SDK). -->
<meta-data
android:name="dev.ad80.PUBLISHER_KEY"
android:value="ad80_ik_YOUR_KEY" />
<!-- Where the SDK sends ads. -->
<meta-data
android:name="dev.ad80.ENDPOINT"
android:value="https://api.ad80.dev" />
<!-- Optional: false turns the SDK off for this build. -->
<meta-data
android:name="dev.ad80.ENABLED"
android:value="true" />
</application>
المفتاحمطلوب؟القيمة
dev.ad80.PUBLISHER_KEYنعممفتاح الرفع الخاص بالتطبيق، ad80_ik_....
dev.ad80.ENDPOINTنعمhttps://api.ad80.dev. يجب أن يكون https. ولا يُقبل http العادي إلا لعنوان loopback (للاختبار المحلي).
dev.ad80.ENABLEDلاالقيمة false تجعل SDK خاملاً في العملية كلها. أي قيمة أخرى، أو غياب الإدخال، يبقيه يعمل.

إن غاب المفتاح، أو غاب العنوان أو كان بصيغة خاطئة، أو كان العنوان http عادياً وليس loopback، يصبح SDK خاملاً ويُبلغ عن ConfigInvalid إلى مستمع التشخيص عندك.

إبعاد المفتاح عن نظام إدارة الكود (اختياري)

Section titled “إبعاد المفتاح عن نظام إدارة الكود (اختياري)”

مفتاح الرفع لا يرفع إعلانات إلا لتطبيق واحد، ولذلك صُمّم ليُشحن داخل التطبيق. وإن كنت تفضّل مع ذلك ألّا تضعه في المستودع، فاستخدم عنصراً نائباً في ملف manifest:

app/build.gradle.kts
android {
defaultConfig {
// Set AD80_UPLOAD_KEY in ~/.gradle/gradle.properties or as -PAD80_UPLOAD_KEY=... on CI.
manifestPlaceholders["ad80UploadKey"] = providers.gradleProperty("AD80_UPLOAD_KEY").getOrElse("")
}
}
<meta-data android:name="dev.ad80.PUBLISHER_KEY" android:value="${ad80UploadKey}" />

لا يأتي ملف AAR بقواعد إضافية ولا يحتاج إليها: فهو لا يستخدم الانعكاس (reflection) على فئاته. وتعمل نسخ الإصدار المصغَّرة (minified) بإعداداتك المعتادة. واحتفظ بقواعدك الخاصة بـ Google Mobile Ads SDK كما توثّقها Google.

نسخ التصحيح ومعرّفات التطبيق

Section titled “نسخ التصحيح ومعرّفات التطبيق”

يرسل SDK اسم حزمة تطبيقك (applicationId) مع كل رفع، ومفتاح الرفع لا يقبل إلا تطبيقه هو. فإن كان نوع بناء يغيّر معرّف التطبيق (مثل applicationIdSuffix ".debug")، فسجّل هذا المعرّف كتطبيق مستقل في لوحة المتابعة وأعطِ هذا البناء مفتاحه الخاص، وإلا فسيُرفض الرفع.

لا يلتقط SDK شيئاً حتى تستدعي Ad80.setConsent(true). تابع مع الموافقة والتحكم.