هذا الدليل موجّه للناشرين الذين يدمجون نسخة استخدام المنتج قبل إطلاقه لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لنظام التشغيل Android في تطبيقاتهم المتوافقة مع Android. توفّر إصدارات استخدام المنتج قبل إطلاقه فرصة الاستفادة من الميزات الجديدة لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة بدون انتظار إطلاق الإصدار التالي من خدمات Google Play، وتقديم المزايا التالية:
تبدأ الشركة تلقائيًا في استخدام الإصدار الأحدث من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة من حزمة APK لخدمات Google Play عند إطلاق ميزة استخدام المنتج قبل إطلاقه في حزمة APK.
يتم اختبار هذه التطبيقات بالكامل وتستوفي معايير الإصدار نفسها مثل الإصدارات المتاحة للجميع في مستودع Maven من Google أو في "إدارة SDK".
إنّها إصدارات كاملة من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، وهي أكبر حجمًا من حزمة "حزمة تطوير البرامج (SDK) البسيطة"، إلا أنّها لا تخضع لقيود "حزمة تطوير البرامج (SDK)" المبسّطة.
ويمكن استخدامها على مستوى العالم وليس فقط في التطبيقات التي يتم توزيعها من خلال Google Play.
اتّبِع الخطوات الواردة في هذه الصفحة لإعداد مستودع محلي في Maven باستخدام حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لاستخدام المنتج قبل إطلاقه، والإشارة إليه كعنصر تابع في تطبيق Android الخاص بك.
المتطلبات الأساسية
- يجب أن تستخدم الإصدار Android Studio 3.0 أو إصدارًا أحدث
- استهداف المستوى 16 لواجهة برمجة تطبيقات Android أو أعلى
- ملف ZIP لحزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" قبل إطلاقه من "مدير الحساب"
ضبط مستودع Maven المخصَّص
نزِّل ملف ZIP لحزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" قبل إطلاقه. أنشئ مجلّد
gma_sdk_repo في دليل المستوى الأعلى لمشروعك وضَع
جميع محتوى ملف ZIP في ذلك المجلد. ينبغي أن تبدو بنية الدليل
كما يلي: <project_root_dir>/gma_sdk_repo/com/google/....
افتح ملف build.gradleعلى مستوى المشروع لتطبيقك.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
أضِف السطر الغامق إلى قسم allprojects/repositories. يؤدي هذا إلى توجيه
Gradle للبحث عن مستودع Maven في مجلد gma_sdk_repo الذي أنشأته للتو عند حل التبعيات.
إضافة تبعية للإصدار
لاستخدام إصدار استخدام المنتج قبل إطلاقه من حزمة SDK لإعلانات Google على الأجهزة الجوّالة في مشروعك، عليك
أيضًا الإشارة إليه كاعتماد في ملف build.gradle على مستوى التطبيق:
افتح ملف build.gradle على مستوى التطبيق وأضِف السطر الغامق في المقتطف إلى
القسم dependencies.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
يمكن تحديد إصدار التبعية الذي يعرضه x.y.z في المقتطف السابق من خلال العثور على أحدث إصدار متوفّر ضمن دليل com/google/android/gms/play-services-ads/ في المحتوى غير المؤرشف في ملف ZIP لـ "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" قبل إطلاقه.
حلّ تعارضات Firebase
إذا كنت تستخدم مكتبة Firebase مع حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة، يمكنك تضمين التبعيتَين com.google.android.gms:play-services-measurement-api وcom.google.android.gms:play-services-measurement-sdk-api في مشروعك. يجب أن تتطابق إصدارات هاتين التبعيتين، ولكنك قد تجد أنّ إصدار الاستخدام التجريبي لحزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة في تطبيقك، وإصدارك الحالي من Firebase يضم إصدارات مختلفة لهذين التبعيتين.
كحل بديل، يمكنك فرض حل التبعية على إصدار معيّن من مكتبة play-services-measurement-sdk-api في ملف build.gradle في تطبيقك على النحو التالي:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
يعتمد الإصدار x.y.z على إصدار Firebase. في ما يلي الإصدارات الصحيحة
لإصدارات Firebase الحديثة:
إصدار واحد (firebase-core)
|
إصدار واحد (play-services-measurement-sdk-api)
|
|---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
للبحث عن الإصدار الصحيح لإصدارات Firebase الأخرى، شغِّل
gradle androidDependencies لتطبيقك واستخدِم الإصدار المطبوع
لتبعية com.google.android.gms:play-services-measurement-api.
أصبح تطبيق Android جاهزًا الآن للاستخدام مع إصدار استخدام المنتج قبل إطلاقه لحزمة تطوير البرامج "SDK لإعلانات Google على الأجهزة الجوّالة" لنظام التشغيل Android.