کیت توسعه نرم‌افزار Google Mobile Ads Lite

از ژانویه ۲۰۲۶، «کیت توسعه نرم‌افزار Google Mobile Ads Lite» منسوخ شده است. برای ادامه پشتیبانی، به GMA Next-Gen SDK منتقل شوید. GMA Next-Gen SDK در دستگاه اندازه کوچک‌تری نسبت به Google Mobile Ads SDK (Legacy) کامل دارد. برای جزئیات، با مزایای GMA Next-Gen SDK آشنا شوید.

مانند هر کتابخانه Android، کیت توسعه نرم‌افزار خدمات Google Play اندازه برنامه‌هایی را که شامل آن هستند افزایش می‌دهد. کیت توسعه نرم‌افزار Google Mobile Ads Lite نسخه سبک‌وزنی از Google Mobile Ads SDK (Legacy) است که برای کاهش این تأثیر ساخته شده است. اندازه آن کسری از اندازه «کیت توسعه نرم‌افزار» معمولی است.

علاوه‌بر کاهش اندازه، استفاده از Lite SDK تعداد کل روش‌های ارجاع‌شده در برنامه را کاهش می‌دهد. این امر به‌ویژه هنگام استقرار در نسخه‌های قدیمی‌تر Android مفید است، جایی که توسعه‌دهندگان می‌توانند با محدودیت مرجع 64K مواجه شوند.

در اینجا نحوه پیکربندی gradle برای گنجاندن Lite SDK در برنامه‌تان آورده شده است:

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

محدودیت‌های Lite SDK

کیت توسعه نرم‌افزار Lite فقط باید در برنامه‌هایی استفاده شود که ازطریق «فروشگاه Google Play» توزیع می‌شوند.

برخلاف سایر خدمات Google Play، پیاده‌سازی استاندارد Google Mobile Ads SDK (Legacy) در APK «خدمات Google Play» نیز در کتابخانه کارخواه «خدمات Google Play» گنجانده شده است. این کار امکان پشتیبانی در دستگاه‌های فاقد APK «خدمات Google Play» را فراهم می‌کند. در زمان اجرا، کیت توسعه نرم‌افزار نسخه‌های کتابخانه کارخواه و APK «خدمات Google Play» را مقایسه می‌کند و از نسخه جدیدتر استفاده می‌کند.

کیت توسعه نرم‌افزار Lite پیاده‌سازی Google Mobile Ads SDK (Legacy) را از کتابخانه کارخواه حذف می‌کند و فقط یک میانای APK «خدمات Google Play» باقی می‌گذارد. کیت توسعه نرم‌افزار Lite به پیاده‌سازی APK متکی است. اگر برنامه‌تان را خارج از فروشگاه Google Play مستقر کنید، تضمینی وجود ندارد که دستگاه‌های کاربرتان APK «خدمات Google Play» را نصب کرده باشند.

در دستگاه‌هایی که نسخه به‌روز «خدمات Google Play» را دارند، رفتار Lite SDK با SDK استاندارد یکسان است. بااین‌حال، در دستگاه‌هایی که «خدمات Google Play» قدیمی است یا وجود ندارد، Lite SDK ممکن است به میاناهای برنامه‌سازی کاربردی ارجاع دهد که دردسترس نیستند یا نسبت‌به میاناهای برنامه‌سازی کاربردی موجود در APK «خدمات Google Play» تغییر کرده‌اند. این امر منجر به ثبت یک عملیات بی‌اثر و یک خطا می‌شود که ممکن است باعث شود آگهی‌ها در آن دستگاه‌ها ارائه نشوند.

آهنگ انتشار کیت توسعه نرم‌افزار Lite

از نسخه ۲۴.۱.۰، آرتیفکت play-services-ads-lite دیگر با همان آهنگ play-services-ads منتشر نمی‌شود. این تغییر امکان عرضه تدریجی‌تر و پایدارتر پیاده‌سازی کیت توسعه نرم‌افزار را فراهم می‌کند. کیت توسعه نرم‌افزار Lite تقریباً هر سه نسخه یک‌بار منتشر می‌شود.

پروژه‌هایی که هم به play-services-ads-lite نسخه ۲۴.۰.۰ یا پایین‌تر و هم به play-services-ads نسخه ۲۴.۱.۰ یا بالاتر وابسته هستند، درطول کامپایل برنامه با خطای Duplicate class مواجه می‌شوند. این خطا را بااستفاده از فقط یکی از آرتیفکت‌های play-services-ads یا play-services-ads-lite برطرف کنید.