「AnyCPUのモジュールからx86とx64のモジュールを呼び分ける」の版間の差分

提供:MochiuWiki : SUSE, EC, PCB
ナビゲーションに移動 検索に移動
編集の要約なし
 
1行目: 1行目:
== 概要 ==
== 概要 ==
C#には、実行環境が32bitや64bitを問わず、適切なモードで実行できるAnyCPUという仕組みが存在する。<br>
C#では、実行環境のアーキテクチャがx86 / AMD64に関わらず、適切なモードで実行できるAnyCPUという仕組みが存在する。<br>
しかし、この機能は実行時まで32bitまたは64bitのどちらで動作するかは不明なので、<br>
<br>
AnyCPUをサポートしていない言語、例えばC/C++言語やC++CLI言語で作成したDLLを使用する場合、DllImportとの相性が悪い。<br>
しかし、AnuCPUは実行時までx86 / AMD64のどちらで動作するかは不明である。<br>
なぜなら、DllImportはコンパイル時にDLLの読み込みパスを指定するため、<br>
そのため、AnyCPUをサポートしていない言語、例えば、C/C++言語やC++/CLI言語で開発されたライブラリを使用する場合、<code>DllImport</code>キーワードとの相性が悪い。<br>
実行時に”32bitだったらこのDLL、64bitだったらこのDLL”ということが出来ない。<br><br>
<br>
このような場合、どのような解決策を使うにせよ、何らかの制約を強いられることになる。
なぜなら、<code>DllImport</code>キーワードはコンパイル時にライブラリの読み込みパスを指定するため、実行時において、x86 / AMD64ごとにライブラリを切り替えることができない。<br>
いくつかある解決策の長所および短所を以下に纏めた。<br><br>
<br>
このような場合、どのような解決策を使うにせよ、何らかの制約を強いられることになる。<br>
<br><br>


== すべてのモジュールを32bitで固定する方法 ==
== 全てのモジュールをx86に固定する方法 ==
C#側を32bitに固定することで、常に32bitのDLLを使用する方法。<br><br>
C#側の実行ファイルをx86に指定することにより、常にx86のライブラリを使用する方法である。<br>
 
<br>
* '''長所:一番単純で、最低限の変更で済む。'''
* メリット
* '''短所:64bitOSの長所(大量のメモリが使用できて一部の処理が高速化する)を活かせない。'''
*: 最も簡単であり、最低限の変更で済む。
* デメリット
*: 64ビットOSのメリット (多くのメモリが使用でき、一部の処理が高速化する) を活かせない。
<br><br>
<br><br>


== C#側のモジュールも32bitと64bitを別々に用意する方法 ==
== C#側のモジュールもx86 / AMD64を別々に用意する方法 ==
すべてのモジュールに対して32bitと64bitを別々に作る方法。<br>
全てのモジュールに対して、x86 / AMD64を別々に開発する方法である。<br>
最初に起動するexeファイルが32bitまたは64bitでのビルドになっていれば、それ以降に読み込まれるAnyCPUのDLLもそれに応じて動作するため、<br>
<br>
AnyCPUなDLLが大量にある場合もそれらはすべてコピーで問題ない。<br><br>
最初に起動する実行ファイルがx86またはAMD64でのビルドになっている場合、それ以降に読み込まれるAnyCPUのライブラリもそれに応じて動作する。<br>
 
そのため、AnyCPUのライブラリが多く存在する場合もそれらは全てコピーで問題ない。<br>
* '''長所:ユーザに選択を任せることで、プログラム側で判断をする必要から解放される。'''
<br>
* '''短所:Webサイトに公開する場合などに、ユーザは自分の環境に合わせたバージョンをDLして貰わねばならず面倒をかける。'''
* メリット
*: ユーザに選択を任せることにより、プログラム側で判断をする必要から解放される。
* デメリット
*: Webサイトに公開する場合等、ユーザは自分の環境に合わせたバージョンをダウンロードする必要がある。
<br><br>
<br><br>


== DLLをSystemディレクトリに配置する方法 ==
== DLLをSystemディレクトリに配置する方法 ==
64bit版WindowsにはWOW64があり、通常の64bitのSystem32ディレクトリとは別に、<br>
AMD64向けWindowsにはWOW64機能があり、AMD64のSystem32ディレクトリとは別に、x86のプログラムを動作させるためにSysWOW64ディレクトリが存在する。<br>
32bitのプログラムを動かすためにSysWOW64ディレクトリが存在するので、そのディレクトリに別々にDLLを配置する方法。<br><br>
これを利用して、該当するディレクトリに対して、別々にライブラリを配置する方法である。<br>
 
