From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../spidermonkey/build_documentation/index.html | 290 +++++++++++++++++++++ 1 file changed, 290 insertions(+) create mode 100644 files/ja/mozilla/projects/spidermonkey/build_documentation/index.html (limited to 'files/ja/mozilla/projects/spidermonkey/build_documentation') diff --git a/files/ja/mozilla/projects/spidermonkey/build_documentation/index.html b/files/ja/mozilla/projects/spidermonkey/build_documentation/index.html new file mode 100644 index 0000000000..dd5a4146c2 --- /dev/null +++ b/files/ja/mozilla/projects/spidermonkey/build_documentation/index.html @@ -0,0 +1,290 @@ +--- +title: SpiderMonkey のビルド +slug: Mozilla/Projects/SpiderMonkey/Build_Documentation +tags: + - Build documentation + - Guide + - SpiderMonkey +translation_of: Mozilla/Projects/SpiderMonkey/Build_Documentation +--- +
{{SpiderMonkeySidebar("General")}}
+ +

SpiderMonkey のビルド

+ +

この文書は SpiderMonkey の最新版をソースコードからビルドする方法を解説します。

+ +

ビルドを始める前に、必要なツールがインストールされていることを確認してください。Linux, Windows, Mac, その他の環境 での準備は、それぞれのドキュメントをごらんください。28 より古いバージョンのビルドをする際は、NSPR が追加で必要となります。

+ +

また SpiderMonkey 最新版のソースコード も必要です。

+ +

非開発者向け (最適化) ビルド

+ +

実運用用のために SpiderMonkey をインストールする場合、またはパフォーマンスベンチマークを実行する場合は、これらの手順を使用してください (SpiderMonkey を C++ アプリケーションのライブラリとして使用したい場合、または SpiderMonkey 自体の改善に取り組んでいる場合は、代わりに下記のように開発者/デバッグビルドを行ってください)。

+ +
cd js/src
+autoconf2.13
+
+# この名前は、バージョン管理システムで無視させるために "_OPT.OBJ" で終わる必要があります。
+mkdir build_OPT.OBJ
+cd build_OPT.OBJ
+../configure
+# Windows では "mozmake" を使います。
+make
+
+ +

これについてのいくつかのメモ:

+ + + +
+

メモ: Mac を使用していて、次のようなエラーが表示される場合

+ +

"checking whether the C compiler (gcc-4.2  ) works... no
+ configure: error: installation or configuration problem: C compiler cannot create executables."

+ +

次のように設定してみてください。

+ +
CC=clang CXX=clang++  ../configure
+ +

baldrdash がコンパイルに失敗する可能性もあります。

+ +
/usr/local/Cellar/llvm/7.0.1/lib/clang/7.0.1/include/inttypes.h:30:15: fatal error: 'inttypes.h' file not found
+
+/usr/local/Cellar/llvm/7.0.1/lib/clang/7.0.1/include/inttypes.h:30:15: fatal error: 'inttypes.h' file not found, err: true
+ +

これは Mohave 以降、ヘッダーが /usr/include にインストールされなくなったためです。コマンドラインツール -> 新機能の下のリリースノートを参照してください。

+ +

リリースノートには、この互換性パッケージは近い将来提供されなくなると記載されているので、macOS 上のビルドシステムは SDK のヘッダを探すように適合させる必要があるでしょう。
+
+ それまでは、次のことが役に立ちます。

+ +
open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pk
+
+
+ +

これにより build-release/dist/bin ディレクトリに js という実行可能ファイルが構築されます。ヘルプページを表示する dist/bin/js --help でテストできます。これで、シェルを実行して試す準備が整いました。

+ +

Mac、Linux、または UNIX では、追加のコマンド make install を使用してシステムに SpiderMonkey をインストールできます。これは共有ライブラリを /usr/local/lib に、C ヘッダファイルを usr/local/include に、そして js 実行ファイルを /usr/local/bin にインストールします。

+ +

開発者向け（デバッグ用）ビルド

+ +

SpiderMonkey 自身の開発やデバッグを目的とする場合、日々のデバッグにはデバッグビルドを、パフォーマンステストには最適化ビルドを、それぞれ別のディレクトリで行うことになります。デバッグビルドを行うには、上記の手順に加えて以下の 3 ステップを行います:

+ +
cd js/src
+autoconf-2.13
+
+# This name should end with "_DBG.OBJ" to make the version control system ignore it.
+mkdir build_DBG.OBJ
+cd build_DBG.OBJ
+../configure --enable-debug --disable-optimize
+# Use "mozmake" on Windows
+make
+
+ +

