--- title: XPCOM ABI slug: Mozilla/Tech/XPCOM/XPCOM_ABI tags: - XPCOM translation_of: Mozilla/Tech/XPCOM/XPCOM_ABI ---
XPCOM ABIは、XPCOMコンポーネントのバイナリインターフェースです。スクリプト言語(JavaScriptなど)によって書かれたXPCOMコンポーネントは、特に改変をしなくてもプラットフォーム(WindowsやOS Xなど)を越えて動作させられますが、コンパイルが必要な言語(C++など)で書かれたコンポーネントの場合、異なるプラットフォームで動かすためには再コンパイルが必要です。コンパイルされたXPCOMコンポーネントは多くの場合、「バイナリ」や「ネイティブ」などと呼ばれます。
一つのバイナリXPCOMコンポーネントは、すべてのプラットフォームで利用できる.xpt
ファイルと、特定のプラットフォーム用で且つ特定のABIを持ったDLL(Windowsでは.dll
、Linuxでは.so
)から成ります。このABIを利用するアプリケーションだけが、このXPCOMコンポーネントを利用することができます。簡単に言えば、特定のABI用にビルドされたXPCOMコンポーネントは、同じABI用にビルドされたFirefox、Thunderbird、その他のXULRunnerアプリケーションに対してのみ互換性があります。
各々のABIは、以下の形式の[TARGET_XPCOM_ABI]文字列によって名付けられています。:
{CPU_ARCH}-{TARGET_COMPILER_ABI}
{CPU_ARCH}[Platforms]は、以下のいずれかのCPUのアーキテクチャを意味します:
x86
- i386およびそれ以降のシリーズ(x86-64 CPUの32bitモードも含みます)
ppc
- PowerPCシリーズ
Alpha
- Alphaシリーズ
x86_64
- 64bitモードのAMD64/EMT64シリーズ(32bitモードの場合はx86
と見なされます)
sparc
- SPARCシリーズ
ia64
- Itaniumシリーズ
{TARGET_COMPILER_ABI}[Platforms]は、以下のいずれかのコンパイラのABIを意味します:
msvc
- Microsoft Visual C++
n32
- IRIX 6 C++ Compiler
gcc2
- GNU C++ Compiler 2.x
gcc3
- GNU C++ Compiler 3.x or 4.x
sunc
- Sun C++ Compiler
ibmc
- IBM C++ Compiler
例:
x86-gcc3
というXPCOM ABIを持ちます。
XPCOM ABI文字列は、nsIXULRuntimeを使うことによってプログラムから取得できます。あなたのFirefoxあるいはThunderbirdのABIを取得するには、エラーコンソールを開いて(ツール | エラーコンソール
から開けます)以下のJavaScriptコードを実行してください:
Components.classes["@mozilla.org/xre/app-info;1"] .getService(Components.interfaces.nsIXULRuntime) .XPCOMABI
もしCPUのアーキテクチャもしくはC++コンパイラのいずれかが未知の場合は、アプリケーションはXPCOM ABI文字列を持たず、それを取得しようと試みた際にはNS_ERROR_NOT_AVAILABLEというエラーを起こすでしょう。それは特徴的なABIだと思われますが、しかし私たちはそれに対して付ける名前を持っていません。
TARGET_XPCOM_ABI
です。(これは内部の詳細情報で、拡張機能の開発者にとっては無関係です。)
アプリケーション(例:Firefox)がサポートするABIの名前は、ビルド時に埋め込まれます。その後、アプリケーションはサードパーティ製のバイナリXPCOMコンポーネントの互換性を調べるためにその値を使います。
互換性チェックとの共通点は、拡張機能のインストールの間にあります。もし、ある拡張機能がバイナリXPCOMを提供する場合、インストール定義においてそれらのXPCOM ABIが宣言されているべきです。拡張機能の作者は、XPCOMコンポーネントをサポートしているマシンすべてのためにそれぞれビルド(コンパイル)して、プラットフォームごとのサブディレクトリに入れ、すべてのビルドを一つのXPIの中にパッケージングすることができます。拡張機能がインストールされる時、アプリケーションはそれ自身のABIに最も適したコンポーネントのビルドを選択します。もし適合するビルドが見つからなければ、その拡張機能は互換性がないと見なされ、アプリケーションはインストールを中断するでしょう。
もし、(ABIのネーミングで説明しているとおり、CPUアーキテクチャかC++コンパイラのいずれかが不明であった結果として)そのアプリケーションがXPCOM ABI文字列を持っていない場合、あなたはインストール定義などに記述するプラットフォーム名としてOSの名前を(XPCOM ABIを付けずに)使うべきです。