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 từng danh mục, và bộ lưu trữ 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ế độ hoạt động, 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 mà không cần Logcat

Nếu bạn đang gỡ lỗi bản build release, 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ể cuộn/tìm kiếm trực tiếp 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 AAR của AKS 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 vào PTB_LOG.