نصب GMA Next-Gen SDK

برای بهبود تأخیر و پایداری اندروید، از GMA Next-Gen SDK استفاده کنید. این راهنما پیکربندی Google Mobile Ads Flutter Plugin برای استفاده از GMA Next-Gen SDK برای اندروید پوشش می‌دهد.

پیش‌نیازها

قبل از ادامه، موارد زیر را انجام دهید:

تنظیمات Gradle اندروید را پیکربندی کنید

برای استفاده از GMA Next-Gen SDK در اندروید، باید پیکربندی‌های Gradle خود را به‌روزرسانی کنید:

اجرا با اعلان محیط

برای استفاده از GMA Next-Gen SDK هنگام ساخت و اجرای برنامه اندروید خود، باید مقدار تعریف محیط USE_NEXT_GEN_SDK را روی مقدار true تنظیم کنید.

هر بار که برنامه خود را می‌سازید یا اجرا می‌کنید، موارد زیر را اجرا کنید:

flutter run --dart-define USE_NEXT_GEN_SDK=true

با پیکربندی IDE اجرا کنید

اگر برنامه خود را با استفاده از یک محیط توسعه یکپارچه (IDE) اجرا می‌کنید، می‌توانید به جای ارسال پرچم با استفاده از خط فرمان، اعلان‌های محیط خود را در پیکربندی راه‌اندازی پیکربندی کنید.

برای مثال، می‌توانید این متغیرها را در یک فایل JSON تعریف کنید و آنها را به تنظیمات IDE خود اضافه کنید. برای جزئیات بیشتر، به بخش «تعیین اعلان‌های محیط» مراجعه کنید.

الگوهای تبلیغات بومی را به‌روزرسانی کنید

اگر از قالب‌های تبلیغات بومی استفاده می‌کنید، به‌روزرسانی‌های زیر را برای پشتیبانی GMA Next-Gen SDK انجام دهید:

به‌روزرسانی واردات بسته NativeAdFactory

برای اندروید، عبارت import مربوط به کلاس NativeAdFactory را به‌روزرسانی کنید:

جاوا

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;

کاتلین

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory

طرح نمایش تبلیغات بومی را به‌روزرسانی کنید. نماهای XML

در فایل‌های XML طرح‌بندی برای تبلیغات بومی خود، کلاس نمای تبلیغات بومی را به‌روزرسانی کنید:

<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />

<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />

پیکربندی وابستگی‌ها برای هر دو تنظیم

اگر پروژه شما باید از هر دو Google Mobile Ads SDK و GMA Next-Gen SDK پشتیبانی کند، می‌توانید فایل android/app/build.gradle خود را طوری پیکربندی کنید که وابستگی‌ها را بر اساس اعلان محیط به صورت مشروط تعریف کند.

Google Mobile Ads Flutter Plugin یک پیکربندی نمونه در فایل build.gradle اپلیکیشن نمونه ارائه می‌دهد.