Changes between Version 13 and Version 14 of Documentation/DevelopmentCenter/DownloadAndBuildSource


Ignore:
Timestamp:
06/26/14 17:45:40 (5 years ago)
Author:
abeham
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/DevelopmentCenter/DownloadAndBuildSource

    v13 v14  
    8080 * For the project add a reference to `HeuristicLab.PluginInfrastructure.dll` in StableRoot\bin
    8181 * Open the properties of the reference and set "Copy Local" to false
     82
     83Later on in your developments you will have to add additional plugins as references, but the procedure is always the same.
     84
    8285 * Rename `Class1.cs` to `Plugin.cs` by selecting it and pressing <F2>
    8386 * Replace the code in the file with the following code snippet
     
    97100'''Important''': The plugin class needs to derive from HeuristicLab.PluginInfrastructure.PluginBase so that the dll is realized as a plugin. The attributes specify the details of the plugin and which files it provides. The filename given in PluginFile has to be the same as the assembly output filename in the "Application" tab of the project's properties.
    98101
    99 '''Important''': Version numbers for plugins can be specified in the style major.minor.build.revision. Changing major or minor version numbers in the course of development marks a breaking change to files. If HeuristicLab's persistence comes across an item saved with a plugin version of 3.3.8 it will accept a new plugin of 3.3.9 to open it, but not when the new plugin version is 3.4.0 or 4.0. For this reason HeuristicLab plugin assemblies are always marked with major and minor number at the end, e.g. HeuristicLab.Core-3.3.dll. This allows to have the same assembly in two conflicting versions.
     102'''Important''': Version numbers for plugins can be specified in the style major.minor.build.revision. In the official HeuristicLab repository the revision part is synchronized with the SVN revision number, it can be simply set to 0 in our case. Changing major or minor version numbers in the course of development marks a breaking change to previously saved files. If HeuristicLab's persistence comes across an item of a plugin with version 3.3.8 it will accept the same plugin in version 3.3.9 to open it. However, it will reject the plugin when its major.minor is different (e.g. 3.2.7, 3.4.3 or 4.0.1). For this reason HeuristicLab plugin assemblies are always marked with major and minor numbers at the end, e.g. HeuristicLab.Core-3.3.dll. This allows to have the same assembly in two conflicting versions.
     103
     104 * Build the project and press <Ctrl+F5> to start it without a debugger attached
     105 * You will see the starter window again, but you already know the switches to hide it
     106 * Inside the starter open the "Plugin Manager" and see that it is correctly loaded
     107
     108Now we have created an empty plugin that we can use to implement our great idea. Please refer to the [[Documentation]] pages and the various HowTos on how to write views, operators, algorithms, etc.
    100109
    101110=== New plugin with SharpDevelop ===