Who is this for?

This is an introductory topic for Godot developers targeting Android devices who want to optimize game performance on Arm CPUs and Mali GPUs using Arm Performance Studio tools.

What will you learn?

Upon completion of this Learning Path, you will be able to:

  • Install the Arm Performance Studio Integration extension in Godot
  • Annotate your Godot game with performance markers for profiling in Streamline and Performance Advisor

Prerequisites

Before starting, you will need the following:

  • Familiarity with Godot
  • Familiarity with Arm Performance Studio tools

Summary

AI-assisted

This summary was drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
You’ll instrument a Godot project with Arm Performance Studio Integration and profile it on an Arm-based Android device. First, you’ll add event markers, regions, and channels to capture work across threads. Then, you’ll inspect annotations in Streamline and use Performance Advisor charts to investigate frame rate, CPU, and GPU bottlenecks.

Frequently asked questions

AI-assisted

These FAQs were drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
Which Godot versions does the Arm Performance Studio extension support?
The extension is compatible with Godot 4.3 and later.
How do I confirm the extension installed correctly in my project?
Add a script that creates PerformanceStudio.new() and call marker("Test"). If the project runs without script errors, the extension is available and your annotations can be captured.
How do I add a point-in-time annotation?
Create a PerformanceStudio instance and call marker("Game Started") to emit a timestamped label. This label appears in the Streamline timeline for correlation with performance data.
How do I define a region, and where will it appear in reports?
Emit a pair of markers prefixed with Region Start <name> and Region End <name> around the code of interest. Performance Advisor shows these regions on the frame rate analysis chart and in dedicated per‑region charts.
When should I use channels instead of single markers?
Use channels to annotate durations on specific threads, such as asset loading or enemy spawning. Channels provide labeled spans that make it easier to trace long‑running operations alongside other events.
Next