JS_GC_ZEAL オプションをつけてビルドすると、zealous ガベージコレクションが有効になります。これはメモリリークに代表されるメモリ関連のデバッグを行う時に有用です。詳細は JS_SetGCZeal() をご覧ください。

+ +

この他のビルドオプションについては、上記で作成したビルドディレクトリ内で次のコマンドを実行してください：

+ +
../configure --help
+
+ +

コンパイルデータベースの生成

+ +

一部のツール (IDE、静的アナライザー、リファクタリングツールなど) は、ソフトウェアを構築するために必要なすべての要素の説明を含む compile_commands.json というファイルを使用するため、ツールは構築システムも理解する必要はありません。

+ +

SpiderMonkey 設定スクリプトを使用して compile_commands.json を生成するには、次のように CompileDB バックエンドを有効にします。

+ +
 ../configure <options> --enable-build-backends=CompileDB,RecursiveMake
+
+ +

(RecursiveMake はあなたもビルドできるようになりたいと思うのでそこにあります!)

+ +

Windows でのビルド

+ +
+

バージョン 28 以降、スレッドセーフビルドがデフォルトとなり、すべての POSIX プラットフォームでそのまま使用できるはずです。したがって、次の手順は Windows を使用している場合、または古いバージョンの SpiderMonkey をコンパイルしている場合にのみ関係があります。

+
+ +

The MozillaBuild batch file you used to open your shell (e.g. start-shell-msvc2013.bat or start-shell-msvc2013-x64.bat) determines whether the compiler toolchain will target 32-bit or 64-bit builds. To create a 64-bit build, note that you must configure with --target=x86_64-pc-mingw32 --host=x86_64-pc-mingw32.

+ +

Since the POSIX NSPR emulation is not available for Windows, a working version of NSPR must be available to your build. The easiest option is to configure with --enable-nspr-build. This configure option builds the in-tree version of NSPR which is probably what you want; because SpiderMonkey uses newer NSPR symbols, the NSPR that ships with your operating system probably does not work.

+ +

If --enable-nspr-build does not work, explicitly tell configure where to find NSPR using the --with-nspr-cflags and --with-nspr-libs configure options. For example, assuming your local NSPR has been installed to C:/mozilla-build/msys/local:

+ +
./configure --with-nspr-cflags="-IC:/mozilla-build/msys/local/include" \
+            --with-nspr-libs="C:/mozilla-build/msys/local/lib/libnspr4.a \
+                              C:/mozilla-build/msys/local/lib/libplds4.a \
+                              C:/mozilla-build/msys/local/lib/libplc4.a"
+
+ +

If you get symbol loading or dynamic library errors, you can force the correct NSPR to load with:

+ +
PATH="$PATH;C:/mozilla-build/msys/local/lib/" ./js
+ +

Specifying installation directories

+ +

make install puts files in the following directories by default. You can override this by passing options to the configure script:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
What it isWhere it gets putconfigure option
executables, shell scripts/usr/local/bin--bindir
libraries, data/usr/local/lib--libdir
architecture-independent data/usr/local/share--sharedir
C header files/usr/local/include--includedir
+ +

For convenience, you can pass the configure script an option of the form --prefix=<PREFIXDIR>, which substitutes <PREFIXDIR> for /usr/local in all the settings above, in one step. This is usually the least troublesome thing to do, as it preserves the typical arrangement of lib, bin, and the rest.

+ +
Note: All directories you pass to configure are recorded in the generated makefile, so you don't need to specify them again until you re-run configure.
+ +

Building SpiderMonkey as a static library

+ +

By default, SpiderMonkey builds as a shared library. However, you can build SpiderMonkey as a static library by specifying the --disable-shared-js flag when you run configure.

+ +

Specifying compilers and compiler flags

+ +

If you want to use a compiler other than the one the configure script chooses for you by default, you can set the CXX variable in the environment when you run configure. This will save the values you specify in the generated makefile, so once you've set it, you don't need to do so again until you re-run configure.

+ +

If you'd like to pass certain flags to the compiler, you can set the CXXFLAGS environment variable when you run configure. For example, if you're using the GNU toolchain, the following will pass the -g3 flag to the compiler, causing it to emit debug information about macros. Then you can use those macros in gdb commands:

+ +
$ CXXFLAGS=-g3 $SRC/configure
+...
+checking whether the C++ compiler (c++ -g3 ) works... yes
+...
+$
+ +

Cross-compiling options

+ +

For cross-compiling you will need a cross-compiling compiler. That tends to be easier with clang as clang has cross-compiling support built in. You may need other libraries though.  For example on debian linux you'll need the following to cross compile from x86_64 to x86.

+ +
apt install clang libstdc++-8-dev-i386-cross binutils-i686-gnu zlib1g-dev:i386
+ +

