チュートリアル : ClickOnce アプリケーションを手動で配置する

[アーティクル]
08/09/2011

Visual Studio を使用して ClickOnce アプリケーションを配置できない場合、または信頼されたアプリケーションの配置のような高度な配置機能を使用する必要がある場合は、Mage.exe というコマンドラインツールを使用して ClickOnce マニフェストを作成します。このチュートリアルでは、マニフェストの生成および編集ツールのコマンドラインバージョン (Mage.exe) または GUI バージョン (MageUI.exe) を使用して ClickOnce 配置を作成する方法について説明します。

必須コンポーネント

このチュートリアルには、必須コンポーネントと、配置をビルドする前に選択する必要のあるオプションがいくつかあります。

Mage.exe と MageUI.exe をインストールします。

Mage.exe と MageUI.exe は Windows Software Development Kit (SDK) に含まれています。インストール済みの Windows SDK または Visual Studio に同梱されているバージョンの Windows SDK が必要です。詳細については、MSDN の「Windows SDK」を参照してください。
配置するアプリケーションを用意します。

このチュートリアルは、配置する準備が整っている Windows アプリケーションがあることを前提としています。このアプリケーションを、AppToDeploy と呼びます。
配置の配布方法を決定します。

配布オプションには、Web、ファイル共有、または CD があります。詳細については、「ClickOnce のセキュリティと配置」を参照してください。
アプリケーションがより高いレベルの信頼を必要とするかどうかを決定します。

アプリケーションが完全な信頼 (ユーザーのシステムへのフルアクセスなど) を必要とする場合は、Mage.exe の -TrustLevel オプションを使用して完全信頼を設定できます。アプリケーションにカスタム化したアクセス許可セットを定義する場合には、他のマニフェストからインターネットセクションまたはイントラネットセクションをコピーし、必要に合わせて変更し、テキストエディターまたは MageUI.exe を使用してアプリケーションマニフェストに追加します。詳細については、「信頼されたアプリケーションの配置の概要」を参照してください。
Authenticode 証明書を取得します。

Authenticode 証明書を使用して配置に署名する必要があります。 Visual Studio、MageUI.exe、または MakeCert.exe および Pvk2Pfx.exe の各ツールを使用してテスト証明書を生成するか、証明機関 (CA: Certificate Authority) から証明書を取得することができます。信頼されたアプリケーションの配置を使用する場合には、すべてのクライアントコンピューターに証明書を 1 回だけインストールする必要もあります。詳細については、「信頼されたアプリケーションの配置の概要」を参照してください。
アプリケーションに UAC 情報を含むマニフェストがないことを確認します。

アプリケーションに、<dependentAssembly> 要素などのユーザーアカウント制御 (UAC: User Account Control) 情報を含むマニフェストがあるかどうかを確認する必要があります。アプリケーションマニフェストを調べるには、Windows Sysinternals Sigcheck ユーティリティを使用できます。

アプリケーションに UAC 情報を含むマニフェストがある場合は、UAC 情報が含まれないようにアプリケーションをビルドし直す必要があります。 Visual Studio の C# プロジェクトの場合は、プロジェクトのプロパティを開いて [アプリケーション] タブをクリックします。 [マニフェスト] ボックスの一覧の [マニフェストなしでアプリケーションを作成します] をクリックします。 Visual Studio の Visual Basic プロジェクトの場合は、プロジェクトのプロパティを開いて [アプリケーション] タブをクリックし、[UAC 設定の表示] をクリックします。開いているマニフェストファイルで、1 つの <asmv1:assembly> 要素内のすべての要素を削除します。
アプリケーションがクライアントコンピューターで必須コンポーネントを必要とするかどうかを決定します。

Visual Studio から配置する ClickOnce アプリケーションでは、必須コンポーネントをインストールするブートストラップ (setup.exe) を配置に含めることができます。このチュートリアルでは、ClickOnce 配置に必要なマニフェストを 2 つ作成します。必須コンポーネントブートストラップを作成するには、GenerateBootstrapper タスクを使用できます。

コマンドラインツール Mage.exe でアプリケーションを配置するには

ClickOnce 配置ファイルを格納するディレクトリを作成します。
作成した配置ディレクトリに、バージョンサブディレクトリを作成します。初めてアプリケーションを配置する場合は、バージョンサブディレクトリに 1.0.0.0 という名前を付けます。

注意

