اعتبارًا من يناير 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) البسيطة
يجب استخدام حزمة تطوير البرامج (SDK) Lite في التطبيقات الموزَّعة من خلال متجر 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 فقط.