19,423

Views

Beginner

Level

15

Comments

Publishing a Desktop Game

by Jon (Updated on 2014-01-29)


Contents

  • Introduction
  • Windows
  • Mac
  • Linux
  • FAQ


Introduction

Stencyl supports the creation of native, standalone apps for Windows, Mac and Linux. These apps feature hardware accelerated graphics and consequently, better performance than their web or mobile counterparts.

Note: Publishing desktop games is a paid feature. Purchase a license to access this functionality.


Windows

Requirements

  • Windows XP / WIndows 7 or better. Windows Vista can be problematic.
  • Visual Studio 2010 or 2012. The free "express" editions are fine.
Tip: You can either install Visual Studio on your own, or if you attempt to run a Windows app from Stencyl, we’ll download the Visual Studio installer for you and then ask you to run it. We'll assume the latter.

 

Setup

1) After opening up a game in Stencyl, select Run > Windows from the main menu. 

2) Stencyl will download the Visual Studio installer to your system. After that finishes, run the installer.

3) Once you install Visual Studio, you’ll need to reboot your computer for Stencyl to recognize it.

 

Testing

To test your game, select Run > Windows from the main menu.

Tip: This step may take a while. You may find it useful to turn on the Log Viewer (View > Log Viewer) prior to running to see what's going on and catch any unforeseen errors.

 

Publishing

To publish your game, select Publish > Desktop > Windows from the main menu. This will export your game as a ZIP containing an EXE and the resources associated with the game.

Note: At this time, we don't support exporting the game to a single, bundled EXE. We tried to wrap them in the past using free solutions, but they were (wrongly) flagged by AV software, so we discontinued that experiment. If you must wrap an EXE, you can use a service such as Molebox to do this.


Mac

Requirements

  • A Mac with Mountain Lion (10.8) or better.
  • Xcode 5 or better.
  • Registration in the Mac Developer Program (if publishing to the Mac App Store)

 

Setup

1) If you don't have Xcode, install it from the Mac App Store.

2) Launch Xcode, go to its Preferences, flip to the Downloads Tab and install Command Line Tools.

xcode-command-line-tools

3) If you are publishing to the Mac App Store, you must set up your App on iTunes Connect.

 

Testing

To test your game, select Run > Mac from the main menu.

Tip: This step may take a while. You may find it useful to turn on the Log Viewer (View > Log Viewer) prior to running to see what's going on and catch any unforeseen errors.

 

Publishing

When publishing for Mac, you have two options. You can publish for the Mac App Store (.PKG) or export the game as an App Bundle (.APP) for providing on a personal website.

If you are publishing to the Mac App Store, view our dedicated article on that process.

If you are publishing an App Bundle, you can do so by selecting Publish > Desktop > Mac from the main menu.

 

Linux

Note: We’re not Linux experts, so if you run into issues, share your solutions on the forums, so all can benefit. Thanks!

 

Requirements and Setup

  • Ubuntu 11 or better is recommended but not required.
  • All standard build tools such as gcc/g++ should be installed.
Tip: Run sudo apt-get install ia32-libs-multiarch gcc-multilib g++-multilib to fetch those if you are unsure.

On Ubuntu 12 or better? Run sudo apt-get install gcc-multilib g++-multilib instead.

 

Testing

To test your game, select Run > Linux from the main menu.

Tip: This step may take a while. You may find it useful to turn on the Log Viewer (View > Log Viewer) prior to running to see what's going on and catch any unforeseen errors.

 

Publishing

To publish your game, select Publish > Desktop > Linux from the main menu.

 

FAQ

Q: Can I publish a Mac app from a Windows computer?
A: Nope. You’ll need to use a service like MacInCloud to do this or use a friend’s Mac. The same goes for any “cross” platform combination. You can only publish to the platform of your host computer.

 

Q: Can I publish to the Mac App Store?
A: Yep. We have an article on that

 

Q: How about the Windows Store?
A: You can, but we don't directly export to a Windows Store ready format. You'll need to wrap the app up on your own.

 

Q: I installed Visual Studio, but Stencyl claims I didn’t.
A: Did you reboot after installing it?

Disclaimer: All articles are geared towards Stencyl 3.0 and above. Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!

15 Comments

chesaro
Hello to everyone, i just finished the crash curse 1, and for the ones try/developing on linux (specifically linux mint 17, or ubuntu 14.04), i've just finished the last step (test your game), with the same steps as for ubuntu 12(.04), and one last advice, also install the

libsdl1.2-dev

library, and the test will run just fine (without it, well, it just won't :P)

Note: I'm using the most current (to date) version of stencyl, 3.1
Note2: I'm not sure if its relevant, but i also have the latest (to date) version of JDK 8.0

0 2 months, 5 days ago
tlm
Hi Jon (and others). I would like this document to clarify something for Linux. Specifically, "Ubuntu 11" and "Ubuntu 12" makes no sense. While it may seem that Ubuntu follows the traditional major_release.minor_release scheme, the version numbers are actually year.month, so there can be as much dfiference between 12.04 and 12.10 as there is between Stencyl 2 and Stencyl 3. Please clarify your instructions with actual Ubuntu versions.
0 4 months, 1 week ago
Jon
Heads Up: We're rewriting this article for 3.0 since none of this process applies in the new version.
0 6 months ago
ibensley
you have to run stencyl in administrator mode by right clicking it and selecting 'run as admin' that way you've given it permission
0 11 months, 2 weeks ago
yannage
I'm still getting this after trying to manually install the adobe air sdk and replacing the files. I tried in the beta version and the regular version and have tried reinstalling and am still getting this issue.

"Error
"Could not export, this may be because of file permissions
the following page may help"

0 1 year, 2 months ago
Jon
I've clarified that point to say that those paths are relative to your Stencyl install directory. It's simply a copy -> paste of the entire folder.
0 1 year, 5 months ago
jackymac36
I have the same issue an an macbook air ?
Any suggestions ?

0 1 year, 6 months ago
igaapp
I am getting an issue exporting to a Standalone App (.app) from using Stencyl Works on the Mac Pro. I'm getting a permission error when exporting to the Root Directory. I've also tried exporting to another folder using the chmod 777 command and restarting the computer. It did not resolve the problem. I attached an image to better explain my situation. Any help would be greatly appreciated.
0 1 year, 7 months ago
rogerrenno
I have a same problem :"Error
"Could not export, this may be beacuse of file permisions
the following page may help" Anyone, please Help me...!!!!

2 1 year, 9 months ago
remygames
Why does the PC standalone export make more than one file for the executable? Shouldn't they all be compiled into a single AIR app? Ont he mac, I get just one file.
0 2 years, 1 week ago

Sign In to Comment