Để áp dụng các điểm cải tiến về độ trễ và tính ổn định của Android, hãy dùng GMA Next-Gen SDK. Hướng dẫn này trình bày cách định cấu hình Google Mobile Ads Flutter Plugin để sử dụng GMA Next-Gen SDK cho Android.
Điều kiện tiên quyết
Trước khi tiếp tục, hãy làm như sau:
- Cài đặt Google Mobile Ads Flutter Plugin phiên bản 9.0.0 trở lên.
- Thiết lập Google Mobile Ads Flutter Plugin.
- Có một dự án Flutter.
Định cấu hình chế độ cài đặt Android Gradle
Để sử dụng GMA Next-Gen SDK trên Android, bạn phải cập nhật cấu hình Gradle:
- Đặt cấp độ API tối thiểu và biên dịch API Android.
- Nếu bạn sử dụng tính năng dàn xếp, hãy làm theo các bước di chuyển để loại trừ các mô-đun
com.google.android.gmsđể tránh lỗi trùng lặp lớp.
Chạy với nội dung khai báo về môi trường
Để sử dụng GMA Next-Gen SDK khi tạo và chạy ứng dụng Android, bạn phải cung cấp bộ khai báo môi trường USE_NEXT_GEN_SDK được đặt thành giá trị true.
Mỗi khi bạn tạo hoặc chạy ứng dụng, hãy chạy các thao tác sau:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Chạy bằng cấu hình IDE
Nếu chạy ứng dụng bằng Môi trường phát triển tích hợp (IDE), bạn có thể định cấu hình các khai báo môi trường trong cấu hình khởi chạy thay vì truyền cờ bằng dòng lệnh.
Ví dụ: bạn có thể xác định các biến này trong một tệp JSON và thêm chúng vào chế độ thiết lập IDE. Để biết thông tin chi tiết, hãy xem phần chỉ định các khai báo môi trường.
Cập nhật mẫu quảng cáo gốc
Nếu bạn sử dụng mẫu quảng cáo gốc, hãy thực hiện các nội dung cập nhật sau để hỗ trợ GMA Next-Gen SDK:
Cập nhật tính năng nhập gói NativeAdFactory
Đối với Android, hãy cập nhật câu lệnh nhập cho lớp 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
Cập nhật các khung hiển thị XML bố cục khung hiển thị quảng cáo gốc
Trong các tệp XML bố cục cho quảng cáo gốc, hãy cập nhật lớp chế độ xem quảng cáo gốc:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Định cấu hình các phần phụ thuộc cho cả hai chế độ thiết lập
Nếu dự án của bạn phải hỗ trợ cả Google Mobile Ads SDK và GMA Next-Gen SDK, bạn có thể định cấu hình tệp android/app/build.gradle để xác định có điều kiện các phần phụ thuộc dựa trên khai báo môi trường.
Google Mobile Ads Flutter Plugin cung cấp một cấu hình mẫu trong tệp build.gradle của ứng dụng mẫu.