GenerateDeploymentManifest タスクGenerateDeploymentManifest Task

ClickOnceClickOnce 配置マニフェストを生成します。Generates a ClickOnceClickOnce deployment manifest. ClickOnceClickOnce 配置マニフェストでは、アプリケーションの配置方法について記述します。記述する内容は、配置するための一意の ID の定義、インストールするのかオンライン モードで使用するのかなど配置の特徴の指定、アプリケーションの更新設定および更新プログラムの場所の指定、対応する ClickOnceClickOnce アプリケーション マニフェストの指定などです。A ClickOnceClickOnce deployment manifest describes the deployment of an application by defining a unique identity for the deployment, identifying deployment traits such as install or online mode, specifying application update settings and update locations, and indicating the corresponding ClickOnceClickOnce application manifest.

パラメーターParameters

GenerateDeploymentManifest タスクのパラメーターの説明を次の表に示します。The following table describes the parameters for the GenerateDeploymentManifest task.

パラメーターParameter 説明Description
AssemblyName 省略可能な String 型のパラメーターです。Optional String parameter.

生成されるマニフェストのアセンブリ ID の Name フィールドを指定します。Specifies the Name field of the assembly identity for the generated manifest. このパラメーターを指定しない場合、名前は EntryPoint パラメーターまたは InputManifest パラメーターから推測されます。If this parameter is not specified, the name is inferred from the EntryPoint or InputManifest parameters. 名前が推測できない場合、タスクはエラーをスローします。If the name cannot be inferred, the task throws an error.
AssemblyVersion 省略可能な String 型のパラメーターです。Optional String parameter.

生成されるマニフェストのアセンブリ ID の Version フィールドを指定します。Specifies the Version field of the assembly identity for the generated manifest. このパラメーターを指定しなかった場合、タスクは "1.0.0.0" という値を使用します。If this parameter is not specified, the task uses the value "1.0.0.0".
CreateDesktopShortcut 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

true の場合、ClickOnce アプリケーションのインストール時にデスクトップにアイコンが作成されます。If true, an icon is created on the desktop during ClickOnce application installation.
DeploymentUrl 省略可能な String 型のパラメーターです。Optional String parameter.

アプリケーションの更新プログラムの場所を指定します。Specifies the update location for the application. このパラメーターを指定しなかった場合、アプリケーションの更新プログラムの場所は定義されません。If this parameter is not specified, no update location is defined for the application. ただし、UpdateEnabled パラメーターが true である場合、更新プログラムの場所を指定する必要があります。However, if the UpdateEnabled parameter is true, the update location must be specified. 値には、完全修飾 URL または UNC パスを指定します。The specified value should be a fully qualified URL or UNC path.
Description 省略可能な String 型のパラメーターです。Optional String parameter.

アプリケーションの説明を指定します。Specifies an optional description for the application.
DisallowUrlActivation 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

URL 経由で開かれたときに、アプリケーションを自動的に実行するかどうかを指定します。Specifies whether the application should be run automatically when it is opened through a URL. このパラメーターを true にすると、アプリケーションの実行は [スタート] メニューからのみ行えるようになります。If this parameter is true, the application can only be started from the Start menu. このパラメーターの既定値は、false です。The default value of this parameter is false. この値は、Install パラメーターが true である場合のみ適用されます。This input applies only when the Install parameter value is true.
EntryPoint 省略可能な ITaskItem[] 型のパラメーターです。Optional ITaskItem[] parameter.

生成されるマニフェスト アセンブリのエントリ ポイントを指定します。Indicates the entry point for the generated manifest assembly. ClickOnceClickOnce 配置マニフェストの場合には、ClickOnceClickOnce アプリケーション マニフェストを指定します。For a ClickOnceClickOnce deployment manifest, this input specifies the ClickOnceClickOnce application manifest.

Visual Studio 2005Visual Studio 2005 では、GenerateApplicationManifest タスクでアプリケーション マニフェストを生成するためには、EntryPoint が必要でした In Visual Studio 2005Visual Studio 2005, the GenerateApplicationManifest Task required an EntryPoint to generate an application manifest. (アセンブリ マニフェストまたはネイティブ マニフェストの場合、EntryPoint は不要)。この要件を満たしていないと "MSB3185: "MSB3185: マニフェストに EntryPoint が指定されていません。" というビルド エラーが発生します。(Assembly or native manifests do not require an EntryPoint.) This requirement was enforced with the build error: "MSB3185: EntryPoint not specified for manifest."

MSBuildMSBuild では、EntryPoint タスク パラメーターが指定されていなくても、このエラーは発生しません。 does not issue this error when the EntryPoint task parameter is not specified. 代わりに、たとえば <customHostSpecified> タグが <entryPoint> タグの子として挿入されます。Instead, the <customHostSpecified> tag is inserted as a child of the <entryPoint> tag, for example:

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

