Menu
Lumberyard
User Guide (Version 1.13)

Configuring and Building iOS Games

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

Configure and build various targets of your game before deploying your games to iOS devices.

When you build your game project using Waf, you must specify the enabled game project by doing one of the following:

  • Provide the game project name in the build command: --enabled-game-projects=project_name

  • Edit the user_settings.options file (located in the \lumberyard\dev\_WAF_ directory) to set enabled_game_projects to the name of your project.

    [Game Projects] enabled_game_projects = MyProject

You can also modify the configure command to include the following option, which automatically updates the user_settings.options file: --update-settings=True

To configure your game to build for iOS

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

  2. To generate an Xcode project and prepare the Lumberyard build system to build your iOS app, run the following command: sh lmbr_waf.sh configure --enabled-game-projects=project_name

    For example, if you are using the Samples Project, run the following command: sh lmbr_waf.sh configure --enabled-game-projects=SamplesProject

To build your game for iOS

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

  2. Build various targets of your game:

    • To build debug, run the following command: sh lmbr_waf.sh build_ios_debug -p all

    • To build profile, run the following command: sh lmbr_waf.sh build_ios_profile -p all

    • To build release, run the following command: sh lmbr_waf.sh build_ios_release -p all