Make an EZ-Builder Behavior Control

6. Register Plugin

In order to test your plugin with EZ-Builder, you need to register it with the synthiam.com website. This is a free and easy process to obtain a unique application key.

1) Visit the Synthiam.com website.

2) Login to the website if you are currently not logged in - or create an account.

3) Press the Create Behavior Control button as highlighted in the screenshot below.
User-inserted image


4) A blank plugin will be auto-generated for you to complete. Because we are in the testing phase and not publishing this plugin to the world, you only need to enter the title and short description (min 40 characters) of the plugin. We will leave the other fields blank for now.

5) Save the plugin.
User-inserted image


6) Your plugin will require a Plugin.XML file, which contains necessary information for EZ-Builder to understand what to do with it. The Plugin.XML file is auto-generated by the website. Click on the Download XML link to save the file to your hard drive.
User-inserted image


7) Locate the saved plugin.xml file and COPY and PASTE it into your Visual Studio Project in the Solution Explorer.
User-inserted image


8) Now we will configure the Plugin.XML file to be automatically copied to your Output folder when the plugin is compiled. Select the Plugin.XML file in the Solution Explorer and change the value of Copy To Output Directory to Copy Always. This will tell the visual studio compiler to copy the plugin.xml file to your output folder when compiling/building the plugin project.
User-inserted image


9) Double click on the Plugin.XML file in the Solution Explorer to edit it. The contents of the file will be displayed in the Visual Studio Editing window. Review the configuration values of the Plugin.XML file. You will notice there is a Category field, which must match one of the EZ-Builder Add Control categories. For now, we will leave it configured as Beta. You will also notice the plugin GUID, that is the unique identifier for your plugin. The unique identifier cannot be edited or changed, as it links to the synthiam.com website plugin definition.
User-inserted image


10) We now need to tell the Plugin.XML file what the filename of your plugin DLL is. The DLL file is generated when you build the project. Because we have successfully built the project in the previous step, it will be in the build folder. Remember, CTRL-SHIFT-B will build the project and generate the DLL.

To locate the compiled filename of your DLL, navigate to the BIN\DEBUG folder where you have created the project. Copy the filename to your clipboard to be pasted in the Plugin.XML file in Visual Studio.
User-inserted image


11) Paste the filename into the Plugin.XML file and ensure it is a valid XML field. Reference the screenshot below if you are not familiar with XML.
User-inserted image


12) Save the Plugin.XML file now that it has the DLL Filename entered.

Now that the Plugin.XML has been created for your plugin, it can be tested in EZ-Builder. The next step will demonstrate how the plugin can be tested in EZ-Builder on your local computer.

United Kingdom
#5  
Trying to follow the tutorials but can't find where the plugin page has gone. How do I add a new plugin to the ez-robot / Synthiam site to get the XML?
United Kingdom
#6  
Never mind. Just found the "Create Behaviour Control" link:)
#7  
I am trying to follow the instructions for adding my own plugin but I cannot seem to find the place to register the plugin based on the instructions.

Any help is appreciated.

Thanks
Synthiam
#8   — Edited
The new button to create a plugin behavior control is less than an inch below the button you pressed to create this question. :)

User-inserted image
#9  
Thanks for the quick response.

This what happens when you are working on robotics when its way past your bed time.

You miss the obvious