次の手順を使用して、アプリケーション マニフェストに DLL 依存関係を追加できます。You can add DLL dependencies to the application manifest by using the following steps:

1.ResolveAssemblyReference への呼び出しでアセンブリの参照を解決します。1. Resolve the assembly references with a call to ResolveAssemblyReference.
2.前のタスクの出力とアセンブリ自体を ResolveManifestFiles に渡します。2. Pass the output of the previous task and the assembly itself to ResolveManifestFiles.
3.Dependencies パラメーターを使用して GenerateApplicationManifest に依存関係を渡します。3. Pass the dependencies by using the Dependencies parameter to GenerateApplicationManifest.
ErrorReportUrl 省略可能な System.String 型のパラメーターです。Optional System.String parameter.

ClickOnce のインストール時にダイアログ ボックスに表示される Web ページの URL を指定します。Specifies the URL of the Web page that is displayed in dialog boxes during ClickOnce installations.
InputManifest 省略可能な ITaskItem 型のパラメーターです。Optional ITaskItem parameter.

マニフェスト ジェネレーターのベースとして使用する、入力 XML ドキュメントを指定します。Indicates an input XML document to serve as a base for the manifest generator. これによって、カスタム マニフェスト定義など、構造化されたデータが出力マニフェストに反映されます。This enables structured data, such as custom manifest definitions, to be reflected in the output manifest. XML ドキュメントのルート要素は、asmv1 名前空間内のアセンブリ ノードである必要があります。The root element in the XML document must be an assembly node in the asmv1 namespace.
Install 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

アプリケーションがインストールされているアプリケーションであるか、オンライン専用アプリケーションであるかを指定します。Specifies whether the application is an installed application or an online-only application. このパラメーターを true にすると、アプリケーションはユーザーの [スタート] メニューにインストールされ、[プログラムの追加と削除] ダイアログ ボックスから削除できるようになります。If this parameter is true, the application will be installed on the user's Start menu, and can be removed by using the Add or Remove Programs dialog box. このパラメーターを false にすると、アプリケーションは Web ページからオンラインで使用するためのものになります。If this parameter is false, the application is intended for online use from a Web page. このパラメーターの既定値は、true です。The default value of this parameter is true.
MapFileExtensions 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

.deploy ファイル名拡張子の割り当てを使用するかどうかを指定します。Specifies whether the .deploy file name extension mapping is used. このパラメーターを true にすると、各プログラム ファイルは、.deploy のファイル名拡張子で発行されます。If this parameter is true, every program file is published with a .deploy file name extension. このオプションを使用すると、ブロックを解除して ClickOnceClickOnce アプリケーション配置を有効にする必要があるファイル名拡張子の数を制限できるので、Web サーバーのセキュリティに役立ちます。This option is useful for Web server security to limit the number of file name extensions that must be unblocked to enable ClickOnceClickOnce application deployment. このパラメーターの既定値は、false です。The default value of this parameter is false.
MaxTargetPath 省略可能な String 型のパラメーターです。Optional String parameter.

ClickOnceClickOnce アプリケーション配置におけるファイル パスの最大許容長を指定します。Specifies the maximum allowed length of a file path in a ClickOnceClickOnce application deployment. このパラメーターを指定した場合、アプリケーションで指定されている各ファイル パスの長さが、この制限に照らしてチェックされます。If this parameter is specified, the length of each file path in the application is checked against this limit. この制限を超える項目に対しては、ビルド警告が出力されます。Any items that exceed the limit will cause a build warning. 入力を指定しないか、ゼロを指定した場合、チェック処理は行われません。If this input is not specified or is zero, no checking is performed.
MinimumRequiredVersion 省略可能な String 型のパラメーターです。Optional String parameter.

ユーザーが更新をスキップできるかどうかを指定します。Specifies whether the user can skip the update. 最低限必要なバージョンよりも前のバージョンをユーザーが所有している場合、ユーザーは更新をスキップできません。If the user has a version that is less than the minimum required, he will not have the option to skip the update. この入力は、Install パラメーターの値が true である場合のみ適用されます。This input only applies when the value of the Install parameter is true.
OutputManifest 省略可能な ITaskItem 型のパラメーターです。Optional ITaskItem parameter.

生成される出力マニフェスト ファイルの名前を指定します。Specifies the name of the generated output manifest file. このパラメーターが指定されていない場合、出力ファイルの名前は、生成されるマニフェストの ID から推測されます。If this parameter is not specified, the name of the output file is inferred from the identity of the generated manifest.
Platform 省略可能な String 型のパラメーターです。Optional String parameter.

アプリケーションの対象プラットフォームを指定します。Specifies the target platform of the application. このパラメーターには、次の値を指定できます。This parameter can have the following values:

- AnyCPU
- x86
- x64
- Itanium

既定値は AnyCPU です。The default value is AnyCPU.
Product 省略可能な String 型のパラメーターです。Optional String parameter.

