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 đến hoạt động nội bộ của SDK — đều được ghi đồng thời vào hai nơi: Logcat, với tag theo từng nhóm, và bộ đệm log trong bộ nhớ dùng để hiển thị trên 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 được 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, gỡ lỗi trên thiết bị của tester 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, để tester có thể trực tiếp cuộn xem/tìm kiếm hoặc chụp ảnh màn hình gửi lại cho bạn.

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