Adding Files to the Build

出典: MDC

何かを追加したい (でもビルドを壊したくない) ...

現在、全てのプラットフォームのビルドで同一セットの Makefile を使用するようになりました。つまり、やっと、 Makefile.in ファイル群を編集するだけで済むようになったのです。(新しい makefile を追加する場合は mozilla/allmakefiles.sh も)。【訳注: 訳注: Camino (Cocoa ないし Xcode) 部分は Xcode プロジェクトにファイルを追加することになるので、厳密には Makefile の修正だけで OK とはなりません。Mozilla だけについていえば、ドキュメント通り Makefile の修正だけで OK のはずです。】

[編集] ファイルをビルドに追加

• 現在、全てのプラットフォームで Makefile.in を使用しています。新しいソースファイルを追加したらこれを編集して、ヘッダファイルをエクスポートしてください。
• >依存状態も Makefile.in で指定します。
• 新しいディレクトリをビルドに追加する場合は、mozilla/allmakefiles.sh のディレクトリリスト中にその Makefile のエントリを加え、同様にそのディレクトリを ../Makefile.in のサブディレクトリのリストに追加する必要があります。

[編集] チェックイン

もし正しい手順でチェックインしなければ、新しいファイルをビルドに追加することが tinderbox や他の開発者に被害を与える恐れがあります。

1. 新しいファイルだけをチェックインしてください。
2. 新しいファイルを参照する既存のファイルに対しては、パッチをチェックインしてください。

[編集] ファイルのエクスポート

ファイルのエクスポートでは mozilla/dist へのコピーが行われます。C 及び C++ のヘッダファイルのエクスポートでは、Makefile.in の EXPORTS リストにヘッダファイルを含めます。IDL ファイルのエクスポートでは XPIDLSRCS リストに IDL ファイルを含めます。

[編集] XPInstall

エンドユーザー配布に存在している必要があるものを作成する場合は、それを適切な XPInstall パッケージに登録することを忘れないでください。 ファイルを、適切な場所 (それがどこで必要なのかに依ります) に追加してください。mozilla/xpinstall/packages-win または mozilla/xpinstall/xpcom-win.pkg (GRE)、mozilla/xpinstall/packages-static-win、mozilla/xpinstall/packages-unix mozilla/xpinstall/packages-static-unix 及び mozilla/xpinstall/packages-os2 です。新しいファイルが embedders に必要であれば、mozilla/embedding/config/basebrowser-*　の適切なリストに追加してください。

新しいファイルを XPInstall パッケージに登録しなかった場合、あなたが作った新機能はあなた独自のツリーから起動した場合しか動作せず実際のエンドユーザに配布されるパッケージでは恐らく不完全なものになります。