You'll also need rust, in addition to having normal rust set up you'll need to add another target to your existing rust toolchain (don't add a new toolchain spidermonkey will use only one toolchain and use it for both host and target code:

+ +
rustup target add i686-unknown-linux-gnu
+ +

To build a 32-bit version on a 64-bit Linux system, you can use the following:

+ +
PKG_CONFIG_LIBDIR=/usr/lib/pkgconfig CC="gcc -m32 -mfpmath=sse -msse -msse2" CXX="g++ -m32 -mfpmath=sse -msse -msse2" AR=ar \
+$SRC/configure --target=i686-pc-linux
+ +

Or for clang.

+ +
$SRC/configure --target=i686-pc-linux-gnu
+ +

To build a 32-bit arm version on a 64-bit Linux system, that runs in the arm simulator, you can use the following:

+ +
   AR=ar CC="gcc -m32 -mfpmath=sse -msse -msse2" CXX="g++ -m32 -mfpmath=sse -msse -msse2" \
+    $SRC/configure --target=i686-pc-linux --enable-simulator=arm
+ +

To build a 32-bit version on a 64-bit Mac system (the target version is specific to your OS/X SDK), you can use the following:

+ +
$SRC/configure --target=i386-apple-darwin16.7.0 # Choose the appropriate SDK version for your version of OS/X
+ +

To build a 64-bit version on a 32-bit Mac system (e.g. Mac OS X 10.5), you can use the following:

+ +
AR=ar CC="gcc -m64" CXX="g++ -m64" ../configure --target=x86_64-apple-darwin10.0.0
+ +

To build a 64-bit Windows version, you can use the following:

+ +
$SRC/configure --host=x86_64-pc-mingw32 --target=x86_64-pc-mingw32
+ +
Note: You must have started your MozillaBuild shell with the proper -x64.bat script in order for the 64-bit compilers to be in your PATH.
+ +

Whatever compiler and flags you pass to configure are recorded in the generated makefile, so you don't need to specify them again until you re-run configure.

+ +

Building your application

+ +

While "How to build your complete application" is clearly out of scope for this document, here are some tips that will help get you on your way:

+ + + +

Using the js-config script

+ +

In addition to the SpiderMonkey libraries, header files, and shell, the SpiderMonkey build also produces a shell script named js-config which other build systems can use to find out how to compile code using the SpiderMonkey APIs, and how to link with the SpiderMonkey libraries.

+ +
Note: In SpiderMonkey 1.8.5, the js-config script is not generated properly on many platforms. If the instructions below do not work, you can try this workaround.
+ +

When invoked with the --cflags option, js-config prints the flags that you should pass to the C compiler when compiling files that use the SpiderMonkey API. These flags ensure the compiler will find the SpiderMonkey header files.

+ +
$ ./js-config --cflags # Example output: -I/usr/local/include/js -I/usr/include/nspr
+ +

When invoked with the --libs option, js-config prints the flags that you should pass to the C compiler when linking an executable or shared library that uses SpiderMonkey. These flags ensure the compiler will find the SpiderMonkey libraries, along with any libraries that SpiderMonkey itself depends upon (like NSPR).

+ +
$ ./js-config --libs # Example output: -L/usr/local/lib -lmozjs -L/usr/lib -lplds4 -lplc4 -lnspr4 -lpthread -ldl -ldl -lm  -lm -ldl
+ +

Testing SpiderMonkey

+ + + +

Building SpiderMonkey 1.8 or earlier

+ +

Use these instructions to build SpiderMonkey from an official source release or from the old CVS repository. To build the latest SpiderMonkey sources from Mercurial, see Building SpiderMonkey above.

+ +

SpiderMonkey is easy to build from source if you have the usual Mozilla build prerequisites installed. Before you begin, make sure you have right build tools for your computer: Linux, Windows, Mac, others.

+ +

First, download a SpiderMonkey source distribution, such as SpiderMonkey 1.8 Release Candidate 1.

+ +

To build, use these commands:

+ +
tar xvzf js-1.8.0-rc1.tar.gz
+cd js/src
+make -f Makefile.ref
+ +

This builds a debug version of SpiderMonkey. All build files are created in a subdirectory named depending on your system (for example,Linux_All_DBG.OBJ if you are on Linux). To install this build on your system, see SpiderMonkey installation instructions.

+ +

To build an optimized (non-debug) version of SpiderMonkey:

+ +
make BUILD_OPT=1 -f Makefile.ref
+ +

To build a thread-safe version of SpiderMonkey:

+ +
make JS_DIST=/full/path/to/directory/containing/nspr JS_THREADSAFE=1 -f Makefile.ref
-- cgit v1.2.3-54-g00ecf