Installing Solar2D — Windows

This guide will help you get up and running with Solar2D for Windows.

Installing Solar2D

You do not need to install the Android SDK to use Solar2D. However, to create device builds to test on actual Android devices, you will need the Java Development Kit. The installation process is described below.

We'll assume you've already downloaded Solar2D. Now, double click the .msi installer file and follow the steps in the installation wizard.

Java Development Kit

Installing JDK is no longer required for Solar2D 2020.3629 and later.

Installing Solar2D lets you create and test apps locally on your PC. If you intend to build apps for testing on Android devices, you will need to install the Java Development Kit (JDK). We suggest that you follow these instructions:

  1. Go to JDK8 download page.
  2. Click the JDK download link to obtain the corresponding Java Platform (JDK).
  3. On the next page, read the license agreement and click the option to accept it if you agree.
  4. Locate the Windows x86 link and click it to download the file. This file will be named approximately jdk-8u261-windows-i586.exe.
  5. When the download is complete, run the installer. Be sure to install the Java Runtime Environment (JRE) as part of the installation.

Text Editors

You'll need a text editor or IDE to write code for your Solar2D projects. If you don't already have a favorite text editor, the following options are recommended:

Development Environment

The Solar2D development environment consists of two aspects: the Solar2D Simulator and the Solar2D Console window.

Simulator Options

The Solar2D Simulator for Windows features the following basic menu items:

Command Line Usage

To start a particular app in the Solar2D Simulator without double-clicking it, use a command like this:

"C:\Program Files\Corona Labs\Corona\Corona Simulator.exe" "C:\Documents and Settings\MyAccount\My Documents\Corona Apps\My App\main.lua"

If you don't want the Solar2D Simulator Console window to automatically appear, use the /no-console option:

"C:\Program Files\Corona Labs\Corona\Corona Simulator.exe" /no-console

After using the /no-console option above, all Lua print() functions and Solar2D log messages can be received via the standard output stream (stdout).

One additional flag is allowed (/debug) which allows an IDE to connect a debugger to the Simulator session. It should come immediately after the .exe.

Getting Started

If you're new to Solar2D, the most fun way to learn is to create a simple game. Don't worry if you've never created a mobile app or programmed before — the chapters in the guide will walk you through the entire process from start to finish!