หากต้องการใช้การปรับปรุงความหน่วงและความเสถียรของ 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 ขั้นต่ำและระดับ API ของ 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 ดังนี้
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 ... />
กำหนดค่าการขึ้นต่อกันสำหรับการตั้งค่าทั้ง 2 แบบ
หากโปรเจ็กต์ต้องรองรับทั้ง Google Mobile Ads SDK และ
GMA Next-Gen SDK คุณสามารถกำหนดค่าไฟล์ android/app/build.gradle
เพื่อกำหนดการขึ้นต่อกันตามเงื่อนไขตามการประกาศสภาพแวดล้อม
Google Mobile Ads Flutter Plugin มีการกำหนดค่าตัวอย่างใน
ไฟล์ build.gradle ของแอปตัวอย่าง