Fionna is a performance monitoring tool designed for Android devices, with a focus on simplicity. It draws inspiration from Fionna Campbell in "Adventure Time".
Key features currently implemented include:
- Addressing the limitations of Android's SurfaceFlinger and GFXInfo solutions in capturing frame data for games and similar applications; refer to the frame benchmark for details
- Monitoring other performance metrics such as CPU, memory, temperature, network, etc.
- Device screen mirroring and touch input
- Test reporting
- Data export
- Data comparison
Home
perf
Terminal
report
The specific code is in test/frame_benchmark_test.go, where I defined three methods for comparison: TestFPSBySurfaceFlinger, TestFPSByGFXInfo, and TestFPSByFrameTool, corresponding to the ways of obtaining information from SurfaceFlinger, GFXInfo, and the new tool solution, respectively.
The testing was conducted on the iqoo11s device, running the software "Snowbreak: Containment Zone" (com.dragonli.projectsnow.lhm). The results obtained from the three methods are as follows:
TestFPSBySurfaceFlinger
TestFPSByGFXInfo
OMSage Frame Tool
You can see that using the OMSage Frame Tool to obtain performance data for Frames has better compatibility, making it suitable for most Android scenarios involving Frame performance collection.
Please refer to the specific code for the usage of the OMSage Frame Tool and strictly follow its code logic. Any issues encountered during customization will not be addressed.
Download the corresponding build artifact from Releases, and execute the corresponding target program after decompression.
Execute directly in the command line:
fionna
Then access the corresponding address in the browser: http://127.0.0.1:3417
Fionna has a built-in simple command line mode, and you can input the following command to view instructions:
fionna --help
There are mainly two modes:
Execute the following command directly in the command line, and the program will directly start a web service. Then you can access the corresponding address: http://127.0.0.1:3417
fionna web
Of course, in web mode, you can also specify the SQLite DB file to use.
fionna web -d <db path>
# Example:fionna fionna web -d ./exapmle/my.db
Due to the strong dependency of web, a simple performance output mode is provided. Input the following command and you can get the corresponding performance data in the command line:
fionna cli-perf [flags]
# Example:fionna cli-perf --fps
flags
| Quick Usage | Option | Parameter Type | Description |
|---|---|---|---|
| -h | --help | Get help guide | |
| -p | --package | string | Application package name |
| -d | --pid | int | Application PID (default -1) |
| --proc-cpu | Get process CPU data | ||
| --fps | Get system FPS | ||
| --jank | Get system jank information | ||
| --proc-mem | Get process memory data | ||
| --proc-threads | Get process thread count | ||
| -s | --serial | string | Device serial number |
| --sys-cpu | Get system CPU data | ||
| --sys-mem | Get system memory data | ||
| --sys-network | Get system network data |
When customizing this project, please adhere to the AGPL license!!!!
This project embeds a simple Vue frontend, so frontend setup must be done before development. If you need to customize development, follow the steps below first:
- After cloning the project, navigate to the fionna-web directory
cd fionna-web
- Install frontend dependencies
npm install
- Generate build artifacts
npm run build
You can now proceed with project development according to your requirements.
-
ADB environment is required on the PC
-
Application's CPU computation differs from regular calculations; the project uses the following metrics:https://blog.csdn.net/weixin_39451323/article/details/118083713
-
Avoid occupying port 3417.