כדי להשתמש בשיפורים של זמן האחזור והיציבות ב-Android, צריך להשתמש ב-GMA Next-Gen SDK. במדריך הזה מוסבר איך להגדיר את Google Mobile Ads Flutter Plugin לשימוש ב-GMA Next-Gen SDK ל-Android.
דרישות מוקדמות
לפני שממשיכים, צריך:
- מתקינים את Google Mobile Ads Flutter Plugin בגרסה 9.0.0 ואילך.
- הגדרה של Google Mobile Ads Flutter Plugin
- יש לכם פרויקט Flutter.
הגדרת הגדרות Android Gradle
כדי להשתמש ב-GMA Next-Gen SDK ב-Android, צריך לעדכן את ההגדרות של Gradle:
- הגדרת רמות ה-API המינימליות והמצטברות ב-Android
- אם אתם משתמשים בתהליך בחירת הרשת (mediation), צריך לפעול לפי שלבי ההעברה כדי להחריג מודולים של
com.google.android.gmsולמנוע שגיאות של כיתות כפולות.
הרצה עם הצהרת סביבה
כדי להשתמש ב-GMA Next-Gen SDK כשמבצעים build ומריצים את אפליקציית Android, צריך לספק את הצהרת הסביבה USE_NEXT_GEN_SDK עם הערך true.
בכל פעם שאתם יוצרים או מריצים את האפליקציה, מריצים את הפקודה הבאה:
flutter run --dart-define USE_NEXT_GEN_SDK=true
הרצה עם הגדרות של סביבת פיתוח משולבת
אם אתם מריצים את האפליקציה באמצעות סביבת פיתוח משולבת (IDE), אתם יכולים להגדיר את הצהרות הסביבה בהגדרות ההפעלה במקום להעביר את הדגל באמצעות שורת הפקודה.
לדוגמה, אפשר להגדיר את המשתנים האלה בקובץ JSON ולהוסיף אותם להגדרות של סביבת הפיתוח המשולבת. פרטים נוספים זמינים במאמר בנושא הגדרת הצהרות סביבה.
עדכון תבניות של מודעות מותאמות
אם אתם משתמשים בתבניות של מודעות מותאמות, אתם צריכים לבצע את העדכונים הבאים כדי לתמוך ב-GMA Next-Gen SDK:
עדכון ייבוא חבילה של NativeAdFactory
ב-Android, מעדכנים את הצהרת הייבוא של המחלקה NativeAdFactory:
Java
// 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.