配置のバージョンは、アプリケーションのバージョンとは異なる場合もあります。
実行可能ファイル、アセンブリ、リソースファイル、データファイルなど、すべてのアプリケーションファイルをバージョンサブディレクトリにコピーします。必要に応じて、追加ファイルを格納する追加サブディレクトリを作成することもできます。
Windows SDK または Visual Studio コマンドプロンプトを開いて、バージョンサブディレクトリに移動します。
Mage.exe を呼び出して、アプリケーションマニフェストを作成します。次のステートメントは、Intel x86 プロセッサで実行されるようにコンパイルされたコードのアプリケーションマニフェストを作成します。
```
mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory . 
```
注意

必ずドット (.) を -FromDirectory オプションの後に入力してください (現在のディレクトリを示します)。ドットを入力しない場合は、アプリケーションファイルのパスを指定する必要があります。
Authenticode 証明書を使用してアプリケーションマニフェストに署名します。 mycert.pfx は証明書ファイルのパスに置き換えます。 passwd は証明書ファイルのパスワードに置き換えます。
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
配置ディレクトリのルートに移動します。
Mage.exe を呼び出して、配置マニフェストを作成します。既定では、Mage.exe は ClickOnce 配置を、オンラインでもオフラインでも実行できるように、インストールアプリケーションとして指定します。ユーザーがオンラインの場合にだけアプリケーションを使用できるようにする場合は、-Install オプションを使用し、値を false に設定します。既定値を使用して、Web サイトまたはファイル共有からユーザーがアプリケーションをインストールするようにする場合は、-ProviderUrl オプションの値が Web サーバー上または共有サイト上のアプリケーションマニフェストの場所を指していることを確認してください。
```
mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
```
Authenticode 証明書を使用して配置マニフェストに署名します。
```
mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
```
配置ディレクトリ内のすべてのファイルを配置先またはメディアにコピーします。コピー先は、Web サイトのフォルダー、FTP サイトのフォルダー、ファイル共有、または CD-ROM のいずれかです。
ユーザーがアプリケーションをインストールするために必要な URL、UNC、または物理メディアを指定します。 URL または UNC を指定する場合は、配置マニフェストの完全パスをユーザーに示す必要があります。たとえば、AppToDeploy を http://webserver01/ の AppToDeploy ディレクトリに配置する場合、URL の完全パスは http://webserver01/AppToDeploy/AppToDeploy.application です。

MageUI.exe グラフィカルツールでアプリケーションを配置するには

ClickOnce 配置ファイルを格納するディレクトリを作成します。
作成した配置ディレクトリに、バージョンサブディレクトリを作成します。初めてアプリケーションを配置する場合は、バージョンサブディレクトリに 1.0.0.0 という名前を付けます。

注意

配置のバージョンは、アプリケーションのバージョンとは異なる場合もあります。
実行可能ファイル、アセンブリ、リソースファイル、データファイルなど、すべてのアプリケーションファイルをバージョンサブディレクトリにコピーします。必要に応じて、追加ファイルを格納する追加サブディレクトリを作成することもできます。
MageUI.exe グラフィカルツールを起動します。
```
MageUI.exe
```
[File] メニューの [New] をポイントし、[Application Manifest] をクリックして、アプリケーションマニフェストを新規作成します。
既定で表示される [Name] ページで、この配置の名前およびバージョン番号を入力します。また、アプリケーションがビルドされる対象のプロセッサも指定します (x86 など)。
[Files] タブをクリックし、[Application Directory] ボックスの横の省略記号 ([...]) ボタンをクリックします。 [Browse For Folder] ダイアログボックスが表示されます。
アプリケーションファイルが格納されているバージョンサブディレクトリを選択し、[OK] をクリックします。
インターネットインフォメーションサービス (IIS: Internet Information Services) から配置する場合は、[When populating add the .deploy extension to any file that does not have it] チェックボックスをオンにします。
[Populate] をクリックし、アプリケーションファイルすべてをファイルリストに追加します。アプリケーションに実行可能ファイルが複数含まれている場合は、[File Type] ボックスの [Entry Point] をオンにして、この配置のメイン実行可能ファイルをスタートアップアプリケーションとして指定します。アプリケーションの実行可能ファイルが 1 つだけの場合は、そのファイルが MageUI.exe によってメイン実行可能ファイルとしてマークされます。
[Permissions Required] タブをクリックし、アプリケーションが要求する信頼のレベルを選択します。既定値は [FullTrust] です。この設定は、ほとんどのアプリケーションに適しています。
[File] メニューの [Save As] をクリックします。 [Signing Options] ダイアログボックスが表示され、アプリケーションマニフェストに署名するように求めるメッセージが表示されます。
証明書をファイルとしてファイルシステムに保存してある場合には、[Sign with certificate file] オプションの省略記号 ([...]) ボタンをクリックして、ファイルシステム上の証明書を選択します。次に、証明書パスワードを入力します。

