ClickOnce 発行プロパティを指定する

[アーティクル]
07/02/2024

ClickOnce 発行プロパティは、プロジェクトデザイナーの [発行]ページで、または発行ウィザードを使用して構成できます。この記事では、発行場所、インストール URL、オンラインまたはオフラインインストールモード、発行バージョンなどのプロパティを指定する方法について説明します。

Note

.NET Core 3.1 および .NET 5 以降の ClickOnce では、発行ウィザードやプロジェクトデザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。詳細については、ClickOnce を使用した .NET Windows アプリケーションの配置と .NET 用 ClickOnce に関するページを参照してください。

発行場所を指定する

ClickOnce を使用してアプリケーションを発行する場合、Publish Location プロパティによってアプリケーションファイルとマニフェストが配置される場所が指定されます。これには、ファイルパスまたは FTP サーバーへのパスを指定できます。

[プロジェクトデザイナー] の [発行] ページで、または、発行ウィザードを使用して Publish Location プロパティを指定することができます。詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。

Note

ClickOnce を使用してアプリケーションの複数のバージョンをインストールすると、以前のバージョンのアプリケーションは、指定した発行場所の Archive というフォルダーに移動されます。以前のバージョンがこのようにアーカイブされることで、インストールディレクトリが以前のバージョンのフォルダーから分離されます。

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。
[発行場所] フィールドに、次の形式のいずれかを使用して、発行場所を入力します。
- ファイル共有またはディスクパスを発行するには、UNC パス (\\Server\ApplicationName) またはファイルパス (C:\Deploy\ApplicationName) のいずれかを使用して、パスを入力します。
- FTP サーバーを発行するには、ftp://ftp.microsoft.com/<ApplicationName> という形式を使用して、パスを入力します。
  
  [発行場所] ボックスでは、テキストは参照 [...] ボタンが機能する順番で並んでいる必要があります。

エンドユーザーがインストールを開始する場所を指定する

ClickOnce アプリケーションを発行する場合、ユーザーがアプリケーションをダウンロードしてインストールする場所は、必ずしもアプリケーションが最初に発行される場所とは限りません。たとえば、一部の組織では、開発者がアプリケーションをステージングサーバーに発行した後、管理者がアプリケーションを Web サーバーに移動する場合があります。

この場合、Installation URL プロパティを使用して、ユーザーがアプリケーションをダウンロードするためにアクセスする Web サーバーを指定できます。これは、アプリケーションマニフェストが更新プログラムを検索する場所を認識するために必要です。

Installation URL プロパティは、プロジェクトデザイナーの [発行] ページで設定できます。

Note

Installation URL プロパティは、発行ウィザードを使用して設定することもできます。詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。

インストール URL を指定する

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。
[インストール URL] フィールドに、形式 https://www.contoso.com/ApplicationName を使用する完全修飾 URL を使用して、または形式 \Server\ApplicationName を使用する UNC パスを使用して、インストールの場所を入力します。

ClickOnce のオフラインまたはオンラインのインストールモードを指定する

ClickOnce アプリケーションの Install Mode は、アプリケーションがオフラインまたはオンラインで利用できるかどうかを決定します。 [アプリケーションをオンラインでのみ利用できる] を選択した場合、ユーザーはアプリケーションを実行するために、ClickOnce 発行場所 (Web ページまたはファイル共有) にアクセスできる必要があります。 [アプリケーションはオフラインでも利用できる] を選択すると、アプリケーションによってエントリが [スタート] メニューと [プログラムの追加と削除] ダイアログボックスに追加されます。ユーザーは、接続されていないときにアプリケーションを実行できます。

Install Mode は、プロジェクトデザイナーの [発行] ページで設定できます。

Note

Install Mode は、発行ウィザードを使用して設定することもできます。詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。

ClickOnce アプリケーションをオンラインでのみ利用できるようにする

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。
[インストールモードと設定] 領域で、[アプリケーションはオンラインでのみ利用できる] オプションボタンをクリックします。

