stf 安装使用和注意事项

一，安装stf首先要安装node

踩坑
node 版本

一般安装node,都是直接brew 安装的

brew install node

这边默认安装的版本比较高，而stf对node的最新版本没有做到完美兼容，所以我们需要安装旧版本的node，以8.x为佳

在github上看，很多人题给作者的问题，作者也会回复了，建议使用8.x

报错[email protected] 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! [email protected] install: node-gyp rebuild
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] 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

image.png

安装完成后，修改环境变量

进入当前用户的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
如果出现版本号，则说明安装成功

image.png

查看本地node的所有版本

$ nvm list

image.png

切换到指定的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

1. 系统可能没有 .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服务就 可以

截屏2020-09-09 下午4.48.02.png

2.启动stf时候使用命令不同导致启动不起来

截屏2020-09-09 下午4.48.43.png