一，安装stf首先要安装node
踩坑
node 版本
一般安装node,都是直接brew 安装的
brew install node
这边默认安装的版本比较高，而stf对node的最新版本没有做到完美兼容，所以我们需要安装旧版本的node，以8.x为佳
在github上看，很多人题给作者的问题，作者也会回复了，建议使用8.x
报错bufferutil@1.3.0 install: node-gyp rebuild
我在安装过程中主要是遇到这个问题，报错如下：
gyp ERR! configure error
gyp ERR! stack Error: gyp failed with exit code: 1
gyp ERR! stack at ChildProcess.onCpExit (/Users/dongshichao/.nvm/versions/node/v8.11.0/lib/node_modules/npm/node_modules/node-gyp/lib/configure.js:336:16)
gyp ERR! stack at emitTwo (events.js:126:13)
gyp ERR! stack at ChildProcess.emit (events.js:214:7)
gyp ERR! stack at Process.ChildProcess._handle.onexit (internal/child_process.js:198:12)
gyp ERR! System Darwin 17.5.0
gyp ERR! command "/Users/dongshichao/.nvm/versions/node/v8.11.0/bin/node" "/Users/dongshichao/.nvm/versions/node/v8.11.0/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js" "rebuild"
gyp ERR! cwd /Users/dongshichao/.nvm/versions/node/v8.11.0/lib/node_modules/stf/node_modules/bufferutil
gyp ERR! node -v v8.11.0
gyp ERR! node-gyp -v v3.6.2
gyp ERR! not ok
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! bufferutil@1.3.0 install: node-gyp rebuild
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the bufferutil@1.3.0 install script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.
npm ERR! A complete log of this run can be found in:
npm ERR! /Users/dongshichao/.npm/_logs/2018-12-17T15_00_38_264Z-debug.log
我一开始node版本是10.x，后来安装报上面的错
后来我在github上看到作者给别人的回复，建议使用8.x，我刚换8.11后问题依然存在。
后来又安装8.14，使用8.14安装成功
最终，我的版本是
安装nvm
nvm是node版本管理工具，为了解决node各种版本存在不兼容现象，nvm是让你在同一台机器上安装和切换不同版本的node的工具。
安装nvm
$ brew install nvm
安装完成后，修改环境变量
进入当前用户的Home目录
$ cd ~
编辑.bash_profile文件
$ vim .bash_profile
按 i 进入编辑模式
在文件里添加以下内容
export NVM_DIR="$HOME/.nvm"
# This loads nvm
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
# This loads nvm bash_completion
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
然后按 esc 退出编辑模式
按:wq 保存并退出
输入以下命令，更新配置过的环境变量
$ source .bash_profile
查看nvm版本
$ nvm --version
如果出现版本号，则说明安装成功
查看本地node的所有版本
$ nvm list
切换到指定的node版本
$ nvm use 10.19
卸载指定的node版本
$ nvm uninstall 版本号
安装最新的node稳定版本
$ nvm install --lts
查看node的所有的版本
$ nvm ls-remote
使用node指定版本执行指定文件
$ nvm exec 版本号 node 要执行的文件路径
注意：如果node安装了好几个版本，在安装stf的时候，有版本高的会报错，这个时候，把.nvm 安装的目录直接删除了，重新安装,直接装8.x版本的
nvm的注意事项：Mac 安装nvm、删除nvm
安装&更新
1.使用 cURL 安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash
2.使用 Wget 安装脚本
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash
验证安装
command -v nvm
-
验证成功
image.png -
验证失败
image.png
- 系统可能没有
.bash_profile file设置命令的。只需创建一个touch ~/.bash_profile并再次运行安装脚本，重新启动终端实例。
2.打开.bash_profile并添加以下代码行：
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
然后 source 一下 .bash_profile
source ~/.bash_profile
删除 nvm(很重要)
- 卸载 nvm
nvm unload - 手动卸载
$ rm -rf "$NVM_DIR"
二，使用homebrew方式安装终端中输入指令
1.安装依赖
brew install rethinkdb graphicsmagick zeromq protobuf yasm pkg-config
2.安装ADB
brew cask install android-platform-tools
3.安装STF
sudo npm install --unsafe-perm --verbose -g stf
为啥启动stf的时候要用--unsafe-perm？
npm 出于安全考虑不支持以 root 用户运行，即使你用 root 用户身份运行了，npm 会自动转成一个叫 nobody 的用户来运行，而这个用户几乎没有任何权限。这样的话如果你脚本里有一些需要权限的操作，比如写文件（尤其是写 /root/.node-gyp），就会崩掉了。
为了避免这种情况，要么按照 npm 的规矩来，专门建一个用于运行 npm 的高权限用户；要么加 --unsafe-perm 参数，这样就不会切换到 nobody 上，运行时是哪个用户就是哪个用户，即使是 root。
启动STF
1.首先启动rethinkdb
rethinkdb
2.新建一个终端连接ADB
adb start-server
adb connect 10.200.241.215
adb devices
3.新建一个终端启动stf
DEBUG=adb* stf local --allow-remote
如果远程访问执行下面这个命令
stf local --public-ip 本机IP
4.打开浏览器输入地址看到界面就启动成功了
http://localhost:7100/
遇到已知问题和解决方案
1.启动rethinkdb端口占用导致启动不起来，之前电脑上安装有jenkins占用端口号，停止jenkins服务就 可以
2.启动stf时候使用命令不同导致启动不起来
