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

  • [アーティクル]

更新 : 2007 年 11 月

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

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

Visual Studio、Mage.exe、および MageUI.exe は、いずれも ClickOnce 配置を生成するために使用できますが、どのツールも個々の必要条件に対するサポート URL の指定は直接サポートしていません。ここでは、これらのサポート URL を組み込むように、配置のアプリケーション マニフェストを変更する方法について説明します。

個々の必要条件に対するサポート URL の指定

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

  2. オペレーティング システムの必要条件に関しては、supportUrl 属性を dependentOS 要素に追加します。

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

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

      <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.40607.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. アプリケーション マニフェストを手動で変更した後に、デジタル証明書を使用してアプリケーション マニフェストに再署名し、さらに配置マニフェストも再生成および再署名する必要があります。Visual Studio を使用してこれらのファイルを再生成すると手動での変更が消去されるため、この作業には Mage.exe または MageUI.exe のいずれかの SDK ツールを使用する必要があります。MageUI.exe を使用したマニフェストの署名と生成の詳細については、「マニフェストの生成および編集ツール (Mage.exe)」および「チュートリアル : ClickOnce アプリケーションを手動で配置する」を参照してください。

セキュリティ

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

参照

概念

ClickOnce の配置と Authenticode

ClickOnce の配置の概要