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

  • [アーティクル]

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

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

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

個々の前提条件のサポート 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 はダイアログ ボックスに表示されません。

関連するコンテンツ