Skip to content

Latest commit

 

History

History
159 lines (100 loc) · 5.03 KB

README.md

File metadata and controls

159 lines (100 loc) · 5.03 KB
Raw

Fionna

中文

Overview

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

Frame Benchmark

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.

Usage

Quickstart

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

Command Line Mode

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:

web mode

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

cli-perf mode

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

Development

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.

Notes

Thank