ClickOnce アプリケーションをオンラインまたはオフラインで利用できるようにするには

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。
[インストールモードと設定] 領域で、[アプリケーションはオフラインでも利用できる] オプションボタンをクリックします。

アプリケーションをインストールすると、[スタート] メニューと [コントロールパネル] の [プログラムの追加と削除] にエントリが追加されます。

ClickOnce の発行バージョンを設定する

ClickOnce の Publish Version プロパティでは、発行するアプリケーションを更新プログラムとして扱うかどうかを指定します。バージョンがインクリメントされるたびに、アプリケーションは更新プログラムとして発行されます。

Publish Version プロパティは、プロジェクトデザイナーの [発行] ページで設定できます。

Note

アプリケーションが発行されるたびに Publish Version プロパティが自動的にインクリメントされるプロジェクトオプションがあります。このオプションは既定で有効になっています。詳細については、「ClickOnce の発行バージョンを自動的にインクリメントする」を参照してください。

発行バージョンを変更する

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ]をクリックします。
[発行] タブをクリックします。
[発行するバージョン] フィールドで、[メジャー]、[マイナー]、[ビルド]、または [リビジョン] のバージョン番号をインクリメントします。

Note

バージョン番号をデクリメントしないでください。これを行うと、予期しない更新動作が発生する可能性があります。

ClickOnce の発行バージョンを自動的にインクリメントする

ClickOnce アプリケーションを発行するとき、Publish Version プロパティを変更すると、そのアプリケーションは更新プログラムとして発行されます。 Visual Studio では既定で、アプリケーションを発行するたびに Publish Version の Revision 番号が自動的にインクリメントされます。

この動作は、プロジェクトデザイナーの [発行] ページで無効にできます。

Note

実際に画面に表示されるダイアログボックスとメニューコマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。設定を変更するには、 [ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「リセット設定」を参照してください。

発行バージョンの自動インクリメントを無効にする

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。
[バージョンの発行] セクションで、[リリースごとにリビジョンを自動的に追加する] チェックボックスをオフにします。

ClickOnce アプリケーションの発行ページを指定する

ClickOnce アプリケーションを発行すると、既定の Web ページ (publish.htm) が生成され、アプリケーションと共に発行されます。このページには、アプリケーションの名前、アプリケーションをインストールするためのリンクやすべての前提条件、および ClickOnce を説明するヘルプトピックへのリンクが含まれます。プロジェクトの 発行ページ プロパティを使うと、ClickOnce アプリケーションの Web ページの名前を指定できます。

発行ページが指定されると、次回の発行時、その発行場所にコピーされます。再び発行する場合は、上書きされません。ページの外観をカスタマイズする場合、変更内容が失われることを心配せずに行うことができます。詳細については、「ClickOnce の既定の Web ページをカスタマイズする」を参照してください。

[発行ページ] プロパティは、プロジェクトデザイナーの [発行] ペインからアクセスできる [発行オプション] ダイアログボックスで設定できます。

ClickOnce アプリケーションの発行ページを指定するには:

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ]をクリックします。
[発行] ペインを選択します。
[オプション] ボタンをクリックして、[発行オプション] ダイアログボックスを開きます。
[デプロイ] をクリックします。
[発行オプション] ダイアログボックスで、[公開後に配置 Web ページを開く] チェックボックスがオンになっていることを確認します (既定ではオンになっています)。
[配置 Web ページ] ボックスに、Web ページの名前を入力し、[OK] をクリックします。

発行するたびに発行ページが起動されないようにするには:

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ]をクリックします。
[発行] ペインを選択します。
[オプション] ボタンをクリックして、[発行オプション] ダイアログボックスを開きます。
[デプロイ] をクリックします。
[発行オプション] ダイアログボックスで、[公開後に配置 Web ページを開く] チェックボックスをオフにします。

ClickOnce アプリケーションの既定の Web ページをカスタマイズする

