GameSalad

GameSalad

Rank: ?
points: ?

As part of the Mac GameSalad Creator 0.10.00 update, we’ve rolled out a smoother and more powerful way for users to manage their portfolios with the addition of Web Publishing! 

Note: GameSalad Creator version 0.10.00 is the update immediately following the 0.9.94 release. For more information on why and how we adjusted the version numbers associated with our releases, please visit our forum announcement on the topic at http://forums.gamesalad.com/discussion/47652/update-gamesalad-version-number-changes

In this Cookbook entry we’ll be walking through the various aspects of the new Web Publishing flow for Mac Creator. For developers new to GameSalad Creator, publishing refers to the act of taking your project file and turning it into an .app (Mac Desktop, iPhone, or iPad game), a signed and unsigned .apk (Android publishing, which is a feature available to Pro members), or a GameSalad Arcade/HTML5 game that is playable at http://arcade.gamesalad.com/arcade

For iOS and Android publishes, the resulting file can then be used to install your game onto a mobile device (such as an iPhone or Kindle Fire) so you can test your game in the most authentic environment available (also known as ad-hoc testing).

Note: With the exception of the Arcade/HTML5 platform, publishing is a separate and distinct process from submitting your game to an application distributor, such as the Apple App Store or Google Play. During HTML5 publishing, users can choose whether to make the game visible to everyone or only visible to themselves, if the game is a work in progress.

If you’d like to follow along with this guide as we go but don’t have a project file you’re ready to publish with, don’t worry! Simply open up one of the template project files in the ‘Create a New Project’ column of the new dashboard and use that project to go through publishing process with. 

Note: You can access your new Web Publishing portfolio at any time at http://publish.gamesalad.com/games
A new feature with Web Publishing is being able to permanently delete games from your portfolio, allowing you to stay better organized by keeping your portfolio tidy.

If you haven’t already, this is a good time to take a moment to sign into your GameSalad account using the ‘Sign In’ button in the lower left-hand corner of Mac Creator. A login prompt will appear, where you can sign in using your email and password credentials. If you don’t already have an account, click the ‘Create an Account…’ button to be brought to our website’s registration page. You’ll also find an option to recover a forgotten password here, should you have need of it.

Note: Already have an account but still having difficulty logging in? Please contact GameSalad Customer Support at helpdesk@gamesalad.com for assistance. For all issues not relating to login problems, we ask that users write in using our contact form at http://arcade.gamesalad.com/support, which allows us to response more quickly to users’ inquiries by staying better organized.

We won’t be making any edits to the project file itself, and instead we’ll head directly into the new Web Publishing process by using the ‘Publish’ button in the upper right-hand corner of the Mac Creator window.

Creator Publish A

If you use a template project (or any new/unsaved project file) to go through the publishing process, it will first prompt you to save the project file, before allowing you to continue on. If your project has previously been saved, the Creator will prompt you to confirm that you wish to upload this file. Select ‘Upload’ to continue on.

Upload Project C

This will now launch your default web browser, which attempt to the first step in the new Web Publishing process: Asking you whether you want to create a new game in your portfolio or update an existing game.

Now Publishing

Note: If you are not currently logged into your GameSalad account on our website prior to uploading, you’ll be prompted to log in now. After signing in, the website will automatically navigate you to the first Web Publishing step, motioned above.

For this walkthrough, we’ll be selecting ‘Create New Game’.

Note: Projects published in GameSalad Creator versions previous to 0.10.00 will not appear in the new web-based portfolio or in the ‘Update Existing Game’ list. Users who wish to populate their online portfolio with previously created games will need to re-publish these projects using the new Web Publishing process.

After selecting ‘Create New Game’, you’ll see the following screen, which we’ll cover in detail in this guide.

New Game Top

New Game Bottom

Note: Before we move on to the rest of the publishing process, take a moment and locate the 'Download' and 'Remove' buttons, in the upper-right corner of the above screenshot. The 'Download' button will allow you to save a local copy of the uploaded project file onto any computer. You can use this to assist in transferring your project files between computers, as well as to download a back-up copy of your file should the original become lost, corrupt, unintentionally changed, or accidentally deleted. Furthermore, the 'Remove' button provides users with an easy way to keep their portfolio well organized. Please note that removing a particular entry from the web portfolio will also remove it's corresponding project file, making it unavailable for any future download attempt.

The primary Web Publishing user interface is divided into three sections: The top header and the left-hand column, with the rest of the window’s space used to show various settings, info, and configuration options.

The top header is where you’ll be able to set the title of your game (be sure to select ‘save’ after you change this!), upload an icon, and track your progress towards being able to list your game on the GameSalad Arcade.

