لاستخدام التحسينات التي تم إدخالها على وقت الاستجابة والثبات في Android، استخدِم GMA Next-Gen SDK. يغطّي هذا الدليل كيفية ضبط Google Mobile Ads Flutter Plugin لاستخدام GMA Next-Gen SDK على Android.
المتطلبات الأساسية
قبل المتابعة، يُرجى تنفيذ ما يلي:
- تثبيت الإصدار 9.0.0 أو إصدار أحدث من Google Mobile Ads Flutter Plugin
- إعداد Google Mobile Ads Flutter Plugin.
- إنشاء مشروع Flutter
ضبط إعدادات Android Gradle
لاستخدام GMA Next-Gen SDK على Android، عليك تعديل إعدادات Gradle:
- ضبط الحدّ الأدنى لمستوى واجهة Android API ومستوى واجهة 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 و
GMA Next-Gen SDK، يمكنك ضبط ملف android/app/build.gradle
لتحديد التبعيات بشكل مشروط استنادًا إلى بيان البيئة.
Google Mobile Ads Flutter Plugin يوفّر نموذج إعداد في
ملف build.gradle لتطبيق المثال.