Installing Haxe on Windows

Getting Haxe to run on windows ranges from simple to mild difficulty. Currently, there are two methods of installation that you can choose: automatic installer and manual. With the automatic installer, the installation will be automated with minimal user intervention with only two real steps to preform. The manual, on the other hand, offers the most flexibility and almost always works, but requires some technical operations.

Automatic Installer


The Haxe windows installer package is the easiest method to install all the required components, and automates many of the tasks that need to be preformed. The automatic installer also updates a previously installed version of Haxe and Neko. Note: the installer requires internet access. If you are behind a proxy, please follow the Manual Installation.

Requirements

  • Windows 98 or greater.
  • Internet Access.

1. Download the Executable


First, obtain the windows installer file from the Haxe download page. This is the executable that will run the installer/updater.

2. Launch the Executable


Double click the executable. Several windows will appear, a series of command windows, and another window titled Haxe Installer. You can ignore the command windows as they're checking for previous versions of Haxe and Neko, it will quickly close. The Haxe Installer window will display several lines of text. This text will display to you what it is currently working on and any errors that may occur.

Follow the instructions provided by the installer. At the end, you will either be greeted with an error message stating the install failed or the installation will be a success and you can exit out of the Haxe installer. At this point, you can go to go validate installation section.

Manual Installation


The manual installation involves a lot more technical work, but allows for users to refine the development environment a bit more. Although, this type of installation does not have the facility to update Haxe to the latest version with a single click like the automatic installer.

Requirements

  • None

1. Obtain Haxe


You can download the manual Haxe installation binary from the Haxe download page.

2. Unpack Haxe Archive


Extract the contents of the Haxe zip file to your desired location (I use C:\Haxe).

3. Obtain Neko


Download NekoVM windows binary from the NekoVM website.

4. Unpack NekoVM Archive


Extract the contents of the NekoVM zip file to your desired location (I use C:\Neko).

5. Add Neko and Haxe to Path


This step varies for different versions of windows. Select the section that applies to your OS.

Windows 2000/XP

  • Right click "My Computer" and select "Properties"
  • Under the Advanced tab, click the [Environment Variables] button at the bottom of the window.
  • Under the System Variables section:
    • Select the variable heading the entry named path and click the [edit] button.
    • In the Variable Value field, without deleting what is already there, type a semicolon and then type where you installed Haxe and NekoVM.
      • For example: %SystemRoot%\system32;%SystemRoot;C:\Haxe;C:\Neko;
      • Note: if you extracted the archives to different locations than this tutorial, then you will need to substitute these values in when adding them to the Path.
    • Click [ok]
  • Click [ok]
  • Reboot your computer. This may not be needed, but some systems require restart.
  • Proceed to validating installation

Windows Vista

  • Click the start orb
  • Right click Computer and select Properties
  • Click on Advanced System Settings located in the left sidebar Requires user elevation
  • Click the [Environment Variables] button
  • Under the System Variables section:
    • Select the variable heading the entry named Path and click the [edit] button.
    • In the Variable Value field, without deleting what is already there, type a semicolon and then type where you installed Haxe and NekoVM.
      • For example, %SystemRoot%\system32;%SystemRoot;C:\Haxe;C:\Neko;
      • Note: if you extracted the archives to different locations than this tutorial, then you will need to substitute these values in when adding them to the Path.
    • Click [ok]
  • Click [ok]
  • Reboot your computer. This may not be needed, but some systems require restart.
  • Proceed to valdating installation

Validating Installation


To validate that the installation was successful:
  • Open a command prompt by selecting Start->Run and typing cmd.
  • Try to launch Haxe by typing haxe in the command window.
    • If you are shown usage instructions, the installation was a success.
    • If you're greeted with "command not found", check that you typed the location of the haxe installation properly in your path.
  • Try to launch Neko by typing neko in the command window.
    • If you are shown usage instructions, the installation was a success.
    • If you're greeted with "command not found", check that you typed the location of the haxe installation properly in your path. In addition, see the NekoVM website for additional installation instructions.

Common Issues


'haxe' is not recognized as an internal or external command, operable program or batch file.
'neko' is not recognized as an internal or external command, operable program or batch file.
  • This is a sign that that path value is incorrect. Check for typos under the Environment Variables tab.

ERROR = Failed to connect on blah.motion-twin.com:80

  • Check your network connection and ensure you have Internet access. Remember, if you are behind a proxy, the Haxe automatic installer will not work.

On Win7-64 a strange error occurs with the registration of the environment variables, which possibly has to do when you are working as a normal user and not as admin:
the variables HAXEPATH and NEKO_INSTPATH only get "installed" for the admin of the system, you have to manually add those to the system-vars. Also: the HAXEPATH ends with a slash, NEKO_INSTPATH.

version #13672, modified 2012-04-14 20:34:58 by elyon