jgranick/hxp-vscode-extension

Visual Studio Code Support for HXP/OpenFL

The HXP extension for Visual Studio Code adds code completion, inline documentation, populates the Haxe dependency tree and provides build, clean, test and (other) tasks automatically.

This depends on the Haxe extension, and requires Haxe 3.4.2 or greater. You should also have HXP installed and properly set up.

Opening a folder that contains a project.xml, project.hxp or project.hxp file activates this extension. Optionally, you can set "hxp.projectFile" in the workspace settings.json file in order to specify a different file path. When activated, this extension adds support for changing the target platform, build configuration as well as additional command-line arguments.

About HXP

HXP is a flexible, cross-platform framework for native desktop, mobile and console development, and Flash, HTML5 and WebAssembly.

OpenFL is a productive 2D library built on HXP. More information about HXP and OpenFL are available at http://www.openfl.org

Feedback

For questions, comments or concerns, please visit the forums at http://community.openfl.org

Using Development Builds

Install Visual Studio Code

Go to https://code.visualstudio.com/download and install

Disable auto-updates

Open Visual Studio Code, then go to "Preferences" > "Settings". This will open a text editor.

In the window, add the following value:

"extensions.autoUpdate": false

This will prevent an auto-update mechanism that will install a release version of vshaxe and hxp-vscode-extension, breaking the development version

Install and build this extension

In the "extensions" directory:

git clone --recursive https://github.com/openfl/hxp-vscode-extension
cd hxp-vscode-extension
npm install

Build the extension

If you do not want to debug the extension, you should build it at least once:

cd hxp-vscode-extension
npm run build -s

Development workflow

Otherwise, you can open the "hxp-vscode-extension" directory using Visual Studio Code. This enables a development workflow, where you can use Ctrl+Shift+B (Cmd+Shift+B on Mac) to recompile the extension.

Hit F5 to begin debugging. This opens a second Visual Studio Code window with the extension enabled. Errors, log output and other data will be reported back to the "Debug Console" in the first window.

Using the extension

Open a folder that contains a HXP project file, and the extension should become active.

The lower-left part of the window should include status bar items for the current build target, configuration (release, debug or final) as well as an option for additional flags or defines.

You can change them by clicking, and selecting a new option in the pop-up. Code completion should be working, but may require a update or build first.

You should be able to use Ctrl+Shift+B (Cmd+Shift+B on Mac) to access the hxp build task. There is also a "Run Test" command you can use, but it has no keyboard shortcut. One option would be to set "Run Test Task" in keyboard shortcuts to Ctrl+Enter (Cmd+Enter) for accessing hxp test quickly.