Go-V8 Bindings

The go-V8 bindings allow a user to execute javascript from within a go executable.

The bindings are tested to work with v8 build 4.8.271.17 (latest stable at the time of writing).

Please see v8_test.go for examples of usage.

Compiling

In order for the bingings to compile correctly, one needs to:

Compile v8 as a static library.
Let cgo know where the library is located.

Compiling v8.

Download v8: https://github.com/v8/v8/wiki/Using%20Git

Lets say you've checked out the v8 source into $V8, go-v8 into $GO_V8 and want to place the static v8 library into $GO_V8/libv8/.

Linux

Build:

make x64.release GYPFLAGS="-Dv8_use_external_startup_data=0 \
  -Dv8_enable_i18n_support=0 -Dv8_enable_gdbjit=0"`

If build system produces a thin archive, you want to make it into a fat one:

for lib in `find out/x64.release/obj.target/tools/gyp/ -name '*.a'`;
  do ar -t $lib | xargs ar rvs $lib.new && mv -v $lib.new $lib;
done`

Copy the libraries to the destination directory:

cp -v out/x64.release/obj.target/tools/gyp/libv8_{base,libbase,external,libplatform}* \
  ${GO_V8}/libv8/

Mac

To build:

CXX="`which clang++` -std=c++11 -stdlib=libc++" \
GYP_DEFINES="mac_deployment_target=10.10" \
make x64.release GYPFLAGS="-Dv8_use_external_startup_data=0 \
  -Dv8_enable_i18n_support=0 -Dv8_enable_gdbjit=0"

Copy the libraries to the destination directory:

cp -v out/x64.release/libv8_{base,libbase,external,libplatform}* \
  ${GO_V8}/libv8/x86_64-apple-darwin

Note: On MacOS, the resulting libraries contain debugging information by default (even though we've built the release version). As a result, the binaries are 30x larger, then they should be. Strip that with strip -S out/x64.release/libv8*.a to reduce the size of the archives very significantly.

Good luck!

V8 compile dependencies

The list of v8 includes the bindings depend on:

include/libplatform
include/libplatform/libplatform.h
include/v8-testing.h
include/v8.h
include/v8config.h
include/v8-version.h
include/v8-platform.h
include/v8-debug.h
include/v8-profiler.h

Let cgo know where the library is located.

Let cgo know where it should look for the libraries do:

export CGO_CXXFLAGS="-I $V8/include"
export CGO_LDFLAGS="-L $GO_V8/libv8"

License

This software is licensed under Apache License, Version 2.0. Please see LICENSE for more information.

cchamplin / go-v8