ClickOnce 配置マニフェスト
配置マニフェストは、配置する ClickOnce アプリケーションの現在のバージョンの識別など、ClickOnce の配置に関する情報を記述した XML ファイルです。
配置マニフェストには、以下の要素および属性があります。
要素 |
Description |
属性 |
|---|---|---|
必ず指定します。最上位の要素です。 |
manifestVersion |
|
必ず指定します。ClickOnce アプリケーションのアプリケーション マニフェストを指定します。 |
name version publicKeyToken processorArchitecture culture |
|
必ず指定します。シェルに表示する内容、およびコントロール パネルの [プログラムの追加と削除] に項目として表示される内容を作成するために使用される、アプリケーション情報を指定します。 |
publisher product supportUrl |
|
省略可能です。更新プログラムの配置とシステムへの公開に使用される属性を指定します。 |
install minimumRequiredVersion mapFileExtensions disallowUrlActivation trustUrlParameters |
|
必ず指定します。このアプリケーションをインストールして実行できる .NET Framework のバージョンを指定します。 |
SupportUrl |
|
必ず指定します。配置でインストールするアプリケーションのバージョンおよびアプリケーション マニフェストの場所を指定します。 |
preRequisite visible dependencyType codebase size |
|
署名付きマニフェストに対しては必ず指定します。この配置マニフェストに署名した発行者に関する情報が含まれます。 |
Name issuerKeyHash |
|
省略可能です。この配置マニフェストにデジタル署名するために必要な情報を格納します。 |
なし |
|
省略可能です。エラー発生時に表示する URI を指定します。 |
Uri |
解説
配置マニフェスト ファイルには、現在のバージョンやその他の配置の設定など、ClickOnce アプリケーションの配置に関する情報を指定します。配置マニフェストでは、アプリケーション マニフェストを参照します。アプリケーション マニフェストには、アプリケーションの現在のバージョンおよび配置に含められるすべてのファイルが記述されています。
詳細については、「ClickOnce のセキュリティと配置」を参照してください。
ファイルの場所
配置マニフェスト ファイルでは、アプリケーションの現在のバージョンに対応するアプリケーション マニフェストを参照します。新しいバージョンのアプリケーションが配置できるようになったら、新しいアプリケーション マニフェストを参照するよう配置マニフェストを更新する必要があります。
配置マニフェスト ファイルには、厳密な名前を付ける必要があります。また、配置マニフェスト ファイルには、公開者を確認するための証明書を含めることもできます。
ファイル名の構文
配置マニフェスト ファイルの名前は .application という拡張子で終わる必要があります。
例
配置マニフェストを次のコード例に示します。
<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd"
manifestVersion="1.0"
xmlns:asmv3="urn:schemas-microsoft-com:asm.v3"
xmlns:dsig=http://www.w3.org/2000/09/xmldsig#
xmlns:co.v1="urn:schemas-microsoft-com:clickonce.v1"
xmlns:co.v2="urn:schemas-microsoft-com:clickonce.v2"
xmlns="urn:schemas-microsoft-com:asm.v2"
xmlns:asmv1="urn:schemas-microsoft-com:asm.v1"
xmlns:asmv2="urn:schemas-microsoft-com:asm.v2"
xmlns:xrml="urn:mpeg:mpeg21:2003:01-REL-R-NS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<assemblyIdentity
name="My Application Deployment.app"
version="1.0.0.0"
publicKeyToken="43cb1e8e7a352766"
language="neutral"
processorArchitecture="x86"
xmlns="urn:schemas-microsoft-com:asm.v1" />
<description
asmv2:publisher="My Company Name"
asmv2:product="My Application"
xmlns="urn:schemas-microsoft-com:asm.v1" />
<deployment install="true">
<subscription>
<update>
<expiration maximumAge="0" unit="days" />
</update>
</subscription>
<deploymentProvider codebase="\\myServer\sampleDeployment\MyApplicationDeployment.application" />
</deployment>
<compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2">
<framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.20506" />
<framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.20506" />
</compatibleFrameworks>
<dependency>
<dependentAssembly
dependencyType="install"
codebase="1.0.0.0\My Application Deployment.exe.manifest"
size="6756">
<assemblyIdentity
name="My Application Deployment.exe"
version="1.0.0.0"
publicKeyToken="43cb1e8e7a352766"
language="neutral"
processorArchitecture="x86"
type="win32" />
<hash>
<dsig:Transforms>
<dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
</dsig:Transforms>
<dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
<dsig:DigestValue>E506x9FwNauks7UjQywmzgtd3FE=</dsig:DigestValue>
</hash>
</dependentAssembly>
</dependency>
<publisherIdentity name="CN=DOMAIN\MyUsername" issuerKeyHash="18312a18a21b215ecf4cdb20f5a0e0b0dd263c08" /><Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
…
</Signature></asmv1:assembly>