...
- Choose Online to view a complete list of plugins available from the store; and
- Click Install.
Specifying plugins when running RiverSystem.Forms.exe
It is possible to overwrite the standard plugin loading functionality when starting RiverSystem.Forms.exe. In order to do this you call RiverSystem.Forms.exe from the command line (note: this is NOT the command line runner) and use the following switches to specify plugins
| Switch | Usage | Example | Notes |
|---|---|---|---|
| /p | /p project_name | /p C:\SourceProjects\MyProject\myProject.rsproj | does not need to be an absolute path |
| /nopluginfile | /nopluginfile | /nopluginfile | disables loading and saving of plugin configs |
| /plugin | /plugin plugin_path | /plugin C:\SourceProjects\MyProject\FirstPlugin.dll | must use an absolute path, or will only use the name and do a normal lookup |
The easiest ways to do this is to specify a shortcut, or use a batch file. For example a batch file might have
| Code Block |
|---|
C:\SourceVersions\5.0.3\RiverSystem.Forms.exe /project C:\SourceProjects\MyProject\myProject.rsproj /nopluginfile /plugin C:\SourceProjects\MyProject\FirstPlugin.dll /plugin C:\SourceProjects\MyProject\SourcePlugin.AllocationAndUtilities.dll /plugin FamrDamPlugin.dll |
This says;
use C:\SourceVersions\5.0.3\RiverSystem.Forms.exe to load only the following plugins
- C:\SourceProjects\MyProject\FirstPlugin.dll - this is a custom plugin
- C:\SourceProjects\MyProject\SourcePlugin.AllocationAndUtilities.dll - as this is an absolute path it will use the specified version of the file at C:\SourceProjects\MyProject\SourcePlugin.AllocationAndUtilities.dll rather than C:\SourceVersions\5.0.3\CommunityPlugins\SourcePlugin.AllocationAndUtilities.dll
- FarmDamPlugin.dll - this will do a normal lookup in CommunityPlugins and use C:\SourceVersions\5.0.3\CommunityPlugins\FarmDamPlugin.dll
then load the project C:\SourceProjects\MyProject\myProject.rsproj
Note that if a plugin cannot be found, or a non absolute path is used, source will preferentially use the name specified as a lookup in CommunityPlugins. This is to maintain backwards compatibility with existing functionality.
Note also that this will not have an effect on the plugins used in RiverSystem,CommandLine.exe
Uninstalling plugins from a source project
...
Figure 4. Unblocking external plugins
Specifying Plugins for RiverSystem.Forms.exe from the Command Line