نصب کیت توسعه نرم‌افزار نسل بعدی GMA

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

پیش‌نیازها

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

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

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

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

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

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

flutter run --dart-define USE_NEXT_GEN_SDK=true

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

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

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

به‌روزرسانی الگوهای آگهی‌های بومی

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

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

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

جاوا

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

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

Kotlin

// 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 (Legacy) و هم از GMA Next-Gen SDK پشتیبانی کند، می‌توانید فایل android/app/build.gradle خود را پیکربندی کنید تا وابستگی‌ها را به‌طور مشروط براساس اعلام محیط تعریف کند.

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