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

مثل أي مكتبة Android، تزيد حزمة تطوير البرامج (SDK) لـ "خدمات Google Play" حجم التطبيقات التي تتضمّنها. "حزمة SDK لإعلانات Google على الأجهزة الجوّالة (الإصدار البسيط)" هي إصدار خفيف من "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" تم إنشاؤه لتقليل هذا التأثير. وهي جزء من حجم حزمة SDK العادية.

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

في ما يلي كيفية ضبط gradle لدمج حزمة تطوير البرامج (SDK) Lite في تطبيقك:

dependencies {
    implementation 'com.google.android.gms:play-services-ads-lite:24.0.0'
}

قيود حزمة تطوير البرامج (SDK) البسيطة

يجب عدم استخدام حزمة Lite SDK إلا في التطبيقات التي يتم توزيعها من خلال متجر Google Play.

على عكس خدمات Google Play الأخرى، يتم تضمين تنفيذ حزمة SDK لإعلانات Google على الأجهزة الجوّالة في حزمة APK الخاصة بـ "خدمات Google Play"، كما يتم تضمينه في مكتبة عملاء "خدمات Google Play". يتيح ذلك توفير الدعم على الأجهزة التي لا تتضمّن حزمة APK الخاصة بـ "خدمات Google Play". أثناء التشغيل، ستقارِن حزمة SDK إصدارات مكتبة العميل وحزمة APK من "خدمات Google Play" وستستخدِم الإصدار الأحدث.

تزيل حزمة SDK Lite عملية تنفيذ "حزمة SDK لإعلانات Google على الأجهزة الجوّالة" من مكتبة العميل، ولا تترك سوى واجهة لملف APK الخاص بـ "خدمات Google Play". تعتمد حزمة تطوير البرامج (SDK) Lite على تنفيذ حزمة APK. في حال نشر تطبيقك خارج متجر Google Play، لا يمكن ضمان تثبيت ملف APK لـ "خدمات Google Play" على أجهزة المستخدمين.

على الأجهزة التي تعمل بإصدار حديث من "خدمات Google Play"، يكون سلوك حزمة SDK المتوافقة مع الأجهزة المنخفضة الأداء متطابقًا مع سلوك حزمة SDK العادية. ومع ذلك، على الأجهزة التي تتعذّر فيها تثبيت "خدمات Google Play" أو التي لا تتضمّن هذه الخدمات، قد تشير حزمة Lite SDK إلى واجهات برمجة تطبيقات غير متاحة أو تم تغييرها عن تلك الواردة في حزمة APK الخاصة بـ "خدمات Google Play". سيؤدي ذلك إلى عدم تنفيذ أيّ إجراء وتسجيل خطأ، ما قد يؤدي بدوره إلى عدم عرض الإعلانات على هذه الأجهزة.

وتيرة إصدار حزمة تطوير البرامج (SDK) البسيطة

اعتبارًا من الإصدار 24.1.0، سيتم إيقاف إصدار play-services-ads-lite بالوتيرة نفسها التي يتم بها إصدار play-services-ads. يتيح هذا التغيير طرح حزمة تطوير البرامج (SDK) بشكل تدريجي وأكثر ثباتًا. يتم إصدار حزمة SDK Lite كل ثالث إصدار تقريبًا من حزمة SDK.

تواجه المشاريع التي تعتمد على كلّ من play-services-ads-lite الإصدار 24.0.0 أو الإصدارات الأقدم وplay-services-ads الإصدار 24.1.0 أو الإصدارات الأحدث خطأ Duplicate class أثناء تجميع التطبيق. يمكنك حلّ هذا الخطأ باستخدام أحد العنصرَين play-services-ads أو play-services-ads-lite فقط.