اعتبارًا من يناير 2026، سيتم إيقاف حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" (الإصدار Lite) نهائيًا. لمواصلة الحصول على الدعم، يُرجى نقل بياناتك إلى GMA Next-Gen SDK. GMA Next-Gen SDK يتميّز بحجم أصغر على الجهاز مقارنةً بحزمة Google Mobile Ads SDK الكاملة. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة التعرّف على مزايا GMA Next-Gen SDK.
على غرار أي مكتبة Android، تزيد حزمة "SDK لخدمات Google Play" من حجم التطبيقات التي تتضمّنها. حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" (الإصدار Lite) هي إصدار خفيف من Google Mobile Ads SDK تم إنشاؤه للحدّ من هذا التأثير. ويشكّل حجمها جزءًا صغيرًا من حجم حزمة SDK العادية.
في ما يلي كيفية ضبط Gradle لدمج حزمة SDK (الإصدار Lite) في تطبيقك:
dependencies {
implementation 'com.google.android.gms:play-services-ads-lite:24.8.0'
}
قيود حزمة SDK (الإصدار Lite)
يجب استخدام حزمة SDK (الإصدار Lite) فقط في التطبيقات التي يتم توزيعها من خلال "متجر Google Play".
على عكس خدمات Google Play، يتم أيضًا تضمين عملية التنفيذ العادية Google Mobile Ads SDK في حزمة APK لخدمات Google Play في مكتبة عميل خدمات Google Play. يتيح ذلك توفير الدعم على الأجهزة التي لا تتضمّن حزمة APK لخدمات Google Play. أثناء وقت التشغيل، ستقارن حزمة SDK بين إصدارَي مكتبة العميل وحزمة APK لخدمات Google Play وتستخدم الإصدار الأحدث.
تزيل حزمة SDK (الإصدار Lite) عملية تنفيذ Google Mobile Ads SDK من مكتبة العميل ، ولا تترك سوى واجهة لحزمة APK لخدمات Google Play. تعتمد حزمة SDK (الإصدار Lite) على عملية تنفيذ حزمة APK. إذا نشرت تطبيقك خارج "متجر Google Play"، لا نضمن أن تتضمّن أجهزة المستخدمين حزمة APK لخدمات Google Play مثبّتة.
على الأجهزة التي تتضمّن إصدارًا حديثًا من "خدمات Google Play"، يكون سلوك حزمة SDK (الإصدار Lite) مطابقًا لسلوك حزمة SDK العادية. ومع ذلك، على الأجهزة التي تكون فيها "خدمات Google Play" قديمة أو غير متوفّرة، قد تشير حزمة SDK (الإصدار Lite) إلى واجهات برمجة تطبيقات غير متاحة أو تم تغييرها عن تلك الموجودة في حزمة APK لخدمات Google Play. سيؤدي ذلك إلى عدم تنفيذ أي عملية وتسجيل خطأ، ما قد يؤدي إلى عدم عرض الإعلانات على هذه الأجهزة.
وتيرة إصدار حزمة SDK (الإصدار Lite)
بدءًا من الإصدار 24.1.0، سيتوقف إصدار العنصر play-services-ads-lite بالوتيرة نفسها التي يتم بها إصدار play-services-ads. يسمح هذا التغيير بتنفيذ حزمة SDK بشكل أكثر تدرّجًا واستقرارًا.
يتم إصدار حزمة SDK (الإصدار Lite) كل ثلاثة إصدارات من حزمة SDK تقريبًا.
تواجه المشاريع التي تعتمد على الإصدار 24.0.0 أو الإصدارات الأقدم من play-services-ads-lite والإصدار 24.1.0 أو الإصدارات الأحدث من play-services-ads خطأ Duplicate class أثناء تجميع التطبيق. يمكنك حلّ هذا الخطأ باستخدام أحد العنصرَين
play-services-ads أو play-services-ads-lite فقط.