כדי ליהנות מהשיפורים בזמן האחזור וביציבות ב-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 כשמפתחים ומריצים את האפליקציה ל-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:
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 (Legacy) וגם ב-GMA Next-Gen SDK, אתם יכולים להגדיר את הקובץ android/app/build.gradle כך שיגדיר יחסי תלות באופן מותנה על סמך הצהרת הסביבה.
בקובץ build.gradle של האפליקציה לדוגמה של Google Mobile Ads Flutter Plugin יש הגדרה לדוגמה.