Hitchhiker编译

介绍

hitchhiker是一个开源软件，基于nodejs，以typescript语言编写的可视化的web接口文档、测试、压测的工具。支持导入、使用第三方js模块。
源码：https://github.com/brookshi/Hitchhiker
需要切换到release分支

编译环境

nodejs 版本要求7.60+，并更新npm到最新npm install npm -g。本人采用的8.9.4版本。

全局安装

可以参考https://github.com/brookshi/Hitchhiker/blob/release/cn/installation/win.md中的脚本链接https://raw.githubusercontent.com/brookshi/Hitchhiker/release/deploy/win_deploy.bat。使用cnpm吧，快很多。
cnpm install -g yarn gulp-cli gulp typescript@2.3.3

依赖安装

随着typescript版本的提高，一些默认导入的包的版本过高，导致正常编译报错，需要降低某些包的版本。
首先把版本中^全部去掉，只使用特定版本。
在package.json中的devDependencies里增加以下配置：
"@types/connect": "3.4.32",
"@types/koa-compose": "3.2.2",

clients中的package.json中的devDependencies里增加以下配置：
"@types/babel-traverse": "6.25.3",
再安装全部依赖

1. cnpm install
2. cd client
3. cnpm install

打包

取出build、appconfig.json、logconfig.json、mail.json、package.json、pm2.json、sample collection.json放到一个新目录中，将访目录打包，再放到需要的机器上。

运行环境

1. nodejs 版本要求7.60+，并更新npm到最新npm install npm -g。本人采用的8.9.4版本。
2. mysql 版本要求5.7+(支持json)。本人用的5.7.25，最新的8的版本好像不行。这里需要注意一下设定身份验证要使用mysql_native_password这个插件。
   创建用户及数据库，可以自己指定数据库的名称，也可以用hitchhiker。

部署

在目录机器上安装全局及项目依赖
cnpm install -g pm2
cnpm install
运行安装程序
cd build
node setup.js
浏览器访问：http://localhost:9527/setup_cn.html，根据需要配置。
注：

1. 因为采用了websocket，所以如果使用nginx做反向代理的话，需要对nginx做一些处理。
2. 因为css内部引用的图标是采用绝对地址，导致引用出错，所以要改css中的图片地址为相对地址。
   成功后，可以通过pm2 status及pm2 log 0来查看状态及日志，来分析问题原因。以后再启动可以通过在build目录下执行pm2 start pm2.json启动程序。
   然后用pm2 save，来保存配置，用于pm2-windows-service能自动启动。用pm2-windows-service启动的好处是开机自动启动，且无nodejs的弹窗。

服务启动

安装pm2服务：

1. cnpm install -g pm2-windows-service
2. pm2-service-install
   配置环境
   i. PM2_HOME是pm2的主目录，一般是用户目录下.pm2，即c:\users\xxx\.pm2，可以通过pm2 save查看
   ii. PM2_SERVICE_SCRIPTS是启动脚本位置，不用配置，输入n。
   iii. PM2_SERVICE_PM2_DIR是pm2的位置，如果把pm2所在目录加到了path里就不用配置，输入n。
3. 安装成功后，会在服务中看见pm2.exe的服务，自动启动