PackageFiles要素にはPackageFile要素が含まれており、Command要素の結果として実行されるインストール パッケージを定義します。
構文
<PackageFiles
CopyAllPackageFiles
>
<PackageFile
Name
HomeSite
CopyOnBuild
PublicKey
Hash
/>
</PackageFiles>
要素と属性
PackageFiles要素には、次の属性があります。
| 特性 | 説明 |
|---|---|
CopyAllPackageFiles |
このフィールドは省略可能です。
falseに設定すると、インストーラーは Command 要素から参照されるファイルのみをダウンロードします。
trueに設定すると、すべてのファイルがダウンロードされます。IfNotHomesiteに設定すると、インストーラーはComponentsLocationがHomeSiteに設定されている場合と同じ動作をFalseし、それ以外の場合はTrueと同じように動作します。 この設定は、自身がブートストラップであるパッケージが HomeSite シナリオで独自の動作を実行できるようにする場合に役立ちます。既定値は、 true です。 |
PackageFile
PackageFile要素は、PackageFiles要素の子です。
PackageFiles要素には、少なくとも 1 つのPackageFile要素が必要です。
PackageFile には、次の属性があります。
| 特性 | 説明 |
|---|---|
Name |
必須。 パッケージ ファイルの名前。 これは、パッケージがインストールされる条件を定義するときに、 Command 要素が参照する名前です。 この値は、Visual Studio などのツールがパッケージの記述に使用するローカライズされた名前を取得するために、 Strings テーブルのキーとしても使用されます。 |
HomeSite |
このフィールドは省略可能です。 インストーラーに含まれていない場合は、リモート サーバー上のパッケージの場所。 |
CopyOnBuild |
このフィールドは省略可能です。 ブートストラップがビルド時にパッケージ ファイルをディスクにコピーするかどうかを指定します。 既定値は true です。 |
PublicKey |
パッケージの証明書署名者の暗号化された公開キー。
HomeSiteを使用する場合は必須。それ以外の場合は省略可能です。 |
Hash |
このフィールドは省略可能です。 パッケージ ファイルの SHA256 ハッシュ。 これは、インストール時にファイルの整合性を確認するために使用されます。 パッケージ ファイルから同じハッシュを計算できない場合、パッケージはインストールされません。 (これは .NET 3.5 以前の 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>