JavaからObjective-Cのライブラリを読み込む

JavaアプリケーションでObjective-Cの動的ライブラリを読み込むには、NSRuntimeクラスを使用します。 そのライブラリがバンドルの中に含まれている場合、NSBundleクラスがより適しているでしょう。

NSRuntimeの代表的なメソッド、<ilcode>loadLibrary</ilcode>は読み込む動的ライブラリを表すString引数を取ります。 その文字列はライブラリへの絶対パス、もしくはライブラリ名だけを示します。 ライブラリ名のみが与えられた場合、標準的な接頭辞<ilcode>lib</ilcode>または接尾辞<ilcode>.dylib</ilcode>の有無を問わず、NSRuntimeはそのライブラリを見つけるまでディレクトリ一覧の中を探します。 例えば、<ilcode>/usr/lib</ilcode>に置かれた<ilcode>libMyCode.dylib</ilcode>という名前のライブラリの読み込みは、下記の全てパターンで動作します。

NSRuntime.loadLibrary("/usr/lib/libMyCode.dylib");
// もしくは、/usr/libが検索パスのならば
NSRuntime.loadLibrary("MyCode");
NSRuntime.loadLibrary("libMyCode.dylib");

読み込み後、そのライブラリはbasename<ilcode>Initialization</ilcode>関数呼び出しによって初期化されますが、basenameとは接頭辞と接尾辞を除いたライブラリの名前の事です。 例えば、<ilcode>libMyCode.dylib</ilcode>というライブラリの場合、読み込んだ際に初期化のための<ilcode>MyCodeInitialization</ilcode>という名前の関数が作られます。 この関数は引数を持ちません。

ライブラリが見つからない、または初期化関数がない場合、アプリケーションは<ilcode>UnsatisfiedLinkError</ilcode>エラーで終了します。

NSRuntimeクラスは、絶対パス指定のないライブラリの読み込みを試みた時の検索ディレクトリの一覧を管理します。 初期状態の検索パスは</ilcode>/usr/lib/java</ilcode>と><ilcode>/usr/local/lib/java</ilcode>です。 <ilcode>addPathToLibrarySearchPaths</ilcode>メソッドでパスをそのリストに追加出来ます。 このメソッドは、検索リストへ追加するディレクトリの絶対パスを表す1つのString引数を持ちます。 例えば、<ilcode>/usr/lib</ilcode>をリストに追加するには、次のようにします:

<code java> NSRuntime.addPathToLibraryPaths(“/usr/lib”); </ilcode>

現在の検索パスの一覧を得るには、<ilcode>librarySearchPaths</ilcode>を呼び出して下さい。