Share via

Elemento <PackageFiles> (bootstrapper)

  • Artigo

O elemento PackageFiles contém elementos PackageFile, que definem os pacotes de instalação executados como resultado do elemento Command.

Sintaxe

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

Elementos e atributos

O elemento PackageFiles tem o atributo a seguir.

Atributo Descrição
CopyAllPackageFiles Opcional. Se definido como false, o instalador baixará apenas os arquivos referenciados do elemento Command. Se definido como true, todos os arquivos serão baixados.

Se definido como IfNotHomesite, o instalador se comportará da mesma forma que False se ComponentsLocation estiver definido como HomeSite e, caso contrário, se comportará da mesma forma que True. Essa configuração pode ser útil para permitir que pacotes que são os próprios bootstrappers executem seu próprio comportamento em um cenário HomeSite.

O padrão é true.

PackageFile

O elemento PackageFile é um elemento filho do elemento PackageFiles. Um elemento PackageFiles deve ter pelo menos um elemento PackageFile.

PackageFile tem os atributos a seguir.

Atributo Descrição
Name Obrigatórios. O nome do arquivo do pacote. Esse é o nome que o elemento Command fará referência quando definir as condições sob as quais um pacote é instalado. Esse valor também é usado como uma chave na tabela Strings para recuperar o nome localizado que as ferramentas, como o Visual Studio, usarão para descrever o pacote.
HomeSite Opcional. O local do pacote no servidor remoto, se ele não estiver incluído com o instalador.
CopyOnBuild Opcional. Especifica se o bootstrapper deve copiar o arquivo de pacote para o disco no momento da compilação. O padrão é true.
PublicKey A chave pública criptografada do signatário de certificado do pacote. Obrigatório se HomeSite for usado; caso contrário, opcional.
Hash Opcional. Um hash SHA1 do arquivo de pacote. Isso é usado para verificar a integridade do arquivo no momento da instalação. Se o hash idêntico não puder ser calculado a partir do arquivo de pacote, o pacote não será instalado.

Exemplo

O exemplo de código a seguir define pacotes para o pacote redistribuível do .NET Framework e suas dependências, como o Windows Installer.

<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>

Confira também