ClickOnce アプリケーションを Web に発行すると、Web ページが自動的に生成され、アプリケーションと共に発行されます。既定のページには、アプリケーションの名前、およびアプリケーションをインストールする、前提条件をインストールする、または MSDN 上のヘルプへアクセスするためのリンクが含まれます。

Note

ページに表示される実際のリンクは、ページが表示されているコンピューターと、含める前提条件によって異なります。

Web ページの既定の名前は Publish.htm です。プロジェクトデザイナーで名前を変更できます。詳細については、「ClickOnce アプリケーションの発行ページを指定する」を参照してください。

Publish.htm Web ページは、新しいバージョンが検出された場合にのみ発行されます。

Note

発行設定に加えた変更は、Publish.htmページに影響しませんが、1 つ例外があります。最初の発行後に前提条件を追加または削除した場合、前提条件の一覧は正確ではなくなります。変更内容を反映するには、前提条件リンクのテキストを編集する必要があります。

Web の発行ページをカスタマイズするには:

ClickOnce アプリケーションを Web の場所に発行します。詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。
Web サーバーで、Visual Web Designer または他の HTML エディターで Publish.htm ファイルを開きます。
必要に応じてページをカスタマイズして保存します。
省略可能。カスタマイズされた Web 発行ページが Visual Studio によって上書きされないようにするには、[発行オプション] ダイアログボックスで [発行後に毎回配置 Web ページを自動的に生成する] チェックボックスをオフにします。

テクニカルサポートのリンクを指定する

ClickOnce アプリケーションを公開するとき、[サポート URL] プロパティで、ユーザーがアプリケーションに関する情報を取得できる Web ページまたはファイル共有を特定します。このプロパティは省略可能です。指定されている場合、URL は [プログラムの追加と削除] ダイアログボックスでアプリケーションのエントリに表示されます。

[サポート URL] プロパティは、プロジェクトデザイナーの [発行] ページで設定できます。

サポート URL を指定するには:

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。
[オプション] ボタンをクリックして、[発行オプション] ダイアログボックスを開きます。
[説明] をクリックします。
[サポート URL] フィールドに、Web サイト、Web ページ、または UNC 共有の完全修飾パスを入力します。

ClickOnce 配置で個々の必要条件にサポート URL を指定する

ClickOnce アプリケーションが実行するためにクライアントコンピューターで利用できる必要があるいくつかの前提条件を、ClickOnce 配置でテストできます。これらの依存関係には、最低限必要な .NET Framework のバージョン、オペレーティングシステムのバージョン、およびグローバルアセンブリキャッシュ (GAC) にプレインストールされている必要があるすべてのアセンブリが含まれます。ただし、これらの前提条件自体を ClickOnce でインストールすることはできません。前提条件が見つからない場合は、単にインストールが停止され、インストールが失敗した理由を説明するダイアログボックスが表示されます。

前提条件をインストールするには 2 つの方法があります。ブートストラッパーアプリケーションを使用してインストールできます。または、個々の前提条件のサポート URL を指定することもできます。これは、前提条件が見つからない場合に、ダイアログボックスでユーザーに表示されます。その URL によって参照されるページには、必要な前提条件をインストールするための説明へのリンクを含めることができます。アプリケーションで個々の前提条件のサポート URL が指定されていない場合、配置マニフェストでアプリケーション全体に対するサポート URL が指定されていれば、ClickOnce によってそれが表示されます。

Visual Studio、Mage.exe、MageUI.exe はすべて、ClickOnce 配置を生成するために使用できますが、これらのどのツールでも、個々の前提条件のサポート URL を直接指定することはできません。このドキュメントでは、配置のアプリケーションマニフェストと配置マニフェストを変更して、これらのサポート URL を含める方法について説明します。

Note

個々の前提条件のサポート URL を指定する

ClickOnce アプリケーションのアプリケーションマニフェスト (.manifest ファイル) を、テキストエディターで開きます。

