11. Gỡ lỗi bằng log AKS (PTB_LOG)

Mỗi dòng log do AKS tạo ra — từ các lệnh gọi AKSLogManager/AppsKitSDKLogManager, sự kiện tải/hiển thị quảng cáo và hoạt động nội bộ của SDK — đều được gửi đồng thời đến hai nơi: Logcat, với tag theo danh mục, và bộ lưu log trong bộ nhớ dùng để cung cấp dữ liệu cho màn hình AKS Logs ở §10.

Lọc Logcat

Lọc theo tag trong Logcat của Android Studio (tag:PTB_LOG) hoặc qua adb:

adb logcat -s PTB_LOG:* PTB_LOG_ADS:* PTB_LOG_ANALYTICS:*

• PTB_LOG — log chung của SDK (trình tự khởi tạo, thông báo chế độ, vòng đời, lỗi)
• PTB_LOG_ADS — vòng đời tải/hiển thị quảng cáo cho mọi định dạng
• PTB_LOG_ANALYTICS — các sự kiện gửi đến Firebase/MMP, bao gồm mọi lệnh gọi sendAKSEvent/AKSLogManager.log ở §7

Đọc log không cần Logcat

Nếu bạn đang gỡ lỗi bản build release, thiết bị của người kiểm thử hoặc xử lý yêu cầu hỗ trợ mà không thể kết nối qua adb, hãy mở màn hình AKS Logs trong Test Suite (§10) — màn hình này hiển thị chính xác các dòng log đó ngay trên thiết bị, kèm chức năng tìm kiếm, để người kiểm thử có thể trực tiếp cuộn xem/tìm kiếm hoặc gửi lại ảnh chụp màn hình cho bạn.

AppsKitSDKLogManager.logAarVersion() (xem §7.3) là cách nhanh nhất để xác nhận phiên bản AAR của AKS thực sự đang được tích hợp khi bạn nghi ngờ phiên bản không khớp — phương thức này in thông báo phiên bản vào PTB_LOG.