Создание пакетов начального загрузчикаCreate bootstrapper packages

Программа установки — это общий установщик, который можно настроить на обнаружение и установку распространяемых компонентов, таких как файлы установщика Windows ( .MSI) и исполняемые программы.The Setup program is a generic installer that can be configured to detect and install redistributable components such as Windows Installer (.msi) files and executable programs. Установщик также называется начальным загрузчиком.The installer is also known as a bootstrapper. Он программируется с помощью набора XML манифестов, определяющих метаданные для управления установкой компонента.It is programmed through a set of XML manifests that specify the metadata to manage the installation of the component. Каждый распространяемый компонент или предварительные требования, которые отображаются в диалоговом окне необходимые компоненты для технологии ClickOnce, являются пакетом загрузчика.Each redistributable component, or prerequisite, that appears in the Prerequisites dialog box for ClickOnce is a bootstrapper package. Пакет начальной загрузки — это группа директорий и файлов, в которых содержатся файлы манифеста, описывающие порядок установки необходимого компонента.A bootstrapper package is a group of directories and files that contain manifest files that describe how the prerequisite should be installed.

Сначала начальный загрузчик проверяет, установлены ли необходимые компоненты.The bootstrapper first detects whether any of the prerequisites are already installed. Если нет, то начальный загрузчик показывает лицензионные соглашения.If prerequisites are not installed, first the bootstrapper shows the license agreements. Как только конечный пользователь примет условия лицензионного соглашения, начнется установка необходимых компонентов.Second, after the end user accepts the license agreements, the installation begins for the prerequisites. Если все необходимые компоненты обнаружены, начальный загрузчик просто запустит установщик приложения.Otherwise, if all the prerequisites are detected, the bootstrapper just starts the application installer.

Создание настраиваемых пакетов начального загрузчикаCreate custom bootstrapper packages

Манифесты загрузчика можно создавать с помощью редактора XML в Visual Studio.You can generate the bootstrapper manifests by using the XML Editor in Visual Studio. Пример создания пакета начального загрузчика см. в разделе пошаговое руководство. Создайте пользовательский загрузчик с запросомо конфиденциальности.To see an example of creating a bootstrapper package, see Walkthrough: Create a custom bootstrapper with a privacy prompt.

Чтобы создать пакет начального загрузчика, необходимо создать манифест продукта и для каждой локализованной версии компонента также манифеста пакета.To create a bootstrapper package, you have to create a product manifest and, for each localized version of a component, a package manifest as well.

  • Манифест продукта Product. XMLсодержит любые независимые от языка метаданные для пакета.The product manifest, product.xml, contains any language-neutral metadata for the package. Здесь находятся общие метаданные для всех локализованных версий распространяемого компонента.This contains metadata common to all the localized versions of the redistributable component. Чтобы создать этот файл, см . раздел как Создайте манифестпродукта.To create this file, see How to: Create a Product Manifest.

  • Манифест пакета Package. XMLсодержит метаданные для конкретного языка; Обычно они содержат локализованные сообщения об ошибках.The package manifest, package.xml, contains language-specific metadata; it typically contains localized error messages. Компонент должен содержать хотя бы один манифест пакета для каждой локализованной версии.A component must have at least one package manifest for each localized version of that component. Чтобы создать этот файл, см . раздел как Создайте манифестпакета.To create this file, see How to: Create a Package Manifest.

После создания этих файлов необходимо сохранить манифест продукта в папку с именем стандартного начального загрузчика.After these files are created, put the product manifest file into a folder named for the custom bootstrapper. Файл манифеста пакета следует переместить в папку с именем языкового стандарта.The package manifest file goes into a folder named for the locale. Например, если манифест пакета создан для распространения на английском языке, то файл необходимо положить в папку с названием "en".For example, if the package manifest file is for English redistribution, put the file into a folder called en. Повторите эту процедуру для каждого языкового стандарта, например "ja" для японского языка и "de" для немецкого.Repeat this process for each locale, such as ja for Japanese and de for German. Окончательный пользовательский пакет начального загрузчика может иметь следующую структуру папок.The final custom bootstrapper package could have the following folder structure.

CustomBootstrapperPackage
  product.xml
  CustomBootstrapper.msi
  de
    eula.rtf
    package.xml
  en
    eula.rtf
    package.xml
  ja
    eula.rtf
    package.xml

Затем скопируйте распространяемые файлы в расположение папки начального загрузчика.Next, copy the redistributable files into the bootstrapper folder location. Дополнительные сведения см. в разделе Практическое руководство. создать пакет локализованного начального загрузчика.For more information, see How to: Create a localized bootstrapper package.

*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper*

или для более ранних версий Visual Studioor, for older versions of Visual Studio

*\Program Files\Microsoft Visual Studio 14.0\SDK\Bootstrapper\Packages*

