حزمة تطوير البرامج (SDK) لإصدار "Lite" من "إعلانات Google على الأجهزة الجوّالة"

اعتبارًا من يناير 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 العادية.

بالإضافة إلى تقليل الحجم، يؤدي استخدام حزمة SDK (الإصدار Lite) إلى تقليل العدد الإجمالي للطُرق التي تتم الإشارة إليها في التطبيق. ويكون ذلك مفيدًا بشكل خاص عند النشر على إصدارات Android الأقدم، حيث يمكن أن يواجه المطوّرون الحدّ الأقصى للإشارات المرجعية البالغ 65,536.

في ما يلي كيفية ضبط 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