برای پذیرش بهبودهای پایداری و تأخیر 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 و سطح کامپایل آن را تنظیم کنید.
- اگر از میانجیگری استفاده میکنید، مراحل انتقال را برای
مستثنی کردن
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 ارائه میدهد.