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のネーミング

各々の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

例:

• Intel Pentiumプロセッサ用のGNU C++ Compiler 4.0.0によってビルドされたFirefoxは、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だと思われますが、しかし私たちはそれに対して付ける名前を持っていません。

Extension Installation

アプリケーション（例：Firefox）がサポートするABIの名前は、ビルド時に埋め込まれます。その後、アプリケーションはサードパーティ製のバイナリXPCOMコンポーネントの互換性を調べるためにその値を使います。

互換性チェックとの共通点は、拡張機能のインストールの間にあります。もし、ある拡張機能がバイナリXPCOMを提供する場合、インストール定義においてそれらのXPCOM ABIが宣言されているべきです。拡張機能の作者は、XPCOMコンポーネントをサポートしているマシンすべてのためにそれぞれビルド（コンパイル）して、プラットフォームごとのサブディレクトリに入れ、すべてのビルドを一つのXPIの中にパッケージングすることができます。拡張機能がインストールされる時、アプリケーションはそれ自身のABIに最も適したコンポーネントのビルドを選択します。もし適合するビルドが見つからなければ、その拡張機能は互換性がないと見なされ、アプリケーションはインストールを中断するでしょう。

もし、（ABIのネーミングで説明しているとおり、CPUアーキテクチャかC++コンパイラのいずれかが不明であった結果として）そのアプリケーションがXPCOM ABI文字列を持っていない場合、あなたはインストール定義などに記述するプラットフォーム名としてOSの名前を（XPCOM ABIを付けずに）使うべきです。