Frame Capture Debugging Tools
Analyze and optimize your app performance at runtime.
Xcode provides a suite of tools that enable you to halt the execution of your Metal app and inspect its commands and data buffers. You take a snapshot of your app's Metal commands and data using a mechanism called GPU frame capture, then use the debugging and performance tools to operate on the data you collect.
When you're ready to capture a frame, click the camera button in Xcode's debug bar. Alternatively, you can invoke a frame capture using a breakpoint, or programmatically with the capture API during the runtime conditions you choose.
Capturing a Frame Programmatically
Choose the commands you want to analyze, and define the runtime conditions to present them in the Metal frame debugger.
Customizing Frame Capture
Debugging Your App
Viewing Your Frame Graph
View your render passes as a flow chart to inspect resource dependencies and understand which commands wait on others to complete.
This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.Learn more about using Apple's beta software