User Documentation
You can find the latest build of the userspace daemon and android application in the github releases.
They are built for both x86_64 and arm64-v8a, so you have to choose the right version depending on the architecture of your android device/emulator.
For running the daemon you need a custom system image with a kernel supporting syscall tracing.
For that you can use our development system-image.
Caution
There is currently only a system image built for x86_64. For other architectures you will have to provide your own system image.
After acquiring the custom system image, you have to create an avd.
The easiest way to do that is to install the Android SDK and use avdmanager:
avdmanager create avd -n myemu -k 'system-images;android-VanillaIceCream;android-automotive;x86_64' --device automotive_1080p_landscapeRunning this newly created avd can be done through emulator @myemu.
After the system is set up, you can install the application with adb install path/to/app.apk.
The daemon has to be run as root.
You can push the binary to the emulator using adb push path/to/daemon /data/local/tmp/.
/data/local/tmp is used as an example, as this directory is typically writable on an emulator.
Any directory that can be written to suffices.
Start the backend daemon as root, you can use adb for that:
adb shell su root /data/local/tmp/daemonThe app can be used like any other android app. Just open it from the device launcher.
The app has three screens.
This screen offers visualizations for different kinds of events. You can select the package you want to inspect, the kind of metric that interests you and time intervals.
The configuration screen allows you to select between presets, set global configuration options or options per process.
The about screen offers additional information like links to documentation and more.