Windows Build Prerequisites
出典: MDC
この文書は MozillaBuild 環境のガイドです。この環境は以下のバージョンの Mozilla コードベースのビルドに使用できます。
-
trunk(1.9/Firefox 3/Thunderbird 3) -
MOZILLA_1_8_BRANCH(1.8.1.2/Firefox 2.0.0.2 以上) -
MOZILLA_1_8_0_BRANCH(1.8.0.10/Firefox 1.5.0.10 以上)
以下のコンパイラとともに使用できます。
| ブランチ | HEAD Gecko 1.9 Firefox 3/Thunderbird 3 | MOZILLA_1_8_BRANCH Gecko 1.8.1 Firefox 2 | MOZILLA_1_8_0_BRANCH Gecko 1.8 Firefox 1.5.0.x |
|---|---|---|---|
| VC6 | × | ○（オフィシャル） | ○（オフィシャル） |
| VC7.1 (Visual Studio 2003) | ○ | ○ | × |
| VC8 (Visual Studio 2005) | ○（オフィシャル） | × | × |
| VC9 (Visual Studio 2008) | ○（実験的） | × | × |
それよりも古いバージョンのコードベースをビルドするには Windows build prerequisites using cygwin を参照してください。1.0 ブランチ以前のとても古いバージョンの Mozilla のソースコードをビルドする場合は nmake ビルドガイド に従ってください。
目次 |
[編集] 必要なハードウェア
Mozilla のビルドには時間がかかります。開発環境の整ったシステムが必要となります。
- Intel Pentium III または相当のプロセッサ、1 GHz 以上
- 512 MB の RAM、1 GB 以上推奨
- 1.5 GB 以上の NTFS または 3 GB 以上の FAT ディスクスペース
- Microsoft Windows 2000 SP4 以上
[編集] 必要なソフトウェア
Windows での標準的なビルドには以下のソフトウェアが必要です。
- Microsoft Visual C++ Tools
- Microsoft Windows SDK(s)
- MozillaBuild
スペースやプラス、引用符、メタ文字といった分割文字が含まれるパスにツールがインストールされていると Mozilla をビルドできない可能性があります。Visual C++ ツールはスペースを含むディレクトリにインストールしてもかまいません (デフォルトのインストール場所が望ましい) 。
[編集] Microsoft Visual C++ (MSVC)
Microsoft Visual C++ (MSVC) および Microsoft Visual Studio のどのバージョンを利用するべきかは、あなたが何をビルドしたいかによって変わってきます。このページのトップにある表を見て、ビルドしたいブランチと互換性のあるバージョンを選択してください。
- Gecko 1.8.1 以前をビルドする場合
- Gecko 1.8.1 およびそれ以前を使用してビルドするプロジェクト (Firefox 2 など) には、 Visual C++ 6 もしくは Visual C++ 7.1 (Visual Studio 2003) を使う必要があります。
- Visual C++ 6 を使用する場合、Visual Studio Service Pack 5 と Visual C++ 6.0 Processor Pack を適用してある必要があります。Processor Pack は Visual Studio Service Pack 6 では利用できません。
- Gecko 1.9 (trunk) をビルドする場合
- Gecko 1.9 を使用してビルドするプロジェクト (Firefox 3 など) には、Visual C++ 7.1 (Visual Studio 2003)、 Visual C++ 8 (Visual Studio 2005)、もしくは Visual C++ 9 (Visual Studio 2008) を使う必要があります。
- Visual C++ 8 はフリーの Visual C++ 2005 Express Edition の一部として無償で入手できます。コマンドラインツールと GUI 開発環境の両方をインストールしなければなりません。
- Visual Studio "Orcas" の March CTP を利用している場合、2 つの重要なインクルードファイルを誤った場所に配置するバグがあります。回避策として winable.h と oleacc.idl を C:\Program Files\Microsoft Visual Studio 9.0\VC\include から C:\Program Files\Microsoft SDKs\Windows\6.0\include にコピーしてください。
[編集] Microsoft Windows SDK
Visual Studio のすべてのバージョンで Microsoft Windows Vista SDK のインストールが必須になりました。
- ディスクスペースとダウンロード時間を節約したければ Sample Code と Documentation はインストールしなくてもかまいません。
- Windows XP を使用している場合、Vista SDK をインストールする前に Windows XP Service Pack 2 をインストールしなければなりません。
Visual C++ 7.1 もしくはフリーの Visual C++ 8 (Visual C++ 2005 Express) を使用する場合、いくつかのライブラリをインクルードするために Microsoft Windows Server 2003 R2 Platform SDK をインストールする必要があります (詳細は bug 427765 を参照)。
- 少なくとも "Windows Core SDK"、 "Web Workshop (IE) SDK"、および "Data Access Services (MDAC) SDK" をインストールする必要があります。
- すべての SDK について、ディスクスペースとダウンロード時間を節約したければ Sample Code と Documentation はインストールしなくてもかまいません。
--disable-parental-controls オプションを設定すると、この問題を回避して Windows XP もしくは Server 2003 Platform SDK のみを使ってビルドすることができます。(このオプションは MinGW コンパイラを使ってビルドする場合にも必要になります。)
Windows SDK for Windows Server 2008 はサポートされておらず、以下の問題が起こることがわかっています。
- Visual Studio 2008 のファイル vcvars32.bat が変更される
- .NET framework の PATH が正しく設定されなくなる
- 無効な PATH により Mozilla のビルドが中止される
考えられる回避策としては、別の SDK (Visual Studio 9 に付属のもの等) を利用するか、ファイル vcvars32.bat を削除してセットアッププログラムで Visual Studio のインストールを修復する方法があります。
[編集] MozillaBuild
MozillaBuild パッケージには Mozilla のビルドに必要な他のソフトウェアが入っています。wget、autoconf-2.13、xemacs といったオプション的あるいは便利なツールだけでなく、MSYS ビルド環境、Python、Unicode 版 NSIS、そして UPX が含まれています。
最新の MozillaBuild 1.2 パッケージをダウンロードしてください。
既定ではパッケージは C:\mozilla-build にインストールされます。デフォルトのパスを使用することを推奨します。インストーラは Windows レジストリに手を加えません。
注: フリーの Visual C++ 8 (Visual C++ 2005 Express) を使用する場合、 ビルドエラーを回避するためにバッチファイルのうち 2 つ (start-msvc8.bat と guess-msvc.bat) を置換する必要があります (詳細は bug 427765 を参照) :
- 修正済みの guess-msvc.bat をダウンロード
- 修正済みの start-msvc8.bat をダウンロード
start-msvc*.bat ウィンドウが何のメッセージも出さず点滅もせずに消える場合、msys/bin の中で sh.exe を bash.exe にコピーするか、sh.exe の存在するディレクトリの中にシンボリックリンクを作成します。
[編集] ビルド用コマンドプロンプトの取得
必要な物のインストールが終わったら、C:\mozilla-build ディレクトリから次のバッチファイルのうちの 1 つを実行します。
-
start-msvc6.bat -
start-msvc71.bat -
start-msvc8.bat -
start-msvc9.bat
Windows Vista（あるいは LUA アカウント下の Windows XP）でビルドする場合、ビルドエラーを避ける ために管理者としてバッチファイルを実行してください（右クリックし「管理者として実行」を選択）。
ソフトウェアの必要条件が満たされていれば、バッチファイルはすべての環境変数を適切に設定し、MSYS コマンドプロンプトのウィンドウを自動的に表示するでしょう。これ以降のコマンドはすべてこの環境で実行することになります。
[編集] よくある問題とヒント、制限
- PATH 環境変数に引用符 (") が含まれているとビルドに失敗する可能性があります。MozillaBuild のサブシェルに渡す際に引用符を適切に変換できないからです。通常、引用符は必要ないので除去することができます。
- Windows 上での Mozilla のデバッグ FAQ：Windows 上で Mozilla のデバッグする方法。