apktrace
Trace all method entries and exits, the exit also prints the return value, if it is of basic type. The apk must have set the android:debuggable="true" flag.
By default it will trace all functions which match(prefixed) package_name.
Updates
(07-02-2020 add native function highlighting)
Usage
>> python apktrace.py --help
usage: apktrace.py [-h] [-w
] [-c] [-d] [--version]
package_name activity
Trace APK files easily
positional arguments:
package_name Package Name used to start Application
activity start activity of the Application
optional arguments:
-h, --help show this help message and exit
-w
, --watchlist
File containing classes to watch, (class per line)
-c, --clear Clear APK before start
-d, --debug Verbose mode
-n, --native Break on native method entry
--version Print apktrace version
In action:
>> python apktrace.py -d com.example.firsttestapp .MainActivity
[apktrace] LOG : start CMD "adb shell am start -D -n com.example.firsttestapp/.MainActivity"
[apktrace] LOG : forward CMD "adb forward tcp:33333 jdwp:14856"
[00:12:33-057312] Method Entry, Thread: 10635 [main], Lcom/example/firsttestapp/MainActivity; ->
()V,
[00:12:33-103480] Method Exit, Thread: 10635 [main], Lcom/example/firsttestapp/MainActivity; ->
()V, Retval: 0
[00:12:33-125597] Method Entry, Thread: 10635 [main], Lcom/example/firsttestapp/MainActivity; -> onCreate(Landroid/os/Bundle;)V,
[00:12:33-174525] Method Entry, Thread: 10635 [main], Lcom/example/firsttestapp/MainActivity; -> calcOffset(IILjava/lang/String;)I,
[00:12:33-175951] Method Exit, Thread: 10635 [main], Lcom/example/firsttestapp/MainActivity; -> calcOffset(IILjava/lang/String;)I, Retval: 325
[00:12:33-224984] Method Entry, Thread: 10635 [main], Lcom/example/firsttestapp/PinHandling; ->
(Ljava/io/File;)V,
[00:12:33-226337] Method Exit, Thread: 10635 [main], Lcom/example/firsttestapp/PinHandling; ->
(Ljava/io/File;)V, Retval: 0
[00:12:33-227446] Method Entry, Thread: 10635 [main], Lcom/example/firsttestapp/PinHandling; -> checkIfPinExists()Z,
[00:12:33-230958] Method Exit, Thread: 10635 [main], Lcom/example/firsttestapp/PinHandling; -> checkIfPinExists()Z, Retval: 1
[00:12:34-578716] Method Exit, Thread: 10635 [main], Lcom/example/firsttestapp/MainActivity; -> onCreate(Landroid/os/Bundle;)V, Retval: 0
TODO
- there is a known Bug in the methodID size in the Rust implementation I wonder how this ever worked^^
- move JdwpHandler in its own repository and use it as a git submodule, to allow easier usage also for other repositories, for example jdb++
- implement the
--watchlistargument (not possible see issue)
1.6k Dec 09, 2022
7.3k Dec 29, 2022
80 Nov 18, 2022
2.7k Jan 08, 2023
21 Jun 17, 2022
296 Dec 28, 2022
1 Jan 10, 2022
32.9k Dec 31, 2022
9.5k Jan 08, 2023
2 Jan 02, 2022
5.9k Dec 30, 2022
1k Dec 24, 2022
1.3k Dec 15, 2022
84 Dec 22, 2022
5.2k Jan 01, 2023
42 Dec 12, 2022
2.8k Jan 08, 2023
637 Jan 02, 2023
16 May 21, 2022