<br>
* '''長所:ソースコードの修正が不要である。'''
* メリット
* '''短所:Systemディレクトリが汚れる。また、セキュリティ関連の警告が表示され、アンインストールも大変になる。'''
*: ソースコードの修正が不要である。
* デメリット
*: Systemディレクトリが汚れる。
*: セキュリティ関連の警告が表示される。
*: また、アンインストールも煩雑になる。
<br><br>
<br><br>


== インストーラを使用する方法 ==
== インストーラを使用する方法 ==
インストーラを使えば、インストーラが実行時に実行環境を判別して、適切なDLLを配置してくれるように設定可能で、不要なDLLは残らない。<br><br>
インストーラを使用する場合、インストーラが実行時に実行環境を判別して適切なライブラリを配置するように設定可能なため、不要なライブラリは残らない。<br>
 
<br>
* '''長所 : 不要なDLLが残らない。'''
* メリット
* '''短所 : インストーラを作る必要がある。レジストリにインストール情報が残る。'''
*: 不要なライブラリが残らない。
     '''32bit用DLLと64bit用DLLの両方を作成しなければいけない。'''
* デメリット
*: インストーラを作成する必要がある。
*: レジストリにインストール情報が残る。
*: x86向けライブラリおよびAMD64bit向けライブラリの両方を開発しなければならない。
<br><br>
<br><br>


== SetDllDirectory関数を使用する方法 ==
== SetDllDirectory関数を使用する方法 ==
32bitのDLLと64bitのDLLを別のディレクトリに配置して呼び分ける方法。<br>
x86 / AMD64のライブラリを別のディレクトリに配置して呼び分ける方法である。<br>
DLLの配置場所を変更するAPIである”SetDllDirectory”関数を用いて、実行時にそれぞれの置き場を指定する。<br>
<br>
以下にソースコードを記載する。<br>
ライブラリの配置場所を変更するAPIである<code>SetDllDirectory</code>関数を使用して、実行時にそれぞれのライブラリのパスを指定する。<br>
 
<br>
  <syntaxhighlight lang="cpp">
  <syntaxhighlight lang="c#">
  // <summary>
  // <summary>
  // DllImport用に、x86用のDLLのあるディレクトリとx64用のDLLのあるディレクトリを設定するためのクラスです。
  // DllImport向けに、x86 / AMD64向けのライブラリを別々に設定するためのクラス
  // </summary>
  // </summary>
  public static class NativeDllDir
  public static class NativeDllDir
  {
  {
     // <summary>
     // <summary>
     // DllImport用に、x86用のDLLのあるディレクトリとx64用のDLLのあるディレクトリを設定します。
     // DllImport向けに、x86 / AMD64のライブラリのあるディレクトリを設定する
     // </summary>
     // </summary>
     // <param name="x86DllDir">x86用のDLLを配置したディレクトリを指定します。
     // <param name="x86DllDir">x86 DLLを配置したディレクトリを指定する
     // 指定しなければカレントディレクトリとなります。
     //           指定しなければカレントディレクトリとなる
     // </param>
     // </param>
     // <param name="x64DllDir">x64用のDLLを配置したディレクトリを指定します。
     // <param name="x64DllDir">AMD64 DLLを配置したディレクトリを指定する
     //   指定しなければカレントディレクトリとなります。
     //   指定しなければカレントディレクトリとなる
     // </param>
     // </param>
     // <returns>設定に成功したらtrue。</returns>
     // <returns>設定に成功した場合は true</returns>
     // <exception cref="PlatformNotSupportedException">x86でもx64でもない場合の例外です。</exception>
     // <exception cref="PlatformNotSupportedException">x86でもAMD64でもない場合の例外</exception>
     public static bool Set( string x86DllDir = null, string x64DllDir = null )
     public static bool Set( string x86DllDir = null, string x64DllDir = null )
     {
     {
68行目: 82行目:
   
   
       if ( IntPtr.Size == 8 )
       if ( IntPtr.Size == 8 )
       { // 64bit
       { // AMD64
           return SetDllDirectory( string.IsNullOrEmpty( x64DllDir ) ? "." : x64DllDir );
           return SetDllDirectory( string.IsNullOrEmpty( x64DllDir ) ? "." : x64DllDir );
       }
       }
       else if ( IntPtr.Size == 4 )
       else if ( IntPtr.Size == 4 )
       { // 32bit
       { // x86
           return SetDllDirectory( string.IsNullOrEmpty( x86DllDir ) ? "." : x86DllDir );
           return SetDllDirectory( string.IsNullOrEmpty( x86DllDir ) ? "." : x86DllDir );
       }
       }
       else
       else
       { // その他
       { // その他
           throw new PlatformNotSupportedException();
           throw new PlatformNotSupportedException();
       }
       }
87行目: 101行目:
  static class Program
  static class Program
  {
  {
    // <summary>
    // アプリケーションのメイン エントリ ポイントです。
    // </summary>
     [STAThread]
     [STAThread]
     static void Main( string[] args )
     static void Main( string[] args )
97行目: 108行目:
                       System.Reflection.Assembly.GetEntryAssembly().Location );
                       System.Reflection.Assembly.GetEntryAssembly().Location );
       NativeDllDir.Set( MyPath + @"\x86", MyPath + @"\x64" );
       NativeDllDir.Set( MyPath + @"\x86", MyPath + @"\x64" );
       // TODO: この後でDllImportを定義しているクラスを使用
       // DllImportを定義しているクラスを使用
      // ...略
     }
     }
  }
  }
  </syntaxhighlight>
  </syntaxhighlight>
 
