Table of Contents

Log Analysis on iOS/macOS/visionOS

For logs on native (iOS/macOS), Unity (iOS/macOS/visionOS), and Unity Editor (macOS), refer to the following instructions.

How to obtain logs

If you need to analyze an app on an iOS/visionOS device, connect the device to a macOS development device using a USB cable. If you need to analyze an app or program on a macOS device, this step is not required.

On the macOS development device, open Finder -> Applications -> Utilities -> Console. In the Console, click Start streaming, then run the program you want to analyze. Open the app or program until logs appear in the Console. Right-click on the log and select Show Process "<app name>" to view all logs for that app or program process.

Here is an example.

log macOS

Press Cmd + A to select all logs, then press Cmd + C to copy the logs to the clipboard.

For programs on macOS, if it is a command-line program, you can also obtain log output from the terminal.

Additionally, you can debug the app or program through Xcode and obtain logs from Xcode's log window.

Unity built-in logs

When developing apps with Unity, in addition to the platform's native log analysis methods, the Unity Editor provides additional debugging tools.

Unity logs are divided into Unity Editor logs and Unity Player logs, which can be obtained through the following methods.

Unity Environment Operating System Log Location
Editor macOS ~/Library/Logs/Unity/Editor.log
Player iOS Use Xcode's lldb console
Player macOS ~/Library/Logs/Company Name/Product Name/Player.log

Editor logs can also be opened via the Open Editor Log command in the top-right menu of the Console window.

Understanding logs

When analyzing errors, it is often necessary to clarify the conditions under which the error occurred, such as the called function, parameters, and related states.

Notes for feedback

  • Version numbers of EasyAR Sense and EasyAR Sense Unity Plugin

    e.g., 4.7.0.11800-cf8e24e30

  • Community Edition/Enterprise Edition

  • Platform and CPU architecture

    • iOS

      arm64

    • macOS

      x86_64/arm64

    • visionOS

      arm64