Make an EZ-Builder Behavior Control

7. Test Plugin

As you may recall from the beginning of this tutorial, your code is generating a DLL file and not an EXE executable. This means that testing your program can only by done within the EZ-Builder application. We've made this very easy and these instructions will direct you how to do it.

1) Right click on the project and select Properties.
User-inserted image

2) Select the BUILD tab and configure the Platform Target for x86.
User-inserted image

3) Scroll down through the BUILD tab options and locate the Output Path setting.
User-inserted image

4) This is where you will configure the output files to be copied when the project is compiled. Press the BROWSE button. The output path for your project will be located in the EZ-Builder Plugins folder in a folder created with the name of the GUID of your plugin. The plugin GUID can be found in the Plugin.XML file.

EZ-Builder Plugins must be located in the following folder, or where your Public Documents are stored:


The (GUID) is replaced with your Plugin's application GUID from the Plugin.XML file. For example, your output folder path would look like this:


User-inserted image

*Note: Your public documents folder may be in a different location than this example. The best way to tell where the public documents folder is on your computer is to locate it using the file explorer by typing %PUBLIC% in the address bar. Select Public Documents within that folder that opens. If the public documents folder does not list an EZ-Builder folder, that means you have not loaded EZ-Builder at least once. The folders will be automatically created when you load EZ-Builder the first time. Load EZ-Builder and see that the folders will be created in the %PUBLIC% documents folder.

5) Navigate to the DEBUG tab in the properties window.

User-inserted image

6) Select the Start Action to be set for an External Program. The program which we will specify is the EZ-Builder installed on your PC. The file will be C:\Program Files (x86)\Synthiam Inc\EZ-Builder\EZ-Builder.exe

User-inserted image

7) Compile and debug your project by pressing F5. This will compile the project if there are no errors, and EZ-Builder will be launched. This allows debugging of the plugin to occur while EZ-Builder is running. How cool is that?:)

User-inserted image

8) To stop debugging, there are a few methods. Either close EZ-Builder or press SHIFT-F5 from the Visual Studio window. Pressing SHIFT-F5 from the Visual Studio window will terminate EZ-Builder and therefore no saving prompts, etc will be presented.

9) To access your plugin from EZBuilder during DEBUG, press PROJECT->ADD CONTROL to open the list of controls which you can add to the project. Navigate to the BETA tab and your plugin should be listed.
User-inserted image

10) Select your plugin and it will be added to the EZ-Builder Workspace.
User-inserted image

11) Connect to your EZ-B and press the buttons on your new plugin. The servo connected to port D0 will move! Voila:)

Congratulations on creating your first plugin! There are many more advanced features which you will learn by examining other open-source plugins. In the next step, there will be additional information for publishing plugins and where to get more advanced source-code examples.

Additional Compiling Information
This screenshot demonstrates that the DLL and Plugin.XML file have been copied to the EZ-Builder plugin folder after compiling. When the compiling and debugging is selected with pressing F5 in Visual Studio, all required files must be copied by Visual Studio to the output folder. The output folder, of course is the GUID named folder in the Public Documents. The required files are the plugin DLL, Plugin.XML and all dependencies. If your plugin has an icon, that file is Title.JPG or Title.PNG and should also be copied to the output folder. If your files are not copied, this means a step has been missed during this tutorial. Simply retrace the tutorial steps and everything will come together.

User-inserted image

Error: the referenced component" EZ_builder,EZ_B" could not be found, DJ Sure i hope you can help me !
#16   — Edited
User-inserted image
Joinny, you have to add the referencing by following the instructions in this tutorial. They are outlined with step by step to easily follow. Click add references, and browse to the appropriate files as directed in the tutorial. I can’t write anything clearer in response. The step to add references is incredibly clear but you’re skipping it.
The error cannot read the COM file, I downloaded it and when I follow the instructions, I get an error, while other files read normally.
.User-inserted image
#18   — Edited
sorry for me but i tried many different ways but still show the error,I couldn't find EZ_B.dll file even though I downloaded it
None of the required references are in your list. Please follow the tutorial. It explains exactly how to click the browse button and navigate to the folder and select the files.
Sorry, but the reason I can't reference is because there is no file in the EZ_B folder and there is an error : this folder is empty , I am trying to solve it. I would like to thank DJ sure for answering my superfluous questions and I'm sorry for bothering you