iOS Game Options

This section outlines the different options available to you that control how your iOS game projects will be compiled. The different sections are:

 

General

iOS General OptionsThe first part of the General section covers Build Settings for your game. To start with you set the Orientations that your game can be run on for the best user experience. The available options are:

You can then go to the Device Support section, with the following options available for setting what type of device to target:

The second thing to do is fill in the Product Information about your game, including its Display Name, its Bundle ID and the Version info. Note that the Bundle ID must be in the correct reverse URL format for the final build of the game to work correctly, EG: com.[Company].[GameName]. Here you can also give the Team Identifier that you wish to use for signing the final application that GameMaker Studio 2 creates for you. Setting it here will override the Team ID that you have supplied in the iOS Preferences.

Next, you can check or un-check the option to Defer Home Indicator Output. When this is checked, the home bar will always be shown at low a alpha, and the first swipe wakes the bar and the second swipe takes you home. If the option is un-checked, then the bar is not shown in-game, but the first edge swipe will take you home. Default is un-checked.

Finally, you have the option to generate a Podfile and a Podfile.lock. These files are required if you are adding CocoaPods to an iOS extension using the Extension Editor. The files contain specific macros required by GameMaker Studio 2 to setup any listed CocaoPods when building your game. Clicking the buttons will create the files with the macros pre-generated, and also open a file explorer on the location of the files, should you wish to manual edit them. There is also a button that will take you to the following guide:

 

Graphics

iOS Graphics OptionsHere you can change the following details related to how your game will be displayed, with the following options available:

Finally there is the option to set the size of the texture page. The default (and most compatible) size is 2048x2048, but you can choose from anywhere between 256x256 up to 8192x8192. There is also a button marked Preview which will generate the texture pages for this platform and then open a window so that you can see how they look. This can be very useful if you wish to see how the texture pages are structured and to prevent having texture pages larger (or smaller) than necessary. For more information on texture pages, please see here.

NOTE: Be aware that the larger the size of the texture page, the less compatible your game will be with different browsers and devices.

 

Icons

iOS Images Icons OptionsThis section permits you to add the various different icons required by the various iPhone and iPad devices and the different parts of the iOS App Store. These icons should be authored as 24bit *.png images at the size specified for each one.

It is worth noting that GameMaker Studio 2 has a Project Image Generator tool which can be used to automatically create all the images required for all the different target platforms your game is being compiled to. If you use this tool, you should revise the images created to ensure that they are what you require. The tool will generate Icons as well as Images (see the section below).

NOTE: On importing an older project you may be presented with the following warning:iOS Icon WarningThis comes up because the current iOS target version has changed the format of the required icons since the project was previously loaded. You will be required to re-create all the icons, as they will have been replaced with the generic GameMaker Studio 2 icons (you can use the above mentioned Project Image Generator tool to do this quickly).

 

Images

iOS Images Splash Screens OptionsThis section permits you to add separate graphics as Launch Screens (the image that will be shown briefly while your app loads) for each of the device orientations, as well as the Border Colour that will be used as the background for launch screens that are not set to fill the full screen. These images must be authored as individual 24bit *.png images with no transparencies and at an appropriate size. Note that this is not considered a splash screen and Apple have some fairly strict guidlines on how this should be set up and used. See the developer page on Human Interface Guidelines for more information.

You can also set how the launch screen should be displayed from the following options:

 

Social

iOS Social OptionsThis section is for enabling different Social features in your iOS game. The following options can be chosen: