The MachBuilder Extension for ColdFusion Builder
MachBuilder is an extension for ColdFusion Builder 2 or later. The extension ships with ColdFusion Builder 2 and can be found in the "extensions" folder inside in the ColdFusion Builder 2 install directory. You can also get it as part of the core Mach-II 1.9 download.
It resides in the tooling directory.
MachBuilder currently has two major features:
This option is available to you when you right-click on a project folder or a folder within a project. Selecting this option brings up a simple form that provides you some configuration options for a new Mach-II app skeleton. This includes:
- Specify the application name
- Specify the event parameter name
- Enable the ColdSpring property
- Enable SES URL writing in the Mach-II app
- Enable the on-screen Mach-II logger
- Provide the password for the Mach-II Dashboard
- Specify a custom webroot path if you don't want to use the default
Note that the Mach-II Dashboard is included by default in any skeleton generated by MachBuilder, as the Dashboard is part of the core Mach-II 1.9 framework. If you don't want to include the Dashboard, you can delete the related lines from the mach-ii.xml configuration file.
All of the files end up in the folder which you right-clicked on to fire off the extension. You'll want to make sure that you're running the extension in the correct folder. If you want the Mach-II application skeleton files to be put into your webroot, then right-click on your webroot folder. If you want the application to live inside a folder in your webroot, right-click on that specific folder.
This options is only available when you click on files in a project. Selecting this menu option will launch the Mach-II Dashboard for the currently selected server in a view inside of ColdFusion Builder. That view stays open, like all ColdFusion Builder extensions that create views, until you either close it or quit out of ColdFusion Builder.
MachBuilder has an auto-update mechanism that will notify you when a new version is available. You can opt to update the MachBuilder extension from directly within ColdFusion Builder when prompted.