Building Atomic from Source

JoshEngebretson edited this page Jul 5, 2017 · 10 revisions

Quick and Easy Way:

If you are working on Atomic itself or need to debug an Atomic project with an IDE such as Visual Studio, XCode, QtCreator, please see this article Advanced

Please note: Building from source code is intended for users who want to use/test new features or customize the C++ source code. For most users, we recommend the binary releases available for download on the official Atomic Game Engine website.


Windows

  1. Make sure to have Visual Studio 2015 or 2017 installed with the C++ compiler toolchain and have CMake on your PATH.
  2. Clone the AtomicGameEngine repository recursively:
git clone --recursive https://github.com/AtomicGameEngine/AtomicGameEngine
  1. Double click Build_AtomicEditor.bat in the root folder or use
Build_AtomicEditor.bat

If you have both VS2015 and VS2017 installed, use the --vs2017 flag to select VS2017.

  1. Your build of the Atomic Editor will be built in Artifacts/AtomicEditor.

macOS

  1. Install XCode and CMake, making sure CMake is on your path
  2. Clone the AtomicGameEngine repository recursively:
git clone --recursive https://github.com/AtomicGameEngine/AtomicGameEngine
  1. Open a shell and change directory (cd) to the root repository.
  2. Build the Atomic Game Engine using
./Build_AtomicEditor.sh
  1. The latest AtomicEditor.app will be built in Artifacts/AtomicEditor

Linux

The following instructions will install the Atomic Game Engine without C# support. To install with C# support, read this page.

  1. Install prerequisite packages:

Ubuntu 14.04 LTS 64 bit, Debian Jessie 8.x 64 bit:

sudo apt-get install build-essential cmake nodejs libgtk-3-dev libasound2-dev libxrandr-dev libgl1-mesa-dev libglu1-mesa-dev

Fedora/CentOS 7.2 64 bit:

sudo yum install gcc gcc-c++ libgcc cmake ccache nodejs gtk3-devel alsa-lib-devel libXrandr-devel mesa-libGL-devel mesa-libGLU-devel  

openSUSE 64 bit:

sudo zypper install gcc gcc-c++ libgcc_s1 cmake ccache nodejs6 gtk3-devel alsa-devel libXrandr-devel Mesa-libGL-devel glu-devel
  1. Clone the AtomicGameEngine repository recursively:
git clone --recursive https://github.com/AtomicGameEngine/AtomicGameEngine
  1. Open a shell and change directory (cd) to the root repository. From here, run
sh Build_AtomicEditor.sh
  1. The AtomicEditor executable will be built in Artifacts/AtomicEditor

Atomic Editor Build Flags (Advanced)

The following build flags are supported by the Build_AtomicEditor(.sh/.bat) commands:

Flag Description
--help Displays all these flags
--with-android Build with Android platform support
--with-ios Build with iOS platform support
--with-web Build with WebGL platform support
--opengl Enable OpenGL renderer (if on Windows, D3D11 is default)
--d3d9 Enable Direct3D 9 renderer (if on Windows, D3D11 is default)
--debug Build debug version of the editor and associated platform runtimes
--noclean Do not clean before building, useful during development
--nonet Build without AtomicNET C# scripting support
--with-docs Build and install API documents into the editor (requires npm on path)
--noexamples Don't include examples with editor
--task=name Build the specified task (for development)
--package Packages the editor to Artifacts/Dist
--vs2015 Select Visual Studio 2015 (if both VS2015/VS2017 are installed)
--vs2017 Select Visual Studio 2017 (if both VS2015/VS2017 are installed)

The --nonet flag will automatically be applied if Visual Studio or mono isn't installed on the system

For example, if you want to build the editor without including examples, run the following from your root local source tree:

Windows

Build_AtomicEditor.bat --noexamples

macOS/Linux

./Build_AtomicEditor.sh --noexamples
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.