Oculus Debugger

Overview

Native debugging on Quest is a frequently reported developer pain point. Many game studios use Visual Studio and Android Studio for development, neither of which are well supported for their development needs on Quest.

To help those studios and Oculus Developers, we built the "Oculus Debugger" VSCode extension which is primarily meant for real-time debugging of Unreal Engine games for Oculus, but it also fully supports debugging both Oculus Applications (i.e. APK files) and Oculus Native C/C++ binaries.

Oculus Debugger will need to download an additional runtime to your device in order to operate, including the LLDB debugger binaries. This runtime will download after you initiate your first debug session and agree to the associated terms.

Features

• Attaching to and/or launching targets defined in launch.json.
• Supports debugging Native C/C++ (ELF) binaries.
• Supports debugging Oculus Applications shipped via APK files.
• Uses LLDB debugger which is downloaded from our servers so no additional setup is required.

Usage

Reference the usage guide for more details.

Troubleshooting

Reference the troubleshooting page to help solve most common issues.

Feedback and Questions

You can find the full list of current/closed issues at our Github Issue Tracker. Feel free to submit a bug or a feature suggestion there.

Terms and Data Policy

Your use of Oculus Debugger is governed by the Oculus SDK License and Oculus Privacy Policy.

Data and Telemetry

Oculus Debugger collects usage data and sends it to Facebook, which is used to improve this product. If you want to opt out, you can set the fb-lldb.disableTelemetry setting to true.