オペレーティングシステムに関する前提条件の場合、supportUrl 属性を dependentOS 要素に追加します。

 <dependency>
    <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
      <osVersionInfo>
        <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>

特定のバージョンの共通言語ランタイムに関する前提条件の場合は、共通言語ランタイムの依存関係を指定する dependentAssembly エントリに supportUrl 属性を追加します。

  <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
    </dependentAssembly>
  </dependency>

グローバルアセンブリキャッシュにプレインストールする必要があるアセンブリに関する前提条件の場合は、必要なアセンブリを指定する dependentAssembly 要素に supportUrl を設定します。

  <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
      <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
    </dependentAssembly>
  </dependency>

省略可能。 .NET Framework 4 を対象とするアプリケーションの場合は、ClickOnce アプリケーションの配置マニフェスト (.application ファイル) をテキストエディターで開きます。

.NET Framework 4 の前提条件の場合は、supportUrl 属性を compatibleFrameworks 要素に追加します。

<compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
  <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
  <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
</compatibleFrameworks>

アプリケーションマニフェストを手作業で変更したら、デジタル証明書を使用してアプリケーションマニフェストに再署名してから、配置マニフェストも更新して再署名する必要があります。 Visual Studio を使用してこれらのファイルを再生成すると手作業による変更が消去されるので、このタスクを実行するには、Mage.exe または MageUI.exe SDK ツールを使用します。 Mage.exe を使用してマニフェストに再署名する方法の詳細については、「方法: アプリケーションマニフェストおよび配置マニフェストに再署名する」を参照してください。

.NET Framework のセキュリティ

アプリケーションが部分信頼で実行するようにマークされている場合、サポート URL はダイアログボックスに表示されません。

ClickOnce アプリケーションの発行言語を変更する

ClickOnce アプリケーションを公開する場合、インストール中に表示されるユーザーインターフェイスは、デフォルトで開発用コンピューターの言語とカルチャになります。ローカライズされたアプリケーションを発行する場合、ローカライズされたバージョンと一致する言語とカルチャを指定する必要があります。これは、プロジェクトの Publish language プロパティによって決定されます。

Publish language プロパティは、プロジェクトデザイナーの [発行] ページからアクセスできる [発行オプション] ダイアログボックスで設定できます。

Note

発行言語を変更するには:

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。

Note

.NET Core 3.1 および .NET 5 以降の ClickOnce では、発行ウィザードやプロジェクトデザイナーの [発行] ページではなく、発行ツールを使用して配置プロパティを設定します。詳細については、ClickOnce を使用した .NET Windows アプリケーションの配置と .NET 用 ClickOnce に関するページを参照してください。
[オプション] ボタンをクリックして、[発行オプション] ダイアログボックスを開きます。
[説明] をクリックします。
[発行オプション] ダイアログボックスで、[発行言語] ドロップダウンリストから言語とカルチャを選択し、[OK] をクリックします。

ClickOnce アプリケーションがオンラインとオフラインの両方で使用するようにインストールされると、[スタート] メニューと [プログラムの追加と削除] の一覧にエントリが追加されます。既定では、表示名はアプリケーションアセンブリの名前と同じですが、[発行オプション] ダイアログボックスの [製品名] を設定して表示名を変更できます。

[製品名] は publish.htm ページに表示されます。インストール済みのオフラインアプリケーションの場合は、[スタート] メニューのエントリの名前になり、[プログラムの追加と削除] に表示される名前にもなります。

[パブリッシャー名] は publish.htm ページで [製品名] の上部に表示されます。インストール済みのオフラインアプリケーションの場合は、[スタート] メニュー内のアプリケーションのアイコンが含まれるフォルダーの名前にもなります。

[スタート] メニューのショートカットまたはアプリケーション参照は、%appdata%\Microsoft\Windows\Start Menu\Programs\<publisher name> で作成されます。ショートカットまたはアプリケーション参照には、製品名と同じ名前が付けられます。

