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