README.md 2.6 KB

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://github.com/felixonmars/archriscv-packages/tree/master/chromium