パブリッシャーの構成

[アーティクル]
06/13/2023

パブリッシャー構成ファイルは、同じアセンブリの別のバージョンを使用するために、サイドバイサイドアセンブリの 1 つのバージョンに依存するアプリケーションとアセンブリをグローバルにリダイレクトします。これにより、アプリケーションとアセンブリは、影響を受けるすべてのアプリケーションを再構築することなく、更新されたアセンブリを使用できます。

互換性のあるバグ修正またはセキュリティ更新プログラムを使用して新しいバージョンのアセンブリを発行するときに、アセンブリの発行元が発行元の構成ファイルを提供できます。更新されたバージョンは完全に下位互換性がある必要があります。更新プログラムが完全に下位互換性がある場合を除き、パブリッシャー構成ファイルを使用して新機能を追加しないでください。アセンブリのメジャーバージョンまたはマイナーバージョンをインクリメントするために、パブリッシャー構成ファイルを使用しないでください。たとえば、アセンブリバージョン 6.0.0.0 を 7.0.0.0 または 6.1.0.0 にリダイレクトしないでください。

パブリッシャー構成ファイルは、アセンブリの発行元のみが発行する必要があります。アセンブリ開発者は、共有サイドバイサイドアセンブリとパブリッシャー構成ファイルに署名する必要があります。同じキーを使用して、アセンブリと関連付けられているパブリッシャー構成ファイルに署名します。パブリッシャー構成ファイルは、アセンブリに使用するのと同じツールを使用して署名する必要があります。「アセンブリ署名の例」および「署名済みファイルとカタログの作成」を参照してください。

通常、アセンブリの新しいバージョンと関連付けられているパブリッシャー構成ファイルは、Service Pack の更新プログラムにインストールされます。パブリッシャー構成ファイルをインストールすると、システム上のアセンブリがグローバルにリダイレクトされるため、パブリッシャー構成ファイルを再頒布可能パッケージとしてアプリケーションに提供しないでください。更新するアセンブリが再頒布可能パッケージとして提供されている場合、発行元は次の両方を提供する必要があります。

発行元の構成を含む新しいバージョンのアセンブリを含む Windows インストーラーパッケージ (.msi ファイル)。これは、サービスパックまたは QFE としてインストールされる可能性があります。この場合、お客様はシステムをグローバルに更新することを選択しているためです。このバージョンのパッケージは、アプリケーションでインストールしないでください。
新しいバージョンのアセンブリのみを含む Windows インストーラーマージモジュール (.msm ファイル)。このバージョンは、アプリケーションに含まれる場合があります。

アセンブリの最小バージョンを必要とするアプリケーションでは、最小バージョンへの依存関係を示す必要があります。最小バージョンがシステムで使用できない場合、アプリケーションの起動に失敗します。再頒布可能パッケージとして使用できる場合は、アプリケーションのセットアップに含める必要があります。

たとえば、次のパブリッシャー構成ファイルをインストールすると、Microsoft.Windows.SampleAssembly のバージョン 2.0.0.0 からバージョン 2.0.1.0 にバインドがリダイレクトされます。これにより、%systemDrive%\windows\winsxs\policies\x86_policy.2.0.Microsoft.Windows.SampleAssembly_75e377300ab7b886_x-ww_hashvalue の下に、1.1.0.0.Policy という名前の新しいポリシーが<追加されます>。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <assemblyIdentity type="win32-policy" publicKeyToken="0000000000000000" name="policy.2.0.Microsoft.Windows.SampleAssembly" version="1.1.0.0" processorArchitecture="x86"/>
   <dependency>
      <dependentAssembly>
         <assemblyIdentity type="win32" name="Microsoft.Windows.SampleAssembly"  processorArchitecture="x86" publicKeyToken="75e377300ab7b886"/>
         <bindingRedirect oldVersion="2.0.0.0" newVersion="2.0.1.0"/>
      </dependentAssembly>
   </dependency>
</assembly>

同じアセンブリに対して次のパブリッシャー構成ファイルをインストールすると、Microsoft.Windows.SampleAssembly のバージョン 2.0.0.0 からバージョン 2.0.3.0 にバインドがリダイレクトされます。これにより、%systemDrive%\windows\winsxs\policies\x86_policy.2.0.Microsoft.Windows.SampleAssembly_75e377300ab7b886_x-ww_<hashvalue の下に、2.1.0.0.Policy という名前の別のポリシーが追加されます>。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
   <assemblyIdentity type="win32-policy" publicKeyToken="0000000000000000" name="policy.2.0.Microsoft.Windows.SampleAssembly" version="2.1.0.0" processorArchitecture="x86"/>
   <dependency>
      <dependentAssembly>
         <assemblyIdentity type="win32" name="Microsoft.Windows.SampleAssembly"  processorArchitecture="x86" publicKeyToken="75e377300ab7b886"/>
         <bindingRedirect oldVersion="2.0.0.0" newVersion="2.0.3.0"/>
      </dependentAssembly>
   </dependency>
</assembly>

次の方法で共有

パブリッシャーの構成

フィードバック

その他のリソース