How to: Localize the Add-In Package

  • Article

 

Applies To: Windows Server 2012 Essentials, Windows Home Server 2011, Windows Storage Server 2008 R2 Essentials, Windows Small Business Server 2011 Essentials

The following options are available for providing localized files in your add-in package:

  • Provide a separate add-in package for each language you want to support.

  • Provide a single add-in package that contains language-neutral installation packages. The Windows Installer packages install resource .dll files for the supported languages.

  • Provide a single add-in package that contains a Windows Installer package for each supported language. If you use this method, you must change the AddIn.xml file to indicate the name of the package that supports a specified language.

Note

You should provide localized Microsoft Software License Terms for a localized add-in package. For more information about including localized Microsoft Software License Terms in the add-package, see How to: Create the Add-In Package.

Also notice that whereas you can install the add-in into any folder, the language resources must be put in the following folder: %ProgramFiles%\Windows Server\Bin\{language}.

To create the metadata file for an add-in package that provides Windows Installer packages for a specified language

  1. Open Visual Studio 2010 as an administrator by right-clicking the program in the Start menu and selecting Run as administrator.

  2. Open the project for your add-in, and then open the metadata file that you created in How to: Create the Metadata File for the Add-In.

  3. Change the File element to provide the localization information. The following code example shows how to define German binary files for the add-ins that are installed on the server.

    <?xml version="1.0" encoding="utf-8"?>  
<Package xmlns="https://schemas.microsoft.com/WindowsServerSolutions/2010/03/Addins" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
   <Id>969033D5-6895-4EA8-AF0F-623D337BD606</Id>  
   <Version>1.0.0.0</Version>  
   <Name>Litware Add-in</Name>  
   <Allow32BitOn64BitClients>false</Allow32BitOn64BitClients>  
   <ServerBinary>  
      <File>  
         <ProductCode>27848FEA-00E0-454E-A48E-419B1555FD20</ProductCode>  
         <Version>1.0</Version>  
         <Name>LitwareServer.msi</Name>  
         <Filter>  
            <Language>en-US</Language>  
            <IsLanguageFallback>true</IsLanguageFallback>  
         </Filter>  
      </File>  
      <File>  
         <ProductCode>27848FEA-00E0-454E-A48E-419B1555FD20</ProductCode>  
         <Version>1.0</Version>  
         <Name>LitwareServer_de-DE.msi</Name>  
         <Filter>  
            <Language>de-DE</Language>  
            <IsLanguageFallback>false</IsLanguageFallback>  
         </Filter>  
      </File>  
   </ServerBinary>  
   <ClientBinary32>  
      <File>  
         <ProductCode>856EBFA3-6503-4158-9A96-E0BA3D4F35E7</ProductCode>  
         <Version>1.0.0.0</Version>  
         <Name>LitwareClient.msi</Name>  
         <Filter>  
            <MinOSVersion>6.0</MinOSVersion>  
            <OSEdition>MediaCenter</OSEdition>  
            <Language>en-US</Language>  
            <IsLanguageFallback>true</IsLanguageFallback>  
         </Filter>  
      </File>  
   </ClientBinary32>  
   <ClientBinary64>  
      <File>  
         <ProductCode>856EBFA3-6503-4158-9A96-E0BA3D4F35E7</ProductCode>  
         <Version>1.0.0.0</Version>  
         <Name>LitwareClient_x64.msi</Name>  
         <Filter>  
            <MinOSVersion>6.0</MinOSVersion>  
            <OSEdition>MediaCenter</OSEdition>  
            <Language>en-US</Language>  
            <IsLanguageFallback>true</IsLanguageFallback>  
         </Filter>  
      </File>  
   </ClientBinary64>  
   <SupportUrl>http://www.litwareinc.com/</SupportUrl>  
   <PrivacyStatement>http://www.litwareinc.com/</PrivacyStatement>  
   <OtherBinaries>  
      <Item>  
         <Target>Mac</Target>  
         <FileName>LitwareMac.dmg</FileName>  
      </Item>  
   </OtherBinaries>  
</Package>