次の方法で共有


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

ClickOnce の配置によって、ClickOnce アプリケーションを実行するためにクライアント コンピューターに必要な数々の必須コンポーネントを調べることができます。 たとえば、最低限必要な .NET Framework のバージョン、オペレーティング システムのバージョン、およびグローバル アセンブリ キャッシュ (GAC) に事前にインストールしておく必要があるアセンブリなどです。 ただし、ClickOnce ではその必須コンポーネント自体をインストールすることができません。必須コンポーネントが見つかった場合、インストールを停止し、インストールが失敗した理由を説明するダイアログ ボックスを表示するのみです。

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

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

      <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 を使用したマニフェストへの再署名の詳細については、「方法: アプリケーション マニフェストおよび配置マニフェストに再署名する」を参照してください。

セキュリティ

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

参照

処理手順

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

参照

Mage.exe (マニフェストの生成および編集ツール)

概念

ClickOnce と Authenticode

アプリケーション配置の必要条件

その他の技術情報

<compatibleFrameworks> 要素 (ClickOnce 配置)