[発行オプション] ダイアログボックスでは、[製品名] プロパティと [パブリッシャー名] プロパティを設定できます。このダイアログボックスは、プロジェクトデザイナーの [発行] ページにあります。

スタートメニューの名前を指定するには:

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ] をクリックします。
[発行] タブをクリックします。
[オプション] ボタンをクリックして、[発行オプション] ダイアログボックスを開きます。
[説明] をクリックします。
[発行オプション] ダイアログボックスで、表示する名前を [製品名] に入力します。
必要に応じて、[パブリッシャー名] にパブリッシャー名を入力できます。

CD インストールの自動開始を有効にする

CD-ROM や DVD-ROM などのリムーバブルメディアを使用して ClickOnce アプリケーションを配置する場合、AutoStart を有効にして、メディアが挿入されたときに ClickOnce アプリケーションが自動的に起動されるようにすることができます。

AutoStart は、プロジェクトデザイナーの [発行] ページで設定できます。

自動開始を有効にするには:

ソリューションエクスプローラーでプロジェクトを選択し、 [プロジェクト] メニューの [プロパティ]をクリックします。
[発行] タブをクリックします。
[オプション] ボタンをクリックします。

[発行オプション] ダイアログボックスが表示されます。
[デプロイ] をクリックします。
[CD からインストールする場合、CD が挿入されるときにセットアップを自動的に開始する] チェックボックスをオンにします。

アプリケーションが発行されると、Autorun.inf ファイルが発行場所にコピーされます。

次の方法で共有

ClickOnce 発行プロパティを指定する

発行場所を指定する

エンドユーザーがインストールを開始する場所を指定する

インストール URL を指定する

ClickOnce のオフラインまたはオンラインのインストールモードを指定する

ClickOnce アプリケーションをオンラインでのみ利用できるようにする

ClickOnce アプリケーションをオンラインまたはオフラインで利用できるようにするには

ClickOnce の発行バージョンを設定する

発行バージョンを変更する

ClickOnce の発行バージョンを自動的にインクリメントする

発行バージョンの自動インクリメントを無効にする

ClickOnce アプリケーションの発行ページを指定する

ClickOnce アプリケーションの既定の Web ページをカスタマイズする

テクニカルサポートのリンクを指定する

ClickOnce 配置で個々の必要条件にサポート URL を指定する

個々の前提条件のサポート URL を指定する

.NET Framework のセキュリティ

ClickOnce アプリケーションの発行言語を変更する

ClickOnce アプリケーションのスタートメニューの名前を指定する

CD インストールの自動開始を有効にする

フィードバック

その他のリソース

次の方法で共有

ClickOnce 発行プロパティを指定する

発行場所を指定する

エンド ユーザーがインストールを開始する場所を指定する

インストール URL を指定する

ClickOnce のオフラインまたはオンラインのインストール モードを指定する

ClickOnce アプリケーションをオンラインでのみ利用できるようにする

ClickOnce アプリケーションをオンラインまたはオフラインで利用できるようにするには

ClickOnce の発行バージョンを設定する

発行バージョンを変更する

ClickOnce の発行バージョンを自動的にインクリメントする

発行バージョンの自動インクリメントを無効にする

ClickOnce アプリケーションの発行ページを指定する

ClickOnce アプリケーションの既定の Web ページをカスタマイズする

テクニカル サポートのリンクを指定する

ClickOnce 配置で個々の必要条件にサポート URL を指定する

個々の前提条件のサポート URL を指定する

.NET Framework のセキュリティ

ClickOnce アプリケーションの発行言語を変更する

ClickOnce アプリケーションのスタート メニューの名前を指定する

CD インストールの自動開始を有効にする

関連するコンテンツ

フィードバック

その他のリソース

エンドユーザーがインストールを開始する場所を指定する

ClickOnce のオフラインまたはオンラインのインストールモードを指定する

テクニカルサポートのリンクを指定する

ClickOnce アプリケーションのスタートメニューの名前を指定する