Note: Users are now able to upload either 512 by 512 or 1024 by 1024 PNG icon during publishing. We recommend using a 1024 by 1024 icon, as some third-party application distributors now require these dimensions. As an added convenience, 1024 by 1024 images will automatically be down-scaled to the appropriate dimensions as required.

In the left-hand column you’ll see several top-level categories, including: General Info, Services, Platforms, and Notifications Log. Depending on which item you select from this column, the area to the right of the column will change to show different options and information.

Immediately upon selecting ‘Create New Game’, you’ll be defaulted to the ‘General Info’ tab. The options displayed for this tab are used in combination with HTML5/Arcade publishing, which we’ll be covering later in this walkthrough. For now, I’d like to draw your attention to the sub-categories listed under ‘Platforms’ in the left-hand column: Android, HTML5 (aka GameSalad Arcade), iPad, iPhone, Mac, and New.

Platform Options

The red-boxed numbers indicate the number of remaining notifications left for each particular platform.

Note: While every platform will be listed for each uploaded project file, this does not mean that the game will run ideally on all platforms as-is. Users will still need to tailor their game to fit each platform they wish to publish for, just as they did prior to GameSalad Creator version 0.10.00.

At this point in the walkthrough, we’ll be going over each platform’s publishing requirements individually, so feel free to jump to the specific section that is relevant to your particular platform target.

Note: Mousing over the various book/question mark icons found throughout the Web Publishing process will trigger helpful and informative tool-tips to appear.

iPad/iPhone (iOS)

Sections required for publishing:
• Icon (Note: Icon upload located in the top header section)
• Display Name
• Version Number
• Bundle ID
• Minimum Support OS Version (Note: Defaults to the minimum version of 4.0)
• Supported Orientations

Optional sections:
• Nickname (Note: This field no effect on the published file. Allows users to customize the name of tabs under ‘Platforms’)
• Custom Loading Image
• Service Configuration (Note: Be sure to also check out the ‘Playhaven’ tab, under ‘Services’)
• App Store URL (Note: Only applicable to games which are also published to the GameSalad Arcade)

Additional requirements:

Apple requires that all iOS applications be signed with a valid Developer Certificate. For more information and instructions on setting your Provisioning Profile, Developer Certificate, and Keychain, please visit our Cookbook article on the topic at http://cookbook.gamesalad.com/tutorials/3/parts/12 or log into your Apple Developer account to review official documentation at https://developer.apple.com.

Choose Prov Profile P

Note: Once you're ready to distribute your iPhone game on the Apple App Store, be sure to sign it with a Distribution Provisioning Profile, rather than a Development Provisioning Profile. Apple will not accept applications via the Application Loader unless they are signed with a Distribution Provisioning Profile. In addition, keep in mind that your .app must be compressed (.zip) before the Application Loader will consider it a valid file for upload. For more information on the Application Loader, please review Apple's documentation at https://itunesconnect.apple.com/docs/UsingApplicationLoader.pdf

Mac Desktop

Sections required for publishing:
• Icon (Note: Icon upload located in the top header section)
• Display Name
• Version Number
• Bundle ID

Optional sections:
• Nickname (Note: This field no effect on the published file. Allows users to customize the name of tabs under ‘Platforms’)
• Start App fullscreen by default
• Enable Glossy App Icon
• Custom Loading Image
• App Store URL (Note: Only applicable to games which are also published to the GameSalad Arcade)

Additional requirements:

Apple requires that all Mac Desktop applications be signed with a valid Developer Certificate. For more information and instructions on setting your Provisioning Profile, Developer Certificate, and Keychain, please visit our Cookbook article on the topic at http://cookbook.gamesalad.com/tutorials/3/parts/12 or log into your Apple Developer account to review official documentation at https://developer.apple.com.

Note: Once you're ready to distribute your Mac Desktop game on the Apple App Store, be sure to sign it with a Distribution Provisioning Profile, rather than a Development Provisioning Profile. Apple will not accept applications via the Application Loader unless they are signed with a Distribution Provisioning Profile. In addition, keep in mind that your .app must be compressed (.zip) before the Application Loader will consider it a valid file for upload. For more information on the Application Loader, please review Apple's documentation at https://itunesconnect.apple.com/docs/UsingApplicationLoader.pdf

Note: Mac Standalone applications will now need to be signed with the Developer ID to run on Mountain Lion OS X. To sign a Mac Desktop application with your own Developer ID, please refer to the following documentation provided by Apple: https://developer.apple.com/library/mac/#documentation/Security/Conceptual/CodeSigningGuide/Procedures/Procedures.html#//apple_ref/doc/uid/TP40005929-CH4-SW2