<br>
* '''長所 : SetDllDirectory関数の呼び出しコードを追加すればよいだけなので、実装が比較的容易である。'''
* メリット
* '''短所 : Windows XP SP1以降でのみ動作する。それ以前ではSetDllDirectory関数は使用できない。'''
*: <code>SetDllDirectory</code>関数の呼び出しコードを追加するだけのため、実装が比較的容易である。
     '''32bit用DLLと64bit用DLLの両方を作成しなければいけない。'''
* デメリット
*: Windows XP SP1以降でのみ動作する。
*: それ以前のOSの場合は、<code>SetDllDirectory</code>関数は使用できない。
*: x86向け / AMD64向けのライブラリの両方を開発しなければならない。
<br><br>
<br><br>


== x86向けDLLとx64向けDLLの両方をDllImportする方法 ==
== x86向けDLLとx64向けDLLの両方をDllImportする方法 ==
ソースコードは上記より短いが中途半端で使用し難い。<br>
"SetDllDirectory関数を使用する方法"より簡単に記述可能であるが、中途半端で使用しにくい。<br>
<br>
<br>
* 長所
* 長所
*: Windows XP SP1より以前でも使用できる。
*: Windows XP SP1より以前でも使用できる。
* 短所
* 短所
*: x86向けDLLとx64向けDLLの両方を作成する必要がある。
*: x86向けDLLとx64向けライブラリの両方を開発する必要がある。
*: また、呼び出す関数を全て記述する必要がある。
*: また、呼び出す関数を全て記述する必要がある。
  <syntaxhighlight lang="c#">
  <syntaxhighlight lang="c#">
141行目: 157行目:
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
<br><br>


__FORCETOC__
__FORCETOC__
[[カテゴリ:C_Sharp]]
[[カテゴリ:C_Sharp]]

2025年1月1日 (水) 12:59時点における最新版

概要

C#では、実行環境のアーキテクチャがx86 / AMD64に関わらず、適切なモードで実行できるAnyCPUという仕組みが存在する。

しかし、AnuCPUは実行時までx86 / AMD64のどちらで動作するかは不明である。
そのため、AnyCPUをサポートしていない言語、例えば、C/C++言語やC++/CLI言語で開発されたライブラリを使用する場合、DllImportキーワードとの相性が悪い。

なぜなら、DllImportキーワードはコンパイル時にライブラリの読み込みパスを指定するため、実行時において、x86 / AMD64ごとにライブラリを切り替えることができない。

このような場合、どのような解決策を使うにせよ、何らかの制約を強いられることになる。


全てのモジュールをx86に固定する方法

C#側の実行ファイルをx86に指定することにより、常にx86のライブラリを使用する方法である。

  • メリット
    最も簡単であり、最低限の変更で済む。
  • デメリット
    64ビットOSのメリット (多くのメモリが使用でき、一部の処理が高速化する) を活かせない。



C#側のモジュールもx86 / AMD64を別々に用意する方法

全てのモジュールに対して、x86 / AMD64を別々に開発する方法である。

最初に起動する実行ファイルがx86またはAMD64でのビルドになっている場合、それ以降に読み込まれるAnyCPUのライブラリもそれに応じて動作する。
そのため、AnyCPUのライブラリが多く存在する場合もそれらは全てコピーで問題ない。

  • メリット
    ユーザに選択を任せることにより、プログラム側で判断をする必要から解放される。
  • デメリット
    Webサイトに公開する場合等、ユーザは自分の環境に合わせたバージョンをダウンロードする必要がある。



