Skip to content

Getting Started with Siv3D on macOS

1. System Requirements

1.1 Developer System Requirements

The necessary development environment for Siv3D programming on macOS is as follows:
OS macOS Big Sur / Monterey / Ventura / Sonoma
CPU Intel CPU / Apple Silicon (Rosetta mode)*
GPU OpenGL 4.1 compatible hardware
Output Devices Monitors
IDE Xcode 12.5 or newer
  • Native support for Apple Silicon (M1 - M3) will be added in the currently under development Siv3D v0.8.0.
If you cannot install Xcode

If your macOS OS version is not the latest, you may not be able to install Xcode via the App Store. In that case, please download a previous version of Xcode, such as Xcode 13.2, from the Apple Developer site .

1.2 System Requirements for Running Siv3D Application

The necessary environment to run applications developed with Siv3D v0.6.15 on macOS is as follows.
OS macOS Mojave / Catalina / Big Sur / Monterey / Ventura / Sonoma
CPU Intel CPU / Apple Silicon (Rosetta mode)*
GPU OpenGL 4.1 compatible hardware
Output Devices Monitors
  • Native support for Apple Silicon (M1 - M3) will be added in the currently under development Siv3D v0.8.0.

2. Downloading the Siv3D Project Template

  1. Download and extract OpenSiv3D v0.6.15 Project Templates for macOS.
  2. If you are on macOS Catalina or later, a dialog box for file access permission appears every time you run the program. To avoid this, move the project folder to (Username)/Applications folder (not the root's Applications folder, but the Applications folder in user's home), rather than (Username)/Desktop or (Username)/Downloads folders.
Previous versions

The use of past versions is discouraged. If necessary, download them from the following links. Due to updates to the compiler, etc., you may not be able to use past versions in the latest development environment. If you want to build an old Siv3D project, a good way is to port its source code to a project with the latest version.

3. Building a Siv3D App

  1. Open the project file examples/empty/empty.xcodeproj in Xcode.
  2. Open Main.cpp from the project menu
  3. If you are using an M1 - M3 Mac, enable Rosetta mode with the method described in the next section.
  4. Click Run button ▶️ to build and execute the application.
  5. To exit a running program, press Esc or close the window.
Enabling Rosetta Mode on M1 - M3 Macs

To display the Rosetta option in Xcode, follow these steps:

  • For Xcode 15.3 or later, go to Product > Destination > Show All Run Destinations.
  • For Xcode 15.2 or earlier, go to Product > Destination > Destination Architectures and select Show Rosetta Destinations.

Once the Rosetta option appears, select it.

Avoiding file access permission dialog when running the sample program

If a file access permission dialog appears every time you run on macOS Catalina or later, you can avoid this by moving the entire project folder to the (Username)/Applications folder (not the root's Applications folder, but the Applications folder in the user's home), rather than the (Username)/Desktop or (Username)/Downloads folders.

If you want to create another project

Please copy the empty folder located within the project template folder at the same level. A project generator for Xcode is planned for future release.