или диспетчер конфигурации службor

*\Program Files (x86)\Microsoft Visual Studio 14.0\SDK\Bootstrapper\Packages*

Расположение папки начального загрузчика также можно найти по значению path в следующем разделе реестра:You can also find the bootstrapper folder location from the Path value in the following registry key:

*HKLM\Software\Microsoft\GenericBootstrapper*

Для 64-разрядных операционных систем необходимо использовать следующий раздел реестра:On 64-bit systems, use the following registry key:

*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*

Каждый распространяемый компонент создается в своей подпапке в каталоге пакетов.Each redistributable component appears in its own subfolder under the packages directory. Манифест продукта и распространяемые файлы должны быть размещены в этой подпапке.The product manifest and redistributable files must be put into this subfolder. Локализованные версии манифестов компонентов и пакетов должны быть размещены во вложенных папках в соответствии с именем языка и региональных параметров.Localized versions of the component and package manifests must be put in subfolders named according to Culture Name.

После того как файлы будут скопированы в папку начального загрузчика, пакет начального загрузчика автоматически появится в диалоговом окне необходимых компонентов Visual Studio.After these files are copied into the bootstrapper folder, the bootstrapper package automatically appears in the Visual Studio Prerequisites dialog box. Если пользовательский пакет начального загрузчика не появился, закройте и снова откройте диалоговое окно необходимых компонентов.If your custom bootstrapper package does not appear, close and then reopen the Prerequisites dialog box. Дополнительные сведения см. в разделе Диалоговое окно "Необходимые компоненты".For more information, see Prerequisites dialog box.

В следующей таблице перечислены свойства, которые заполняются начальным загрузчиком автоматически.The following table shows the properties that are automatically populated by the bootstrapper.

Свойство.Property ОписаниеDescription
ApplicationNameApplicationName Имя приложения.The name of the application.
ProcessorArchitectureProcessorArchitecture Процессор и количество бит на слово в платформе, для которой предназначен исполняемый файл.The processor and bits-per-word of the platform targeted by an executable. В эти значения входят:Values include the following:

— Intel- Intel
— IA64- IA64
— AMD64- AMD64
Version9xVersion9x Номер версии для операционных систем Microsoft Windows 95, Windows 98 и Windows ME.The version number for Microsoft Windows 95, Windows 98, or Windows ME operating systems. Синтаксис версии — Major.Minor.ServicePack.The syntax of the version is Major.Minor.ServicePack.
VersionNTVersionNT Номер версии для операционных систем Windows NT, Windows 2000, Windows XP, Windows Vista, Windows Server 2008 и Windows 7.The version number for the Windows NT, Windows 2000, Windows XP, Windows Vista, Windows Server 2008, or Windows 7 operating systems. Синтаксис версии — Major.Minor.ServicePack.The syntax of the version is Major.Minor.ServicePack.
VersionMSIVersionMSI Версия сборки установщик Windows (MSI. dll), которая должна быть запущена во время установки.The version of the Windows Installer assembly (msi.dll) to run during the installation.
AdminUserAdminUser Данное свойство устанавливается, если пользователь имеет права администратора.This property is set if the user has administrator privileges. Значения — true или false.Values are true or false.
InstallModeInstallMode Режим установки показывает, откуда должен быть установлен компонент.The installation mode indicates where the component needs to be installed from. В эти значения входят:Values include the following:

— HomeSite: необходимые компоненты должны устанавливаться с веб-сайта поставщика.- HomeSite - prerequisites are installed from the vendor's Web site.
— SpecificSite: необходимые компоненты должны устанавливаться из выбранного расположения.- SpecificSite - prerequisites are installed from the location that you select.
— SameSite: необходимые компоненты должны устанавливаться из расположения приложения.- SameSite - prerequisites are installed from the same location as the application.

Отдельные распространяемые пакеты из установок приложенийSeparate redistributables from application installations

Размещение распространяемых файлов в проектах установки можно предотвратить.You can prevent your redistributable files from being deployed in Setup projects. Для этого необходимо создать список распространяемых компонентов в папке RedistList каталога .NET Framework:To do this, create a redistributable list in the RedistList folder in your .NET Framework directory:

%ProgramFiles%\Microsoft.NET\RedistList

Список распространяемых компонентов — это XML файл, которому необходимо присвоить имя в следующем формате. Название компании >.< < Имя компонента >. RedistList. XML.The redistributable list is an XML file that you should name using the following format: <Company Name>.<Component Name>.RedistList.xml. Например, если компонент называется DataWidgets и разработан компанией Acme, файл необходимо назвать Acme.DataWidgets.RedistList.xml.So, for example, if the component is called DataWidgets made by Acme, use Acme.DataWidgets.RedistList.xml. Пример содержания списка распространяемых компонентов:An example of the redistributable list's contents might resemble this:

<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>

См. такжеSee also