DLLをSystemディレクトリに配置する方法

AMD64向けWindowsにはWOW64機能があり、AMD64のSystem32ディレクトリとは別に、x86のプログラムを動作させるためにSysWOW64ディレクトリが存在する。
これを利用して、該当するディレクトリに対して、別々にライブラリを配置する方法である。

  • メリット
    ソースコードの修正が不要である。
  • デメリット
    Systemディレクトリが汚れる。
    セキュリティ関連の警告が表示される。
    また、アンインストールも煩雑になる。



インストーラを使用する方法

インストーラを使用する場合、インストーラが実行時に実行環境を判別して適切なライブラリを配置するように設定可能なため、不要なライブラリは残らない。

  • メリット
    不要なライブラリが残らない。
  • デメリット
    インストーラを作成する必要がある。
    レジストリにインストール情報が残る。
    x86向けライブラリおよびAMD64bit向けライブラリの両方を開発しなければならない。



SetDllDirectory関数を使用する方法

x86 / AMD64のライブラリを別のディレクトリに配置して呼び分ける方法である。

ライブラリの配置場所を変更するAPIであるSetDllDirectory関数を使用して、実行時にそれぞれのライブラリのパスを指定する。

 // <summary>
 // DllImport向けに、x86 / AMD64向けのライブラリを別々に設定するためのクラス
 // </summary>
 public static class NativeDllDir
 {
    // <summary>
    // DllImport向けに、x86 / AMD64のライブラリのあるディレクトリを設定する
    // </summary>
    // <param name="x86DllDir">x86 DLLを配置したディレクトリを指定する 
    //            指定しなければカレントディレクトリとなる
    // </param>
    // <param name="x64DllDir">AMD64 DLLを配置したディレクトリを指定する
    //			  指定しなければカレントディレクトリとなる
    // </param>
    // <returns>設定に成功した場合は true</returns>
    // <exception cref="PlatformNotSupportedException">x86でもAMD64でもない場合の例外</exception>
    public static bool Set( string x86DllDir = null, string x64DllDir = null )
    {
       // 既に設定されているものをリセット
       SetDllDirectory( null );
 
       if ( IntPtr.Size == 8 )
       {  // AMD64
          return SetDllDirectory( string.IsNullOrEmpty( x64DllDir ) ? "." : x64DllDir );
       }
       else if ( IntPtr.Size == 4 )
       {  // x86
          return SetDllDirectory( string.IsNullOrEmpty( x86DllDir ) ? "." : x86DllDir );
       }
       else
       {  // その他
          throw new PlatformNotSupportedException();
       }
    }
 
    [System.Runtime.InteropServices.DllImport( "kernel32", SetLastError = true )]
    private static extern bool SetDllDirectory( string lpPathName );
 }

 static class Program
 {
    [STAThread]
    static void Main( string[] args )
    {
       // exeファイルが存在するディレクトリパス
       string MyPath = System.IO.Path.GetDirectoryName(
                       System.Reflection.Assembly.GetEntryAssembly().Location );
       NativeDllDir.Set( MyPath + @"\x86", MyPath + @"\x64" );
 
       // DllImportを定義しているクラスを使用
       // ...略
    }
 }


  • メリット
    SetDllDirectory関数の呼び出しコードを追加するだけのため、実装が比較的容易である。
  • デメリット
    Windows XP SP1以降でのみ動作する。
    それ以前のOSの場合は、SetDllDirectory関数は使用できない。
    x86向け / AMD64向けのライブラリの両方を開発しなければならない。



x86向けDLLとx64向けDLLの両方をDllImportする方法

"SetDllDirectory関数を使用する方法"より簡単に記述可能であるが、中途半端で使用しにくい。

  • 長所
    Windows XP SP1より以前でも使用できる。
  • 短所
    x86向けDLLとx64向けライブラリの両方を開発する必要がある。
    また、呼び出す関数を全て記述する必要がある。
 public class DLL
 {
    [DllImport(@"x86\hoge.dll", EntryPoint = "Hoge")]
    private static extern IntPtr Hoge32();
 
    [DllImport(@"x64\hoge.dll", EntryPoint = "Hoge")]
    private static extern IntPtr Hoge64();
 
    public delegate IntPtr HogeFunc();
    public static readonly HogeFunc Hoge;
 
    static Dll()
    {
       if ( IntPtr.Size == 8 )
       {
          Hoge = Hoge64;
       }
       else if ( IntPtr.Size == 4 )
       {
          Hoge = Hoge32;
       }
    }
 }