macOS

January 26, 2026 ยท View on GitHub

Prerequisites:

Note

Most environment setup tasks can be accomplished by executing the setup-macos.sh script located in the /tools/scripts/ directory by running the following command from within a terminal window at the root of the repository:

./tools/scripts/setup-macos.sh

If you want to do that work manually, please refer to the following:

  • The standard Prerequisites for all platforms.
  • macOS Device
  • Unity macOS build module
  • XCode
  • Native Libraries
    • Required for running Unity Editor
    • Required if using RTC (Microphone) functionality

Building Native Libraries

  • Run EOS Plugin -> Advanced -> Build Libraries -> Mac to build the dylibs needed for the mac build.

    • Set the path of make at Edit -> Preferences -> EOS Plugin -> Platform Library Build Settings -> Make path
    • By default the path is /usr/bin/make or usr/local/bin/make

  • Alternatively, manually use the makefile in lib/NativeCode/DynamicLibraryLoaderHelper_macOS/ by opening the terminal at the folder and running the command:

    make install

Mac-Specific Caveats

  • If running the plugin in UnityEditor, after modifying the configuration settings, a UnityEditor reboot is needed for the changes to take place.

  • With Unity 2021.3.16f1 on Mac, building while overwriting the old build can cause some weird behavior. Delete the old build or perform a "clean" before compiling in order to avoid this problem.

  • If opening the project in Xcode, use Unity 2021.3.20f1 or later to avoid an error.

  • If opening the project in Xcode, do not enable the Address Sanitizer setting due to a known Unity bug.

  • The plugin does not support building for Windows on a Mac.