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