Publish your game to Windows, macOS and Linux manually using Electron and Electron Builder

From GDevelop you can publish your games to Windows, macOS and Linux. In order to export our game, click File on the top and select the Export option. You can then choose the first Windows, macOS and Linux option, which will use GDevelop online services to automatically build your game for these platforms.

If you want more control or have special needs, you can also choose Windows, macOS and Linux (manual) option. This option exports your game as an Electron project. Electron is a technology allowing HTML5 games and apps to be packaged as executables and access to the underlying system native features. Electron Builder can be used to automate the packaging and distribution.

Choose a folder

First, choose a folder where the game will be exported. It is recommended to choose an empty folder, at least for the first time, to avoid losing any file that could be overwritten by the export.

Launch export

You can then click on Export. The game will be exported to an Electron project.

You can then use Electron Builder to package your game as a Windows, macOS or Linux app.

Export to other platforms (Android, Web, Facebook Messenger...)

See the other export options to learn how to publish your game on other platforms!

Steps to Build the Project Manually

Download and Install Yarn

We will be using Yarn. Download the latest build of Yarn here. You can install Yarn using any method provided on that page.

Building the Package

  • Start up Command Prompt (CMD) with administrator rights. Change directory (cd) to the directory of the folder of your exported game (or navigate to that folder using Explorer and press Shift + Right Click → Open Command Prompt/Powershell for Windows)
  • In the Command Prompt (CMD), write:
yarn add electron-builder --dev
  • After the electron-builder installation is complete, in the Command Prompt (CMD) write:
yarn electron-builder build

Note: If your custom icon doesn’t show up, just rename buildResources to “build”.

These steps will create a sub-folder named dist. The executable installer is in this sub-directory. The win-unpacked sub-folder contains the executable game files which you can archive and distribute.