MacOs下stf环境搭建

运行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

安装完成后 查看版本号 满足范围即可

查看node版本号

4.命令行启动rethinkdb 启动成功如下图 默认端口8080

启动rethinkdb

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项目解释(在上述环境都正确安装后)

官方文档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

10.关于更新代码

更新代码

要更新开发版本，只需拉出repo并再次运行npm install。你可能偶尔需要删除整个node_modules和res/bower_components文件夹，以防止NPM或Bower抱怨版本不匹配。

异常情况:

1.brew install 执行异常

brew异常

提示找不到对应bottle 查询了 homebrew官网 对应的包 只支持如下的mac系统 升级系统就完事了

homebrew官网地址: https://formulae.brew.sh/

homebrew支持系统版本

2.执行npm install -g stf安装stf时异常:

npm安装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 安装异常报错

bower install异常