In order to make use of the Helium Netbeans Plugin, the following software will need to be downloaded:
Java 8
Netbeans 8.2
Installation
The latest version of the plugin can always be found here.
Download the latest version of the plugin
Navigate to the Tools -> Plugins menu item found in Netbeans
Select the Downloaded tab in the window that presents itself
Just below that click the Add Plugins... button and select the plugin file you downloaded
Updating to a Later Version of the Plugin
To install the latest version of the plugin you unfortunately need to first remove the existing plugin before you can install the latest version
Download the latest version of the plugin
Navigate to the Tools -> Plugins menu item found in Netbeans
Select the Installed tab from the presented window
Select the Show Details select box, found just above the list plugins
Search, select and uninstall the Helium DSL plugin
Perform the installation as described earlier
Usage
Opening older projects
If you have a project that has not been created with the plugin the only requirement to make the plugin aware of your project is to add an empty file to the root of the project
helium.json
After adding the file you can go into netbeans and open the project normally
Creating a project
Right click the Project exporer or select File -> New Project from the menu bar
On the popup in the left under Categories select Helium DSL and on the right choose the project type you would like (Only one empty project type is available at the moment)
Complete the popup wizard to name your project and set the location it will be found in
The newly created project will now show in the left hand side with all the standard folders created for you
Adding files
Right click the folder you want to add the files in
Initially select New -> Other from the popup menu (It's initially as Netbeans will prioritize and present you with files you previously selected in future)
Make sure on the left Helium DSL is selected, then on the right select the type of file you want
In the file wizard select the type of file you would like, name the file and Netbeans will create the file for you
Parsing / Validation
The plugin gets built with the latest changes of Helium which means the plugin will validate any input against the latest version of the Helium platform
Autocompletion
To initiate autocompletion (depending on your platform) use the Ctrl + Space key combination
Limitations
Due to netbeans' XML autocompletion ability, when editing your view files autocompletion will stop working at an arbitrary depth of elements. This is a known issue with Netbeans and in future we will try and get around this by adding more template types to generate the correct view XML for you. Also more initial project types with included views might alleviate this issue.
Autocompletion within the .mez space is a work in progress. This can and will be fine tuned in the future to make it more intelligent.
Add Comment