اعتبارًا من يناير 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 على الأجهزة الجوّالة" هي إصدار خفيف الوزن من 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) البسيطة
يجب استخدام حزمة Lite SDK فقط في التطبيقات الموزَّعة من خلال متجر Google Play.
على عكس خدمات Google Play الأخرى، يتضمّن حِزمة APK الخاصة بخدمات Google Play أيضًا التنفيذ العادي Google Mobile Ads SDK (Legacy) في مكتبة برامج خدمات Google Play. يتيح ذلك توفير الدعم على الأجهزة التي لا يتوفّر عليها حزمة APK لـ "خدمات Google Play". أثناء وقت التشغيل، ستقارن حزمة SDK بين إصدارَي مكتبة العميل وحزمة APK لخدمات Google Play، وستستخدم الإصدار الأحدث.
تزيل حزمة تطوير البرامج (SDK) Lite عملية تنفيذ Google Mobile Ads SDK (Legacy) من مكتبة العميل، ولا تترك سوى واجهة لحزمة APK الخاصة "بخدمات Google Play". تعتمد حزمة Lite SDK على تنفيذ حزمة APK. إذا نشرت تطبيقك خارج متجر Google Play، لن يكون هناك ضمان بأنّ أجهزة المستخدمين ستتضمّن حزمة APK لخدمات Google Play.
على الأجهزة التي يتوفّر عليها إصدار حديث من "خدمات Google Play"، يكون سلوك حزمة تطوير البرامج (SDK) الخفيفة مطابقًا لسلوك حزمة تطوير البرامج (SDK) العادية. ومع ذلك، على الأجهزة التي تكون فيها "خدمات Google Play" قديمة أو غير متوفّرة، قد تشير حزمة تطوير البرامج (SDK) الخفيفة إلى واجهات برمجة تطبيقات غير متوفّرة أو تم تغييرها عن تلك الموجودة في حزمة APK الخاصة بـ "خدمات Google Play". سيؤدي ذلك إلى عدم تنفيذ أي عملية وتسجيل خطأ، ما قد يؤدي إلى عدم عرض الإعلانات على هذه الأجهزة.
وتيرة إصدار حزمة تطوير البرامج (SDK) في الوضع البسيط
بدءًا من الإصدار 24.1.0، سيتوقف إصدار حزمة play-services-ads-lite بالوتيرة نفسها التي يتم بها إصدار play-services-ads. يتيح هذا التغيير طرح عملية تنفيذ حزمة SDK بشكل تدريجي وثابت أكثر.
يتم طرح إصدارات Lite SDK كل ثلاثة إصدارات من حزمة SDK تقريبًا.
تحدث أخطاء Duplicate class أثناء تجميع التطبيق في المشاريع التي تعتمد على الإصدار 24.0.0 أو الإصدارات الأقدم من play-services-ads-lite والإصدار 24.1.0 أو الإصدارات الأحدث من play-services-ads. يمكنك حلّ هذا الخطأ باستخدام أحد العنصرين play-services-ads أو play-services-ads-lite فقط.