GenerateDeploymentManifest タスク
更新 : 2007 年 11 月
ClickOnce 配置マニフェストを生成します。ClickOnce 配置マニフェストでは、アプリケーションの配置方法について記述します。記述する内容は、配置するための一意の ID の定義、インストールするのかオンライン モードで使用するのかなど配置の特徴の指定、アプリケーションの更新設定および更新場所の指定、対応する ClickOnce アプリケーション マニフェストの指定などです。
パラメータ
GenerateDeploymentManifest タスクのパラメータの説明を次の表に示します。
パラメータ |
説明 |
|---|---|
AssemblyName |
省略可能な String 型のパラメータです。 生成されるマニフェストのアセンブリ ID の Name フィールドを指定します。このパラメータを指定しない場合、名前は EntryPoint パラメータまたは InputManifest パラメータから推測されます。名前が推測できない場合、タスクはエラーをスローします。 |
AssemblyVersion |
省略可能な String 型のパラメータです。 生成されるマニフェストのアセンブリ ID の Version フィールドを指定します。このパラメータを指定しなかった場合は、タスクは "1.0.0.0" という値を使用します。 |
DeploymentUrl |
省略可能な String 型のパラメータです。 アプリケーションの更新場所を指定します。このパラメータを指定しなかった場合、アプリケーションの更新場所は定義されません。ただし、UpdateEnabled パラメータが true である場合、更新場所を指定する必要があります。値には、完全修飾 URL または UNC パスを指定します。 |
Description |
省略可能な String 型のパラメータです。 アプリケーションの説明を指定します。 |
DisallowUrlActivation |
省略可能な Boolean 型のパラメータです。 URL 経由で開かれたときに、アプリケーションを自動的に実行するかどうかを指定します。このパラメータを true にすると、アプリケーションの実行は [スタート] メニューからのみ行えるようになります。このパラメータの既定値は、false です。この値は、Install パラメータが true である場合のみ適用されます。 |
EntryPoint |
省略可能な ITaskItem[] 型のパラメータです。 生成されるマニフェスト アセンブリのエントリ ポイントを指定します。ClickOnce 配置マニフェストの場合には、ClickOnce アプリケーション マニフェストを指定します。 Visual Studio 2005 では、GenerateApplicationManifest タスクでアプリケーション マニフェストを生成するためには、EntryPoint が必要でした (アセンブリ マニフェストまたはネイティブ マニフェストの場合、EntryPoint は不要)。この要件を満たしていないと "MSB3185: "MSB3185: マニフェストに EntryPoint が指定されていません。" というビルド エラーが発生します。 Visual Studio 2008 では、MSBuild に EntryPoint タスク パラメータが指定されていなくても、このエラーは発生しません。代わりに、たとえば <customHostSpecified> タグが <entryPoint> タグの子として挿入されます。 <entryPoint xmlns="urn:schemas- microsoft-com:asm.v2"> <co.v1:customHostSpecified /> </entryPoint> 次の手順を使用して、アプリケーション マニフェストに DLL 依存関係を追加できます。
|
InputManifest |
省略可能な ITaskItem 型のパラメータです。 マニフェスト ジェネレータのベースとして使用する、入力 XML ドキュメントを指定します。これによって、カスタム マニフェスト定義など、構造化されたデータが出力マニフェストに反映されます。XML ドキュメントのルート要素は、asmv1 名前空間内のアセンブリ ノードである必要があります。 |
Install |
省略可能な Boolean 型のパラメータです。 アプリケーションがインストールされているアプリケーションであるか、オンライン専用アプリケーションであるかを指定します。このパラメータを true にすると、アプリケーションはユーザーの [スタート] メニューにインストールされ、[プログラムの追加と削除] ダイアログ ボックスから削除できるようになります。このパラメータを false にすると、アプリケーションは Web ページからオンラインで使用するためのものになります。このパラメータの既定値は、true です。 |
MapFileExtensions |
省略可能な Boolean 型のパラメータです。 .deploy ファイル名拡張子の割り当てを使用するかどうかを指定します。このパラメータを true にすると、各プログラム ファイルは、.deploy のファイル名拡張子で発行されます。このオプションを使用すると、ブロックを解除して ClickOnce アプリケーション配置を有効にする必要があるファイル名拡張子の数を制限できるので、Web サーバーのセキュリティに役立ちます。このパラメータの既定値は、false です。 |
MaxTargetPath |
省略可能な String 型のパラメータです。 ClickOnce アプリケーション配置におけるファイル パスの最大許容長を指定します。このパラメータを指定した場合、アプリケーションで指定されている各ファイル パスの長さが、この制限に照らしてチェックされます。この制限を超える項目に対しては、ビルド警告が出力されます。入力を指定しないか、ゼロを指定した場合、チェック処理は行われません。 |
MinimumRequiredVersion |
省略可能な String 型のパラメータです。 ユーザーが更新をスキップできるかどうかを指定します。最低限必要なバージョンよりも前のバージョンをユーザーが所有している場合、ユーザーは更新をスキップできません。この入力は、Install パラメータの値が true である場合のみ適用されます。 |
OutputManifest |
省略可能な ITaskItem 型のパラメータです。 生成される出力マニフェスト ファイルの名前を指定します。このパラメータが指定されていない場合、出力ファイルの名前は、生成されるマニフェストの ID から推測されます。 |
Platform |
省略可能な String 型のパラメータです。 アプリケーションの対象プラットフォームを指定します。このパラメータには、次の値を指定できます。
既定値は、AnyCPU です。 |
Product |
省略可能な String 型のパラメータです。 アプリケーション名を示します。このパラメータが指定されていない場合、名前は、生成されるマニフェストの ID から推測されます。この名前は、[スタート] メニューに表示する名前として使用され、[プログラムの追加と削除] ダイアログ ボックスに表示される名前の一部としても使用されます。 |
Publisher |
省略可能な String 型のパラメータです。 アプリケーションの発行者を指定します。このパラメータが指定されていない場合、名前は、登録されているユーザー名または生成されるマニフェストの ID から推測されます。この名前は、[スタート] メニューに表示する名前として使用され、[プログラムの追加と削除] ダイアログ ボックスに表示される名前の一部としても使用されます。 |
SupportUrl |
省略可能な String 型のパラメータです。 [プログラムの追加と削除] ダイアログ ボックスで、このアプリケーションのエントリに表示されるリンクを指定します。値には、完全修飾 URL または UNC パスを指定します。 |
TargetCulture |
省略可能な String 型のパラメータです。 アプリケーションのカルチャを指定し、生成されるマニフェストのアセンブリ ID の Language フィールドを指定します。このパラメータを指定しなかった場合、アプリケーションは、カルチャに依存しないと仮定されます。 |
TrustUrlParameters |
省略可能な Boolean 型のパラメータです。 アプリケーションで、URL クエリ文字列パラメータが使用できるかどうかを指定します。このパラメータの既定値は、アプリケーションでパラメータが使用できないことを示す false です。 |
UpdateEnabled |
省略可能な Boolean 型のパラメータです。 アプリケーションが更新に対して有効であるかどうかを指定します。このパラメータの既定値は、false です。このパラメータは、Install パラメータが true である場合のみ適用されます。 |
UpdateInterval |
省略可能な Int32 型のパラメータです。 アプリケーションの更新間隔を指定します。このパラメータの既定値は、ゼロです。このパラメータは、Install パラメータおよび UpdateEnabled パラメータの両方が true である場合にのみ適用されます。 |
UpdateMode |
省略可能な String 型のパラメータです。 更新の確認を、アプリケーションを起動する前にフォアグラウンドで行うのか、アプリケーションの実行中にバックグラウンドで行うのかを指定します。このパラメータには、次の値を指定できます。
このパラメータの既定値は、Background です。このパラメータは、Install パラメータおよび UpdateEnabled パラメータの両方が true である場合にのみ適用されます。 |
UpdateUnit |
省略可能な String 型のパラメータです。 UpdateInterval パラメータの単位を指定します。このパラメータには、次の値を指定できます。
このパラメータは、Install パラメータおよび UpdateEnabled パラメータの両方が true である場合にのみ適用されます。 |
解説
GenerateDeploymentManifest タスクの使用方法については、「GenerateApplicationManifest タスク」を参照してください。
参照
概念
参照
GenerateApplicationManifest タスク