User Guide (Version 1.16)

iOS Support

This feature is in preview release and is subject to change.

You can use Lumberyard to build your games for iOS devices that use the A8 GPUs, including iPhone 5s and newer. For more information, see Creating Android and iOS Games. In addition, GMEM and Metal support enables you to use Lumberyard to create high fidelity visuals by talking directly to the hardware, using the latest rendering techniques, and pushing more data to the GPU.

Lumberyard includes four iOS-supported sample projects that you can use to learn how to build assets for iOS games using the Asset Processor, build shaders using the remote shader compiler, and build and deploy iOS applications using the Lumberyard build tools.


To build games for iOS, Lumberyard requires the following on your Mac:


Lumberyard Editor requires Windows 7 or later to edit levels and build game assets. You must have access to a PC with Lumberyard installed and be able to navigate and run commands from a Terminal window on your Mac.

Setting Up Your Mac

Download and extract Lumberyard on your Mac using the Lumberyard Mac Support Files download. This contains all the source code and tools you need to build your iOS game. Then run the Lumberyard Setup Assistant to install the third-party software that is required to run the game and compile the game and engine code for iOS devices.

To run Lumberyard Setup Assistant on your Mac

  1. On your Mac, in a Terminal window, navigate to the /dev/Tools/LmbrSetup/Mac/ directory at the root of your Lumberyard installation.

  2. Run Lumberyard Setup Assistant by double-clicking the app in the Finder or by running the from the command line.

  3. In Lumberyard Setup Assistant, on the Get started page, select Compile for iOS devices and Compile the Game Code. Click Next.

  4. Follow the instructions onscreen to complete the installations for any third-party software or SDKs that you need. For more information about using Lumberyard Setup Assistant, see Using Lumberyard Setup Assistant to Set Up Your Development Environment.

  5. To get started with building and deploying your Lumberyard game for iOS, do the following:

    1. Build your iOS game executable. For information, see Configuring and Building iOS Games.

    2. Build the assets to include with your iOS game. For information, see Building Game Assets for iOS Games.

    3. Launch the remote shader compiler. For information, see Running the Remote Shader Compiler.

    4. Deploy your iOS game. For information, see Deploying iOS Games.

    5. Prepare your iOS game for distribution. For information, see Creating iOS Release Builds for Distribution.