Элемент <PackageFiles> (загрузчик)

Статья
08/11/2011

Элемент PackageFiles содержит элементы PackageFile, которые определяют установочные пакеты, выполняемые в результате использования элемента Command.

<PackageFiles
    CopyAllPackageFiles
>
    <PackageFile 
        Name
        HomeSite
        CopyOnBuild
        PublicKey
        Hash
    />
</PackageFiles>

Элементы и атрибуты

Элемент PackageFiles имеет следующий атрибут.

Атрибут	Описание
CopyAllPackageFiles	Необязательный. При значении false установщик будет загружать только те файлы, на которые есть ссылка в элементе Command. При значении true будут загружены все файлы. При значении IfNotHomesite установщик будет работать так же, как при значении False, если для ComponentsLocation задано значение HomeSite; в противном случае программа установки будет работать так же, как при значении True. Это значение полезно при необходимости разрешить пакетам, которые сами являются загрузчиками, выполнить свою задачу в сценарии HomeSite. Значение по умолчанию — true.

CopyAllPackageFiles

Необязательный. При значении false установщик будет загружать только те файлы, на которые есть ссылка в элементе Command. При значении true будут загружены все файлы.

При значении IfNotHomesite установщик будет работать так же, как при значении False, если для ComponentsLocation задано значение HomeSite; в противном случае программа установки будет работать так же, как при значении True. Это значение полезно при необходимости разрешить пакетам, которые сами являются загрузчиками, выполнить свою задачу в сценарии HomeSite.

Значение по умолчанию — true.

PackageFile

Элемент PackageFile является дочерним для элемента PackageFiles. Элемент PackageFiles должен иметь по крайней мере один элемент PackageFile.

PackageFile имеет следующие атрибуты.

Атрибут	Описание
Name	Обязательный. Имя файла пакета. На это имя элемент Command будет ссылаться при определении условий для установки пакета. Это значение также используется как ключ в таблице Strings для извлечения локализованного имени, используемого такими инструментами, как Visual Studio, для описания пакета.
HomeSite	Необязательный. Расположение пакета на удаленном сервере, если оно не включено в установщик.
CopyOnBuild	Необязательный. Указывает загрузчику на необходимость копирования файла пакета на диск при построении. Значение по умолчанию — true.
PublicKey	Зашифрованный открытый ключ заверителя сертификата пакета. Обязателен при использовании HomeSite; в противном случае необязателен.
Hash	Необязательный. Хэш SHA1 для файла пакета. Используется для проверки целостности файла во время установки. Если идентичный хэш не удается вычислить из файла пакета, пакет не будет установлен.

Пример

Следующий пример кода определяет пакеты для распространяемого пакета .NET Framework и его зависимостей, таких как установщик Windows.

    <PackageFiles>
        <PackageFile Name="instmsia.exe" HomeSite="InstMsiAExe" PublicKey="3082010A0282010100AA99BD39A81827F42B3D0B4C3F7C772EA7CBB5D18C0DC23A74D793B5E0A04B3F595ECE454F9A7929F149CC1A47EE55C2083E1220F855F2EE5FD3E0CA96BC30DEFE58C82732D08554E8F09110BBF32BBE19E5039B0B861DF3B0398CB8FD0B1D3C7326AC572BCA29A215908215E277A34052038B9DC270BA1FE934F6F335924E5583F8DA30B620DE5706B55A4206DE59CBF2DFA6BD154771192523D2CB6F9B1979DF6A5BF176057929FCC356CA8F440885558ACBC80F464B55CB8C96774A87E8A94106C7FF0DE968576372C36957B443CF323A30DC1BE9D543262A79FE95DB226724C92FD034E3E6FB514986B83CD0255FD6EC9E036187A96840C7F8E203E6CF050203010001"/>
        <PackageFile Name="WindowsInstaller-KB884016-v2-x86.exe" HomeSite="Msi30Exe" PublicKey="3082010A0282010100B22D8709B55CDF5599EB5262E7D3F4E34571A932BF94F20EE90DADFE9DC7046A584E9CA4D1D84441FB647E0F65EEC817DA4DDBD9D650B40C565B6C16884BBF03EE504883EC4F88939A51E394197FFAB397A5CE606D9FDD4C9338BDCD345971E686CEE98399A096B8EAE0445B1342B93A484E5472F70896E400C482017643AF61C2DBFAE5C5F00213DDF835B40F0D5236467443B1A2CA9CDD7E99F1351177FB1526018ECFE0B804782A15FD72C66076910CE74FB218181B6989B4F12F211B66EACA91C7460DB91758715856866523D10232AE64A06FDA5295FDFBDD8D34F5C10C35A347D7E91B6AFA0F45B4E8321D7019BDD1F9E5641FEB8737EA6FD40D838FFD0203010001"/>
        <PackageFile Name="dotnetfx.exe" HomeSite="DotNetFXExe" PublicKey="3082010A0282010100B22D8709B55CDF5599EB5262E7D3F4E34571A932BF94F20EE90DADFE9DC7046A584E9CA4D1D84441FB647E0F65EEC817DA4DDBD9D650B40C565B6C16884BBF03EE504883EC4F88939A51E394197FFAB397A5CE606D9FDD4C9338BDCD345971E686CEE98399A096B8EAE0445B1342B93A484E5472F70896E400C482017643AF61C2DBFAE5C5F00213DDF835B40F0D5236467443B1A2CA9CDD7E99F1351177FB1526018ECFE0B804782A15FD72C66076910CE74FB218181B6989B4F12F211B66EACA91C7460DB91758715856866523D10232AE64A06FDA5295FDFBDD8D34F5C10C35A347D7E91B6AFA0F45B4E8321D7019BDD1F9E5641FEB8737EA6FD40D838FFD0203010001"/>
        <PackageFile Name="dotnetchk.exe"/>
    </PackageFiles>

См. также

Ссылки

Элемент <Product> (загрузчик)

Элемент <Package> (загрузчик)

Справочные сведения о схеме пакетов и продуктов

Поделиться через