xref: /aosp_15_r20/development/apps/DumpViewer/README.md (revision 90c8c64db3049935a07c6143d7fd006e26f8ecca)
1*90c8c64dSAndroid Build Coastguard Worker# DumpViewer
2*90c8c64dSAndroid Build Coastguard Worker
3*90c8c64dSAndroid Build Coastguard WorkerDumpViewer is an on-device logcat / dumpsys viewer.
4*90c8c64dSAndroid Build Coastguard Worker
5*90c8c64dSAndroid Build Coastguard Worker## Build
6*90c8c64dSAndroid Build Coastguard Worker
7*90c8c64dSAndroid Build Coastguard Worker```
8*90c8c64dSAndroid Build Coastguard Workerm -j DumpViewer
9*90c8c64dSAndroid Build Coastguard Worker```
10*90c8c64dSAndroid Build Coastguard Worker
11*90c8c64dSAndroid Build Coastguard Worker## Installation
12*90c8c64dSAndroid Build Coastguard Worker
13*90c8c64dSAndroid Build Coastguard WorkerDumpViewer requires some development permissions in order to read logcat and dumpsys.
14*90c8c64dSAndroid Build Coastguard WorkerTo install, pass the `-g` option to `adb install` to give the needed permissions:
15*90c8c64dSAndroid Build Coastguard Worker```
16*90c8c64dSAndroid Build Coastguard Workeradb install -r -g DumpViewer.apk
17*90c8c64dSAndroid Build Coastguard Worker
18*90c8c64dSAndroid Build Coastguard Worker# More precisely:
19*90c8c64dSAndroid Build Coastguard Workeradb install -r -g ${ANDROID_PRODUCT_OUT}/data/app/DumpViewer/DumpViewer.apk
20*90c8c64dSAndroid Build Coastguard Worker```
21*90c8c64dSAndroid Build Coastguard Worker
22*90c8c64dSAndroid Build Coastguard WorkerAlternatively, you can grant the permissions with `pm grant`:
23*90c8c64dSAndroid Build Coastguard Worker```
24*90c8c64dSAndroid Build Coastguard Workerpm grant com.android.dumpviewer android.permission.PACKAGE_USAGE_STATS
25*90c8c64dSAndroid Build Coastguard Workerpm grant com.android.dumpviewer android.permission.READ_LOGS
26*90c8c64dSAndroid Build Coastguard Workerpm grant com.android.dumpviewer android.permission.DUMP
27*90c8c64dSAndroid Build Coastguard Worker```
28*90c8c64dSAndroid Build Coastguard Worker
29*90c8c64dSAndroid Build Coastguard Worker## TODOs
30*90c8c64dSAndroid Build Coastguard Worker
31*90c8c64dSAndroid Build Coastguard Worker - Add UID / PID lookup
32*90c8c64dSAndroid Build Coastguard Worker - Add color on logcat (by severity)
33*90c8c64dSAndroid Build Coastguard Worker - Auto-shrink the header.
34