Cài đặt GMA Next-Gen SDK

Để áp dụng các điểm cải tiến về độ trễ và độ ổn định của Android, hãy sử 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:

Đị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:

Chạy bằng khai báo 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 nội dung 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 bản dựng hoặc chạy ứng dụng, hãy chạy lệnh 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 nội dung 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 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 nội dung 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 quá trình 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 chế độ xem XML của bố cục chế độ xem quảng cáo gốc

Trong 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 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 (Legacy) và GMA Next-Gen SDK, bạn có thể định cấu hình tệp android/app/build.gradle để xác định các phần phụ thuộc theo điều kiện dựa trên nội dung khai báo môi trường.

Google Mobile Ads Flutter Plugin cung cấp cấu hình mẫu trong tệp build.gradle của ứng dụng mẫu.