运行stf所需环境
Node.js 8.x required (some dependencies don't support newer versions)
ADB properly set up
RethinkDB >= 2.2
CMake >= 3.9 (for node-jpeg-turbo)
GraphicsMagick (for resizing screenshots)
ZeroMQ libraries installed
Protocol Buffers libraries installed
yasm installed (for compiling embedded libjpeg-turbo)
pkg-config so that Node.js can find the libraries
1.安装homebrew
/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"
安装完成 brew -v 可以看到 brew版本 则表示安装成功
安装参考教程链接: https://www.jianshu.com/p/e0471aa6672d?utm_campaign=hugo
2.通过homebrew安装大部分环境
brew install rethinkdb graphicsmagick zeromq protobuf yasm pkg-config cmake
3.安装NodeJs (建议: v8.10 <= NodeJs版本 <= v10)
作者这里使用nvm来管理node版本
使用brew安卓nvm
brew install nvm
安装完成后 配置环境变量
cd ~
vim .bash_profile
在文件中添加
export NVM_DIR=~/.nvm
source $(brew --prefix nvm)/nvm.sh
然后执行source命令
source .bash_profile
使用nvm安装管理node版本相关指令
nvm ls-remote 查看 所有的node可用版本
nvm install xxx 下载你想要的版本
nvm use xxx 使用指定版本的node
nvm alias default xxx 每次启动终端都使用该版本的node
安装完成后 查看版本号 满足范围即可
4.命令行启动rethinkdb 启动成功如下图 默认端口8080
5.配置adb环境变量
创建bash_profile文件
touch .bash_profile
打开并编辑bash_profile文件
open -e .bash_profile
添加下列内容
ANDROID_HOME=/Users/YourUsername/Library/Android/sdkexport
PATH=$PATH:$ANDROID_HOME/toolsexport
PATH=$PATH:$ANDROID_HOME/platform-tools
保存并关闭.bash_profile文件
运行source 生效配置
source .bash_profile
输入adb查看 没有出现command not found就是配置成功了
如果使用的oh my zsh的shell按照以上的配置在关掉terminal之后会失效 需要另外配置一下
执行下面命令编辑文件:
vim ~/.zshrc
在文末 添加
#Enable my profile
source ~/.bash_profile
执行命令生效
source ~/.zshrc
6.安装stf(不需要修改源码)
npm install -g stf
7.从stf-master源码构建stf项目(需要修改源码)
官方的build项目解释(在上述环境都正确安装后)
在stf-master项目目录下执行指定安装依赖环境
在安装了所有需求之后，就可以获取其余的依赖项了。
首先，获取所有的NPM和Bower模块:
npm install
你也可以链接模块，这样你就可以直接从命令行访问stf命令:
npm link
8.运行stf-master源码项目
在stf-master项目目录下启动指令
./bin/stf local
9.运行项目相关指令
指定ip运行stf项目
stf local --public-ip <your_internal_network_ip_here>
10.关于更新代码
要更新开发版本，只需拉出repo并再次运行npm install。你可能偶尔需要删除整个node_modules和res/bower_components文件夹，以防止NPM或Bower抱怨版本不匹配。
异常情况:
1.brew install 执行异常
提示找不到对应bottle 查询了 homebrew官网 对应的包 只支持如下的mac系统 升级系统就完事了
homebrew官网地址: https://formulae.brew.sh/
2.执行npm install -g stf安装stf时异常:
zmq安装有问题(可能资源下载不全) 卸载zmq重新安装即可
3.执行./bin/stf local 运行stf-master源码异常:
zmq环境问题 网上说法比较多 这边试了好多种方法
最后是先卸载之前的zmq 然后 重新安装 zmq 然后删除源码stf-master项目下
/node_moudles文件夹 及 /res/web_modules文件夹
重新执行 npm install 即可
brew uninstall zeromq
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install zeromq
4.运行项目./bin/stf local 异常报错
bower依赖包没安装成功
5.bower install 安装异常报错