アプリケーション名を示します。Specifies the name of the application. このパラメーターが指定されていない場合、名前は、生成されるマニフェストの ID から推測されます。If this parameter is not specified, the name is inferred from the identity of the generated manifest. この名前は、[スタート] メニューに表示する名前として使用され、[プログラムの追加と削除] ダイアログ ボックスに表示される名前の一部としても使用されます。This name is used for the shortcut name on the Start menu and is part of the name that appears in the Add or Remove Programs dialog box.
Publisher 省略可能な String 型のパラメーターです。Optional String parameter.

アプリケーションの発行者を指定します。Specifies the publisher of the application. このパラメーターが指定されていない場合、名前は、登録されているユーザー名または生成されるマニフェストの ID から推測されます。If this parameter is not specified, the name is inferred from the registered user, or the identity of the generated manifest. この名前は、[スタート] メニューに表示するフォルダー名として使用され、[プログラムの追加と削除] ダイアログ ボックスに表示される名前の一部としても使用されます。This name is used for the folder name on the Start menu and is part of the name that appears in the Add or Remove Programs dialog box.
SuiteNamel 省略可能な String 型のパラメーターです。Optional String parameter.

ClickOnce の配置後にアプリケーションが存在する、[スタート] メニューのフォルダーの名前を指定します。Specifies the name of the folder on the Start menu where the application is located after ClickOnce deployment.
SupportUrl 省略可能な String 型のパラメーターです。Optional String parameter.

[プログラムの追加と削除] ダイアログ ボックスで、このアプリケーションのエントリに表示されるリンクを指定します。Specifies the link that appears in the Add or Remove Programs dialog box for the application. 値には、完全修飾 URL または UNC パスを指定します。The specified value should be a fully qualified URL or UNC path.
TargetCulture 省略可能な String 型のパラメーターです。Optional String parameter.

アプリケーションのカルチャを指定し、生成されるマニフェストのアセンブリ ID の Language フィールドを指定します。Identifies the culture of the application, and specifies the Language field of the assembly identity for the generated manifest. このパラメーターを指定しなかった場合、アプリケーションは、カルチャに依存しないと仮定されます。If this parameter is not specified, it is assumed that the application is culture invariant.
TrustUrlParameters 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

アプリケーションで、URL クエリ文字列パラメーターが使用できるかどうかを指定します。Specifies whether URL query-string parameters should be made available to the application. このパラメーターの既定値は、アプリケーションでパラメーターが使用できないことを示す false です。The default value of this parameter is false, which indicates that parameters will not be available to the application.
UpdateEnabled 省略可能な Boolean 型のパラメーターです。Optional Boolean parameter.

アプリケーションが更新プログラムに対して有効であるかどうかを指定します。Indicates whether the application is enabled for updates. このパラメーターの既定値は、false です。The default value of this parameter is false. このパラメーターは、Install パラメーターが true である場合のみ適用されます。This parameter only applies when the value of the Install parameter is true.
UpdateInterval 省略可能な Int32 型のパラメーターです。Optional Int32 parameter.

アプリケーションの更新間隔を指定します。Specifies the update interval for the application. このパラメーターの既定値は、ゼロです。The default value of this parameter is zero. このパラメーターは、Install パラメーターおよび UpdateEnabled パラメーターの両方が true である場合にのみ適用されます。This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.
UpdateMode 省略可能な String 型のパラメーターです。Optional String parameter.

更新プログラムの確認を、アプリケーションを起動する前にフォアグラウンドで行うのか、アプリケーションの実行中にバックグラウンドで行うのかを指定します。Specifies whether updates should be checked in the foreground before the application is started, or in the background as the application is running. このパラメーターには、次の値を指定できます。This parameter can have the following values:

- Foreground
- Background

このパラメーターの既定値は、Background です。The default value of this parameter is Background. このパラメーターは、Install パラメーターおよび UpdateEnabled パラメーターの両方が true である場合にのみ適用されます。This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.
UpdateUnit 省略可能な String 型のパラメーターです。Optional String parameter.

UpdateInterval パラメーターの単位を指定します。Specifies the units for the UpdateInterval parameter. このパラメーターには、次の値を指定できます。This parameter can have the following values:

- Hours
- Days
- Weeks

このパラメーターは、Install パラメーターおよび UpdateEnabled パラメーターの両方が true である場合にのみ適用されます。This parameter only applies when the values of the Install and UpdateEnabled parameters are both true.

コメントRemarks

上記のパラメーター以外に、このタスクは GenerateManifestBase クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。In addition to the parameters listed above, this task inherits parameters from the GenerateManifestBase class, which itself inherits from the Task class. Task クラスのパラメーターの一覧については、「Task Base Class」 を参照してください。For a list of the parameters of the Task class, see Task Base Class.

関連項目See Also

タスク Tasks
GenerateApplicationManifest タスク GenerateApplicationManifest Task
SignFile タスク SignFile Task
Task Reference (タスク リファレンス)Task Reference