Skip to content

how-to-create-a-localized-bootstrapper-package.md

Latest commit

 

History

History
93 lines (63 loc) · 4.43 KB

how-to-create-a-localized-bootstrapper-package.md

File metadata and controls

93 lines (63 loc) · 4.43 KB
title Create a Localized Bootstrapper Package
description Learn how to create localized versions of the bootstrapper package in ClickOnce by creating two more files for each locale.
ms.date 01/12/2024
ms.topic how-to
helpviewer_keywords
localized bootstrapper packages
dependencies, creating localized bootstrapper packages
prerequisites, creating localized bootstrapper packages
author mikejo5000
ms.author mikejo
ms.subservice deployment

Create a localized bootstrapper package

After you create a bootstrapper package, you can create localized versions of the bootstrapper package by creating two more files for each locale: a software license terms file (such as a eula.rtf) and a package manifest (package.xml).

By default, Visual Studio includes localized bootstrapper packages only for a few specific version of .NET Framework. You can create localized packages for other bootstrappers by completing three steps.

  1. Create a folder that is named after the locale name in \Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages\<BootstrapperPackageName>.

  2. Create a file that contains the software license terms for the bootstrapper package and put it in the new folder.

  3. Create a package manifest named package.xml, update the strings and culture, and put the file in the new folder. If you have already created a bootstrapper of Visual Studio in the target language, you can copy the Visual Studio package.xml file and modify it in this step.

Note

If you are using a Setup project to deploy applications, you can localize your application by changing the Localization property.

[!INCLUDEnote_settings_general]

To create a localized bootstrapper package

  1. Create a folder that is named after the locale name.

    On 32-bit computers, create the folder in the \Program Files\Microsoft SDKs\ClickOnce Bootstrapper\Packages\<BootstrapperPackageName>\ folder.

    On 64-bit computers, create the folder in the \Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages\<BootstrapperPackageName>\ folder.

    The following table shows the folder names that you can use to match a locale.

    Locale Folder name
    Chinese (Simplified) zh-Hans
    Chinese (Traditional) zh-Hant
    Czech cs
    German de
    English en
    Spanish es
    French fr
    Italian it
    Korean ko
    Japanese ja
    Polish pl
    Portuguese (Brazil) pt-BR
    Russian ru
    Turkish tr

  2. Create a file that contains the software license terms for the bootstrapper package and put it in the new folder.

  3. Create a package manifest named package.xml and put it in the new folder. For more information, see How to: Create a package manifest.

  4. Update the <Strings> section of the package manifest so that the strings are in the correct language for the locale.

  5. Change the <String Name="Culture"> value to match the folder name.

  6. Save the package.xml file.

To create a bootstrapper package for .NET Framework 3.5 Service Pack 1 localized in French

  1. Create a folder that is named fr. The folder name must match the locale name.

    On 32-bit computers, create the folder in the \Program Files\Microsoft SDKs\ClickOnce Bootstrapper\Packages\DotNetFX35SP1\ folder.

    On 64-bit computers, create the folder in the \Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages\DotNetFX35SP1\ folder.

  2. Put a localized version of the software license terms into the fr folder.

  3. Copy the \Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages\DotNetFX35SP1\en\package.xml file to the fr folder, and open the file in the XML Designer.

  4. Update the <Strings> section of the package manifest so that the error strings are in French.

  5. Change the <String Name="Culture"> value to fr.

  6. Save the package.xml file.

Note

Starting with the Visual Studio 2019 Update 7 release bootstrapper packages will also be discovered under the path {VS Install Path}\MSBuild\Microsoft\VisualStudio\BootstrapperPackages.

Related content