C/C++ side-by-side アセンブリのビルド

[アーティクル]
04/03/2023

side-by-side アセンブリは、DLL のグループ、ウィンドウクラス、COM サーバー、タイプライブラリ、インターフェイスなどのリソースのコレクションで、実行時にアプリケーションで使用できます。アセンブリに DLL を再パッケージ化する主な利点は、複数のバージョンのアセンブリをアプリケーションで同時に使用できることと、更新プログラムのリリース時に現在インストールされているアセンブリに対してサービスを提供できることです。

C++ アプリケーションでは、アプリケーションのさまざまな部分で 1 つまたは複数の DLL を使用できます。実行時には、DLL がメインプロセスに読み込まれ、必要なコードが実行されます。アプリケーションは、要求された DLL を検索し、読み込む必要がある他の依存 DLL を認識して、要求された DLL と一緒に読み込む際に、オペレーティングシステムに依存しています。 Windows XP、Windows Server 2003、および Windows Vista より前のバージョンの Windows オペレーティングシステムでは、オペレーティングシステムローダーにより、アプリケーションのローカルフォルダー、またはシステムパスで指定された別のフォルダーで依存 DLL が検索されます。 Windows XP、Windows Server 2003、および Windows Vista では、オペレーティングシステムローダーにより、マニフェストファイルを使用して依存 DLL を検索し、これらの DLL を含む side-by-side アセンブリを検索することもできます。

既定では、Visual Studio を使用してビルドされた DLL には、ID = 2 の RT_MANIFEST リソースとしてアプリケーションマニフェストが埋め込まれています。実行可能ファイルの場合と同様に、このマニフェストには、他のアセンブリに対するこの DLL の依存関係が記述されています。これは、DLL が side-by-side アセンブリに含まれておらず、この DLL に依存しているアプリケーションがその読み込みにアプリケーションマニフェストを使用する代わりに、オペレーティングシステムローダーに依存して、システムパスでこの DLL を検索することを前提としています。

Note

アプリケーションマニフェストを使用する DLL には、ID = 2 のリソースとしてマニフェストを埋め込む必要があります。 DLL が実行時に動的に読み込まれる場合 (たとえば、LoadLibrary 関数を使用する場合)、オペレーティングシステムローダーでは、DLL のマニフェストに指定されている依存アセンブリが読み込まれます。 DLL の外部アプリケーションマニフェストは、LoadLibrary の呼び出し中にはチェックされません。マニフェストが埋め込まれていない場合、ローダーでは、不正なバージョンのアセンブリを読み込もうとしたり、依存アセンブリが見つからなかったりすることがあります。

1 つまたは複数の関連 DLL を、対応するアセンブリマニフェストと共に side-by-side アセンブリに再パッケージ化できます。このマニフェストには、アセンブリを形成するファイルと、他の side-by-side アセンブリに対するアセンブリの依存関係が記述されています。

Note

アセンブリに 1 つの DLL が含まれている場合は、この DLL に ID = 1 のリソースとしてアセンブリマニフェストを埋め込み、プライベートアセンブリに DLL と同じ名前を付けることをお勧めします。たとえば、DLL の名前が mylibrary.dll の場合、マニフェストの <assemblyIdentity> 要素で使用されている name 属性の値にも、mylibrary を指定できます。場合によっては、ライブラリに .dll 以外の拡張子が付いている (たとえば、MFC ActiveX コントロールプロジェクトでは .ocx ライブラリが作成される) と、外部アセンブリマニフェストを作成できます。この場合、アセンブリとそのマニフェストの名前は DLL の名前と異なる必要があります (たとえば、MyAssembly、MyAssembly.manifest、mylibrary.ocx)。ただし、このようなライブラリの名前を変更して拡張子 .dll を付加し、マニフェストをリソースとして埋め込んで、このアセンブリの将来のメンテナンスコストを削減することをお勧めします。オペレーティングシステムでプライベートアセンブリを検索する方法の詳細については、「アセンブリの検索手順」を参照してください。

この変更により、対応する DLL をプライベートアセンブリとしてアプリケーションのローカルフォルダーに配置したり、共有アセンブリとして WinSxS アセンブリキャッシュに配置したりできます。この新しいアセンブリの適切な実行時動作を実現するために、いくつかの手順に従う必要があります。これらについては、「side-by-side アセンブリを作成するためのガイドライン」を参照してください。アセンブリが正しく作成されると、共有アセンブリまたはプライベートアセンブリとして、それに依存するアプリケーションと共に配置できます。 side-by-side アセンブリを共有アセンブリとしてインストールする場合は、「Windows XP での side-by-side 共有のための Win32 アセンブリのインストール」に記載されているガイドラインに従うか、またはマージモジュールを使用することができます。 side-by-side アセンブリをプライベートアセンブリとしてインストールする場合は、インストールプロセスの一部として、対応する DLL、リソース、およびアセンブリマニフェストをターゲットコンピューター上のアプリケーションローカルフォルダーにコピーするだけで、このアセンブリが実行時にローダーによって検出されるようにすることができます (「アセンブリ検索シーケンス」を参照してください)。もう 1 つの方法としては、Windows インストーラーを使用し、「Windows XP でアプリケーションをプライベートに使用するための Win32 アセンブリのインストール」に記載されているガイドラインに従ってください。

次の方法で共有

C/C++ side-by-side アセンブリのビルド

関連項目

フィードバック

その他のリソース