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

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 というフォルダーに移動されます。 以前のバージョンがこのようにアーカイブされることで、インストール ディレクトリが以前のバージョンのフォルダーから分離されます。

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

  2. [発行] タブをクリックします。

  3. [発行場所] フィールドに、次の形式のいずれかを使用して、発行場所を入力します。

    • ファイル共有またはディスク パスを発行するには、UNC パス (\\Server\ApplicationName) またはファイル パス (C:\Deploy\ApplicationName) のいずれかを使用して、パスを入力します。

    • FTP サーバーを発行するには、ftp://ftp.microsoft.com/<ApplicationName> という形式を使用して、パスを入力します。

      [発行場所] ボックスでは、テキストは参照 [...] ボタンが機能する順番で並んでいる必要があります。

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

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

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

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

Note

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

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

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

  2. [発行] タブをクリックします。

  3. [インストール URL] フィールドに、形式 https://www.contoso.com/ApplicationName を使用する完全修飾 URL を使用して、または形式 \Server\ApplicationName を使用する UNC パスを使用して、インストールの場所を入力します。

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

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

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

Note

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

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

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

  2. [発行] タブをクリックします。

  3. [インストールモードと設定] 領域で、[アプリケーションはオンラインでのみ利用できる] オプション ボタンをクリックします。

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

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

  2. [発行] タブをクリックします。

  3. [インストールモードと設定] 領域で、[アプリケーションはオフラインでも利用できる] オプション ボタンをクリックします。

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

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

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

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

Note

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

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

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

  2. [発行] タブをクリックします。

  3. [発行するバージョン] フィールドで、[メジャー][マイナー][ビルド]、または [リビジョン] のバージョン番号をインクリメントします。

    Note

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

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

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

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

Note

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

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

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

  2. [発行] タブをクリックします。

  3. [バージョンの発行] セクションで、[リリースごとにリビジョンを自動的に追加する] チェックボックスをオフにします。

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

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

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

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

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

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

  2. [発行] ペインを選択します。

  3. [オプション] ボタンをクリックして、[発行オプション] ダイアログ ボックスを開きます。

  4. [デプロイ] をクリックします。

  5. [発行オプション] ダイアログ ボックスで、[公開後に配置 Web ページを開く] チェック ボックスがオンになっていることを確認します (既定ではオンになっています)。

  6. [配置 Web ページ] ボックスに、Web ページの名前を入力し、[OK] をクリックします。

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

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

  2. [発行] ペインを選択します。

  3. [オプション] ボタンをクリックして、[発行オプション] ダイアログ ボックスを開きます。

  4. [デプロイ] をクリックします。

  5. [発行オプション] ダイアログ ボックスで、[公開後に配置 Web ページを開く] チェック ボックスをオフにします。

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

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

Note

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

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

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

Note

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

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

  1. ClickOnce アプリケーションを Web の場所に発行します。 詳細については、「方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する」を参照してください。

  2. Web サーバーで、Visual Web Designer または他の HTML エディターで Publish.htm ファイルを開きます。

  3. 必要に応じてページをカスタマイズして保存します。

  4. 省略可能。 カスタマイズされた Web 発行ページが Visual Studio によって上書きされないようにするには、[発行オプション] ダイアログ ボックスで [発行後に毎回配置 Web ページを自動的に生成する] チェック ボックスをオフにします。

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

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

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

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

  2. [発行] タブをクリックします。

  3. [オプション] ボタンをクリックして、[発行オプション] ダイアログ ボックスを開きます。

  4. [説明] をクリックします。

  5. [サポート URL] フィールドに、Web サイト、Web ページ、または UNC 共有の完全修飾パスを入力します。

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

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

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

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

Note

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

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

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

  2. オペレーティング システムに関する前提条件の場合、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>
    
  3. 特定のバージョンの共通言語ランタイムに関する前提条件の場合は、共通言語ランタイムの依存関係を指定する 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>
    
  4. グローバル アセンブリ キャッシュにプレインストールする必要があるアセンブリに関する前提条件の場合は、必要なアセンブリを指定する 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>
    
  5. 省略可能。 .NET Framework 4 を対象とするアプリケーションの場合は、ClickOnce アプリケーションの配置マニフェスト (.application ファイル) をテキスト エディターで開きます。

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

.NET Framework のセキュリティ

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

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

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

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

Note

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

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

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

  2. [発行] タブをクリックします。

    Note

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

  3. [オプション] ボタンをクリックして、[発行オプション] ダイアログ ボックスを開きます。

  4. [説明] をクリックします。

  5. [発行オプション] ダイアログ ボックスで、[発行言語] ドロップダウン リストから言語とカルチャを選択し、[OK] をクリックします。

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

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

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

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

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

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

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

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

  2. [発行] タブをクリックします。

  3. [オプション] ボタンをクリックして、[発行オプション] ダイアログ ボックスを開きます。

  4. [説明] をクリックします。

  5. [発行オプション] ダイアログ ボックスで、表示する名前を [製品名] に入力します。

  6. 必要に応じて、[パブリッシャー名] にパブリッシャー名を入力できます。

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

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

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

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

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

  2. [発行] タブをクリックします。

  3. [オプション] ボタンをクリックします。

    [発行オプション] ダイアログ ボックスが表示されます。

  4. [デプロイ] をクリックします。

  5. [CD からインストールする場合、CD が挿入されるときにセットアップを自動的に開始する] チェック ボックスをオンにします。

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