When requested by ArborXR Support as part of the troubleshooting process for any issues you report, you can gather local device logs, or logcat, from your device using ADB along with a specific build of the ArborXR Client app with logging enabled provided by the ArborXR Support team.
A logcat can be gathered in a few ways:
Via the third-party app, Sidequest.
From a command line tool (like Terminal in macOS or Windows PowerShell) using the
adb(Android Debug Bridge) tool.
Gather the log file using Sidequest
In the upper right corner, click the Run ADB commands button within the Sidequest app (a square button with an arrow inside of it, pointing to the right).
Before starting, ensure the device is connected to the computer with a USB cable, then select the desired output folder for the logcat file by clicking Pick Output Folder.
💡When selecting a download location, it is recommended to set it to a folder (e.g. - Documents or Downloads) and not at the top level of the selected hard drive.
Click Start, then, going into the headset, repeat the steps within it to replicate the issue.
Once you have sufficiently replicated the issue, click Stop within Sidequest. The logcat file will save to the location you designated in Step 4 as logcat.log.
Once you have located the Logcat file in your saved folder, share it with the ArborXR Support representative.
Gather the log file using the command line (ADB)
If you are comfortable with the command line and have ADB installed on a CLI (command line interface) app like PowerShell (Windows) or Terminal (macOS), the following command can be run while the trouble device is plugged into the same computer. We won't be going over the steps to install ADB in this article, but there is a good deal of resources with a quick Google search that can assist further to help with installing ADB!
Run the command and share the file
Simply enter the command below, changing the
/path/to/file to the desired location on your local computer, then press Enter/Return on your keyboard to begin the log capture:
adb logcat > /path/to/file/logcat.log
💡 NOTE: The ADB tool may not provide any feedback once started, but details will be gathered in the log file as activity occurs within the device. Once the reproducible event has been completed during the logcat capture, click Ctrl + C (Windows) or Cmd + C (macOS) to stop the capture. Once completed, send the saved log file to the ArborXR Support representative you are partnering with.