Webviz - ROS可視化開源項目 - 本地構建教程

1. 安裝 nvm

nvm 是nodejs的版本管理器，類似 Anaconda（python的版本管理器）

#預備工作
sudo apt-get update
sudo apt-get install build-essential libssl-dev

#獲取腳本並安裝
#方法一
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
#方法二
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

#更換源為淘寶鏡像
#方法一（臨時）
NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node
#方法二（永久）
#在 ~/.bashrc 中添加下列語句
export NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node

2. 安裝nodejs

直接使用nvm進行node安裝和版本控制

Webviz項目暫時僅支持 node10 和 node11，高版本的 node 會出現編譯錯誤。

#查看可安裝的node版本
nvm ls-remote
#安裝指定版本的node
nvm install 10.19.0
#查看當前的node版本
nvm current
#查看已安裝的node版本
nvm list
#選擇需要的node版本
nvm use 10.19.0

3. 換源加速

在國內使用node的npm工具來安裝依賴包常常失敗，多是網絡的問題

#更換npm源為淘寶的源
npm config set registry https://registry.npm.taobao.org
#檢查是否配置成功
npm config get registry

#運行下面的命令可以恢復成官方的源
npm config set registry https://registry.npmjs.org

如果在本地構建時出現下載chromium過慢，可以嘗試以下操作

npm config set puppeteer_download_host=https://npm.taobao.org/mirrors

4. 本地構建

更多本地構建的操作請看項目README

1. 克隆項目到本地

   git clone https://github.com/cruise-automation/webviz.git
   cd webviz/
   

2. 安裝依賴

   #建議先手動安裝node-sass
   npm config set sass_binary_site https://npm.taobao.org/mirrors/node-sass/
   npm install node-sass
   #執行腳本安裝項目依賴
   npm run bootstrap
   

   

3. 編譯項目

   npm run build
   

   
   

4. 運行項目

   npm run docs
   

   
   
   

5. 運行視頻