برای استفاده از بهبودهای پایداری و تأخیر Android، از GMA Next-Gen SDK استفاده کنید. این راهنما پیکربندی Google Mobile Ads Flutter Plugin برای استفاده از GMA Next-Gen SDK در Android را پوشش می‌دهد.
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را انجام دهید:
- نسخه ۹.۰.۰ یا بالاتر Google Mobile Ads Flutter Plugin را نصب کنید.
- Google Mobile Ads Flutter Plugin را راه‌اندازی کنید.
- پروژه Flutter داشته باشید.
پیکربندی تنظیمات Android Gradle
برای استفاده از GMA Next-Gen SDK در Android، باید پیکربندی‌های Gradle خود را به‌روز کنید:
- سطوح حداقل و کامپایل Android API را تنظیم کنید.
- اگر از میانجی‌گری استفاده می‌کنید، مراحل انتقال را برای
کنار گذاشتن
com.google.android.gmsواحد دنبال کنید تا از خطاهای کلاس تکراری جلوگیری کنید.
اجرا با اظهارنامه محیط
برای استفاده از 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 ارائه می‌دهد.