Skip to content

Getting Started with Siv3D Programming on macOS

1. System Requirements

1.1 Developer System Requirements

  • The development environment required for Siv3D programming on macOS is as follows:
OS macOS Ventura / Sonoma / Sequoia
CPU Intel CPU / Apple Silicon (Rosetta mode)
GPU OpenGL 4.1 support
Video Output Any video output device such as a monitor
Development Environment Xcode 14.3 or later
  • Apple Silicon (M1 - M4) will have native support starting from Siv3D v0.8.0, which is currently in development.
  • Until then, it operates in Rosetta mode.
If you cannot install Xcode
  • If your version of macOS is not the latest, you may not be able to install Xcode from the App Store.
  • In that case, download and install a previous version of Xcode, such as Xcode 14.3, from the Apple Developer site .

1.2 App Runtime System Requirements

  • The environment required to run applications developed with Siv3D v0.6.16 on macOS is as follows:
OS macOS Mojave / Catalina / Big Sur / Monterey / Ventura / Sonoma / Sequoia
CPU Intel CPU / Apple Silicon (Rosetta mode)
GPU OpenGL 4.1 support
Video Output Any video output device such as a monitor
  • Apple Silicon (M1 - M4) will have native support starting from Siv3D v0.8.0, which is currently in development.
  • Until then, it operates in Rosetta mode.

2. Download Project Templates

  1. Download OpenSiv3D v0.6.16 Project Templates for macOS and extract the files.
  2. On macOS Catalina and later, file access permission dialogs will appear every time you run a program. To avoid this, move the project folder to the (username)/Applications folder (the user's Applications folder, not the root Applications folder) instead of the (username)/Desktop or (username)/Downloads folders.
Previous Versions

3. Build a Siv3D App

  1. Open the project file examples/empty/empty.xcodeproj from the project templates in Xcode.
  2. A sample program (Main.cpp) is provided by default.
  3. For M1 - M4 Macs, enable Rosetta mode by following the steps described below.
  4. Press the Run button ▶️ to build and run the program.
  5. To exit the running program, press Esc or close the window.
Enabling Rosetta Mode on M1 - M4 Macs
  • The method to display Rosetta options in Xcode varies depending on the Xcode version:
    • Xcode 15.3 and later: From the menu bar, select Product > Destination > Show All Run Destinations.
    • Xcode 15.2 and earlier: From the menu bar, select Product > Destination > Destination Architectures and then Show Rosetta Destinations.
  • Once the Rosetta option is displayed, select it.
Avoiding File Access Permission Dialogs
  • On macOS Catalina and later, file access permission dialogs may appear every time you run the program.
  • This can be avoided by moving the entire project folder to the (username)/Applications folder (the user's Applications folder, not the root Applications folder) instead of the (username)/Desktop or (username)/Downloads folders.
How to add a new project
  • Copy the empty folder from the project template folder into the same directory.
  • A project generator for Xcode is planned for a future release.
If the program runs but the editor shows red, error-like displays
  • This is a known issue with recent versions of Xcode. It does not affect execution.
  • This will be resolved in Siv3D v0.8, which is currently in development. Your patience is appreciated.