NW.js Development / Porting for RISC-V

Build host

Ubuntu 20.04.4 LTS Debian 11

Get the code

1. Setup depot_tools.

cd $HOME
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
export PATH=$PATH:${HOME}/depot_tools

2. Download a custom .gclient file for NW.js build.

mkdir nwjs && cd nwjs
wget https://raw.githubusercontent.com/rebeccasf/nwjs.config/master/gclient -O .gclient

3. Sync all source code.

cd src
gclient sync --with_branch_heads

4. Unpack the sysroot tarball into a specific folder path.

pushd build/linux
unxz $HOME/riscv-chromium-patch/debian_sid_riscv64-sysroot/debian_starfive_chroot.tar.xz
tar xf $HOME/riscv-chromium-patch/debian_sid_riscv64-sysroot/debian_starfive_chroot.tar
popd

5. Run GN.

gn gen out/nw --args='target_cpu="riscv64" target_os="linux" is_debug=false is_component_ffmpeg=true symbol_level=1 blink_symbol_level=0 use_gnome_keyring=false is_clang=true use_lld=false use_gold=false is_component_build=false'

6. Build the llvm/clang for RISCV.

pushd tools/clang/scripts
./build.py --without-android --without-fuchsia
popd

7. Configure for NW.js.

GYP_CHROMIUM_NO_ACTION=0 ./build/gyp_chromium -I third_party/node-nw/common.gypi -D building_nw=1 -D clang=1 third_party/node-nw/node.gyp -D target_arch=riscv64 -D nwjs_sdk=1 -D disable_nacl=0 -D buildtype=Official

8. Start ninja-build.

ninja -C out/nw nwjs -j128 -k0

9. Build libnode for NW.js.

ninja -C out/Release node -k0
ninja -C out/nw copy_node

10. Build optional features, i.e. chromedriver, browser_tests, etc.

ninja -C out/nw chromedriver

ninja -C out/nw browser_tests

ninja -C out/nw -t clean v8:nwjc
ninja -C out/nw v8:nwjc

ninja -C out/nw minidump_stackwalk

ninja -C out/nw third_party/breakpad:dump_syms

ninja -C out/nw dist

Misc

1. Generate dependency tree from GN.

$ gn desc out/risc64 chrome --tree

2. Launch chromium browser on headless server.

# Print screenshot and save as PDF
$ chrome --headless --disable-gpu --print-to-pdf https://www.google.com

# Capture screenshot
$ chrome --headless --disable-gpu --screenshot https://www.google.com

Note: Running with --screenshot will produce a file named screenshot.png in the current working directory.

Credits

1. PPC Porting Guide: https://wiki.raptorcs.com/wiki/Porting/Chromium
2. SUSE Chromium Port: https://build.opensuse.org/package/show/network:chromium/chromium?expand=1
3. Fedora rawhide Chromium Port: https://src.fedoraproject.org/rpms/chromium/tree/rawhide
4. Github User: https:/felixonmars/archriscv-packages/tree/master/chromium