| Build the File Type Plug-in |
This chapter contains important information on building your file type plug-in and on the plug-in package file, which is created during the building process.
Building the project will generate a *.sdlplugin file, in our example Sdl.Sdk.FileTypeSupport.Samples.SimpleText.sdlplugin, which will be placed inside your build output path. The *.sdlplugin file is technically speaking a ZIP archive that contains the required plug-in components such as the plug-in binary (*.dll itself), the resources file, the manifest etc. For our example, the *.sdlplugin file will contain the following:
In order for SDL Trados Studio 2014 to pick up the plug-in package and to extract it, the following folders need to be available on your hard drive:
For Windows XP:
C:\Documents and Settings\[UserName]\Application Data\SDL\SDL Trados Studio\11\Plugins\Packages
and
C:\Documents and Settings\[UserName]\Application Data\SDL\SDL Trados Studio\11\Plugins\Unpacked
For Windows Vista\Windows 7\Windows 8:
C:\Users\[UserName]\AppData\Roaming\SDL\SDL Trados Studio\11\Plugins\Packages
and
C:\Users\[UserName]\AppData\Roaming\SDL\SDL Trados Studio\11\Plugins\Unpacked
Make sure that you place the *.sdlplugin file into the sub-folder Packages and launch SDL Trados Studio 2014. During startup of SDL Trados Studio 2014 the content of the package will be automatically extracted to the Unpacked sub-folder, as illustrated below:
The above folder does not have to be the build output path, but it is convenient to build the project in this folder, as this will also create the *.sdlplugin file where it needs to be. After creating the plug-in based on the (empty) template, you could already build the project. However, it will, of course, not offer any functionality.
Upon start-up SDL Trados Studio 2014 will load the unpacked plug-in and show the following message, which you can confirm with Yes, so that the plug-in gets loaded. This message appears when loading plug-ins that have not been certified by SDL, which could potentially be unsafe. The message can be avoided by submitting your plug-in to SDL for certification.

If a user clicks No when the plug-in security message is displayed during start-up of SDL Trados Studio 2014, the plug-in will not be shown in the application. |
After loading the plug-in in SDL Trados Studio 2014, you can confirm that the plug-in has been added by raising the corresponding dialog box through the menu command Tools -> Plug-ins. The Plug-ins dialog box should list the name of your newly created plug-in:

One essential piece of information required in order to build the plug-in package this is the plug-in package manifest, which is defined in the file pluginpackage.manifest.xml. This file is part of the project template. If this manifest is missing, the project package cannot be built.
Below you see what the manifest of our sample plug-in looks like:
<?xml version="1.0" encoding="utf-8"?> <PluginPackage xmlns="http://www.sdl.com/Plugins/PluginPackage/1.0"> <PlugInName>Sdl.Sdk.FileTypeSupport.Samples.SimpleText</PlugInName> <Version>1.0</Version> <Description>Sdl.Sdk.FileTypeSupport.Samples.SimpleText</Description> <Author></Author> <RequiredProduct name="SDLTradosStudio" minversion="9.1" /> </PluginPackage>
Here are a couple of simple suggestions to help buld and debug your plug-in.
rmdir /S /Q "C:\Users\<UserName>\AppData\Roaming\SDL\SDL Trados Studio\10\Plugins\Unpacked\Sdl.Sdk.FileTypeSupport.Samples.Bil"