または

使用しているコンピューターからアクセスできる証明書ストアに証明書が保存されている場合には、[Sign with stored certificate] オプションをクリックし、表示された一覧から証明書を選択します。
[OK] をクリックしてアプリケーションマニフェストに署名します。 [名前を付けて保存] ダイアログボックスが表示されます。
[Save As] ダイアログボックスで、バージョンディレクトリを指定して [Save] をクリックします。
[File] メニューの [New] をポイントし、[Deployment Manifest] をクリックして、配置マニフェストを作成します。
[Name] ページで、この配置の名前とバージョン番号 (この例の場合は、1.0.0.0) を指定します。また、アプリケーションがビルドされる対象のプロセッサも指定します (x86 など)。
[Description] タブをクリックし、[Publisher] ボックスおよび [Product] ボックスで値を指定します。 [Product] はアプリケーションに付けられる名前で、オフラインで使用するためにアプリケーションをクライアントコンピューターにインストールしたときに Windows の [スタート] メニューに表示されます。
[Deployment Options] タブをクリックし、[Start Location] ボックスで、Web サーバー上または共有サイト上のアプリケーションマニフェストの場所を指定します (\\myServer\myShare\AppToDeploy.application など)。
前の手順で .deploy 拡張子を追加した場合は、ここで [Use .deploy file name extension] もオンにします。
[Update Options] タブをクリックし、このアプリケーションを更新する頻度を指定します。アプリケーションが UpdateCheckInfo を使用して自動的に更新をチェックする場合は、[This application should check for updates] チェックボックスをオフにします。
[Application Reference] タブをクリックし、[Select Manifest] ボタンをクリックします。 [Open] ダイアログボックスが表示されます。
作成したアプリケーションマニフェストを選択し、[Open] をクリックします。
[File] メニューの [Save As] をクリックします。 [Signing Options] ダイアログボックスが表示され、配置マニフェストに署名するように求めるメッセージが表示されます。
証明書をファイルとしてファイルシステムに保存してある場合には、[Sign with certificate file] オプションの省略記号 ([...]) ボタンをクリックして、ファイルシステム上の証明書を選択します。次に、証明書パスワードを入力します。

または

使用しているコンピューターからアクセスできる証明書ストアに証明書が保存されている場合には、[Sign with stored certificate] オプションをクリックし、表示された一覧から証明書を選択します。
[OK] をクリックして配置マニフェストに署名します。 [名前を付けて保存] ダイアログボックスが表示されます。
[Save As] ダイアログボックスで、1 つ上のディレクトリ (配置のルート) に移動して、[Save] をクリックします。
配置ディレクトリ内のすべてのファイルを配置先またはメディアにコピーします。コピー先は、Web サイトのフォルダー、FTP サイトのフォルダー、ファイル共有、または CD-ROM のいずれかです。
ユーザーがアプリケーションをインストールするために必要な URL、UNC、または物理メディアを指定します。 URL または UNC を指定する場合は、配置マニフェストの完全パスをユーザーに示す必要があります。たとえば、AppToDeploy を http://webserver01/ の AppToDeploy ディレクトリに配置する場合、URL の完全パスは http://webserver01/AppToDeploy/AppToDeploy.application です。

次の手順

アプリケーションの新しいバージョンを配置するときは、新しいディレクトリを作成し、それに新しいバージョン番号 (たとえば 1.0.0.1) を使用した名前を付け、その新しいディレクトリに新しいアプリケーションファイルをコピーします。次に、前の手順に従って新しいアプリケーションマニフェストを作成して署名し、配置マニフェストを更新して署名する必要があります。 Mage.exe の -New と –Update の両方の呼び出しで、同じ上位のバージョンを指定するように注意してください。ClickOnce では左端の整数が最も重要であると見なされ、上位のバージョンのみが更新されます。 MageUI.exe を使用した場合は、配置マニフェストを開いて [Application Reference] タブをクリックし、[Select Manifest] ボタンをクリックして更新したアプリケーションマニフェストを選択すると、配置マニフェストを更新できます。