<Élément PackageFiles> (programme d’amorçage)

L’élément PackageFiles contient des PackageFile éléments qui définissent les packages d’installation exécutés à la suite de l’élément Command .

Syntaxe

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

Éléments et attributs

L’élément PackageFiles a l’attribut suivant.

Caractéristique Description
CopyAllPackageFiles Optionnel. Si la valeur est définie false, le programme d’installation télécharge uniquement les fichiers référencés à partir de l’élément Command . Si la valeur est définie true, tous les fichiers sont téléchargés.

Si la valeur est définie IfNotHomesite, le programme d’installation se comporte de la même façon que s’il FalseComponentsLocation est défini HomeSitesur ; sinon, il se comporte de la même façon que si True. Ce paramètre peut être utile pour permettre aux packages qui sont eux-mêmes des programmeurs d’exécuter leur propre comportement dans un scénario HomeSite.

La valeur par défaut est true.

PackageFile

L’élément PackageFile est un enfant de l’élément PackageFiles . Un PackageFiles élément doit avoir au moins un PackageFile élément.

PackageFile a les attributs suivants.

Caractéristique Description
Name Obligatoire. Nom du fichier de package. Il s’agit du nom que l’élément Command référence lorsqu’il définit les conditions dans lesquelles un package s’installe. Cette valeur est également utilisée comme clé dans la Strings table pour récupérer le nom localisé que les outils tels que Visual Studio utiliseront pour décrire le package.
HomeSite Optionnel. Emplacement du package sur le serveur distant, s’il n’est pas inclus dans le programme d’installation.
CopyOnBuild Optionnel. Spécifie si le programme d’amorçage doit copier le fichier de package sur le disque au moment de la génération. La valeur par défaut est true.
PublicKey Clé publique chiffrée du signataire de certificat du package. Obligatoire s’il HomeSite est utilisé ; sinon, facultatif.
Hash Optionnel. Hachage SHA256 du fichier de package. Cela permet de vérifier l’intégrité du fichier au moment de l’installation. Si le hachage identique ne peut pas être calculé à partir du fichier de package, le package n’est pas installé. (Notez qu’il s’agissait d’un hachage SHA1 pour .NET 3.5 et versions antérieures)

Exemple

L’exemple de code suivant définit des packages pour le package redistribuable .NET Framework et ses dépendances, comme 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>

Voir également