User Guide (Version 1.16)

Deploying iOS Games

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

Before you can deploy your games to iOS devices, you must ensure the shader compiler (located in the lumberyard_version\dev\Tools\CrySCompileServer\x64\profile directory) is running on your PC. For more information, see Running the Remote Shader Compiler.

To deploy your game to an iOS device

  1. On your Mac, open the Xcode solution that you generated (located in the Solutions folder in the directory where you installed Lumberyard). For example, the file could be called LumberyardiOSSDK.xcodeproj.


    In the Autocreate Schemes dialog box, select Automatically Create Schemes. This will happen the first time that you open your project.

  2. Build, run, and debug your application on an iOS device as you would any Xcode project. For information, see Launching Your App on Devices.


    The simulator is not supported. In order to deploy, run, or debug your application, you must use a physical device running iOS 9 or later that is connected through USB to your Mac. You can build without a physical device connected.

  3. (Optional) Load different levels by editing the SamplesProject/autoexec.cfg file and running the game from Xcode again. iOS supports the Advanced_RinLocomotion level.

  4. Use the following controls to navigate around your game:

    • Switch between cameras by selecting the buttons in the lower right corner of the screen.

    • Move Rin in the Character Controller view by touching the left side of the screen.

    • Look around the Character Controller view by touching the right side of the screen.

    • Jump in the Character Controller view by double-tapping anywhere on the screen.