כדי להטמיע שיפורים בזמן האחזור וביציבות של 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.
- אם אתם משתמשים בגישור, צריך לפעול לפי שלבי ההעברה כדי להחריג מודולים של
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 ולהוסיף אותם להגדרות של סביבת הפיתוח המשולבת (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 כך שהתלות תוגדר באופן מותנה על סמך הצהרת הסביבה.
Google Mobile Ads Flutter Plugin מספקת דוגמה להגדרה בקובץ של אפליקציה לדוגמה build.gradle.