docs/notes/performance_analysis.html
Before profiling the application or analyzing the performance in a consistent way, ideally the GPU frequency on the target hardware should get locked. In order to do this, you need to do the following:
Build a release build of Filament with the applicable backend(s) enabled (+ any special flags for enabling sys strace. Nothing special is needed for Vulkan or WebGPU aside from building a release build with no flags) (debug builds for this are useless)
Connect your Android device to your computer via a USB cord with USB debugging enabled and configure the system property to default to the desired backend, e.g. (to determine how these numbers map to the backends, see the enum class Backend definition in filament/filament/backend/include/backend/DriverEnums.h):
Build and run a sample, e.g. sample-gltf-viewer, on your Android device (Android Studio recommended).
Run AGI and follow instructions to profile the app/system with trace capture(s). See https://developer.android.com/agi/start for more details to get started.