تثبيت SDK — Android
-
أنشئ التطبيق ومفتاح رفع من لوحة المتابعة: التطبيقات وSDK ← أضف تطبيقاً (بمعرّف
applicationIdكما هو تماماً) ← أنشئ مفتاح رفع. انسخ المفتاح (ad80_ik_...)، فهو يظهر مرة واحدة فقط. راجع التطبيقات وإعداد SDK. -
فك ضغط الحزمة وأضف SDK (الشرح بالأسفل).
-
أضف إدخالات ملف manifest (الشرح بالأسفل).
-
امنح الموافقة في الكود عبر
Ad80.setConsent(...). راجع الموافقة والتحكم. -
تحقّق من الاتصال في لوحة المتابعة. راجع اختبر الربط.
1. أضف SDK من الحزمة
Section titled “1. أضف SDK من الحزمة”يرسل لك 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>.aarjar/ ad80-sdk-core-<version>.jardocs/ INTEGRATION.mdREADME.md, CHANGELOG.md, SHA256SUMSبعد فك الضغط، تحقّق من الملفات بالأمر sha256sum -c SHA256SUMS (على macOS: shasum -a 256 -c SHA256SUMS).
الخيار أ: مستودع Maven المحلي (الموصى به)
Section titled “الخيار أ: مستودع Maven المحلي (الموصى به)”فك ضغط الحزمة في مكان ثابت، مثل third_party/ad80/. عندها يحلّ Gradle اعتماديات SDK نفسه عنك.
dependencyResolutionManagement { repositories { google() mavenCentral() maven { url = uri("third_party/ad80/maven") } // path to the unzipped maven/ folder }}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")}dependencyResolutionManagement { repositories { google() mavenCentral() maven { url uri('third_party/ad80/maven') } // path to the unzipped maven/ folder }}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/. الملفات المنفردة لا تحمل معلومات الاعتماديات، فاكتب
اعتماديات وقت التشغيل بنفسك:
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")}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>").
2. أضف إدخالات ملف manifest
Section titled “2. أضف إدخالات ملف manifest”داخل الوسم <application> في 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:
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}" />ProGuard / R8
Section titled “ProGuard / R8”لا يأتي ملف AAR بقواعد إضافية ولا يحتاج إليها: فهو لا يستخدم الانعكاس (reflection) على فئاته. وتعمل نسخ الإصدار المصغَّرة (minified) بإعداداتك المعتادة. واحتفظ بقواعدك الخاصة بـ Google Mobile Ads SDK كما توثّقها Google.
نسخ التصحيح ومعرّفات التطبيق
Section titled “نسخ التصحيح ومعرّفات التطبيق”يرسل SDK اسم حزمة تطبيقك (applicationId) مع كل رفع، ومفتاح الرفع لا يقبل إلا تطبيقه هو. فإن كان نوع بناء
يغيّر معرّف التطبيق (مثل applicationIdSuffix ".debug")، فسجّل هذا المعرّف كتطبيق مستقل في لوحة المتابعة وأعطِ
هذا البناء مفتاحه الخاص، وإلا فسيُرفض الرفع.
3. امنح الموافقة
Section titled “3. امنح الموافقة”لا يلتقط SDK شيئاً حتى تستدعي Ad80.setConsent(true). تابع مع
الموافقة والتحكم.