# 定制 Botfront

如果你想加入 Botfront 的开发或者做一些自定义功能,可以参考一下步骤在本地搭建运行环境。

# 安装配置

  1. Botfront 基于 Meteor 开发,所以首先要安装 Meteor
  2. 拉下代码,安装依赖项
git clone https://github.com/botfront/botfront
cd botfront/botfront
meteor npm install

提示

Meteor 有自己的 Node.js 和 NPM,所以安装的时候最好用 meteor npm install 而不是 (npm install)

# 运行

  • 默认配置: meteor npm start Botfront 依赖多个 docker 服务,所以开发之前首先需要通过 docker-compose 启动这些服务,值得注意的是需要在 Botfront 生成的项目根目录下执行这些指令才行。
  1. 首先创建一个 botfront 项目 botfront init
  2. 启动项目 botfront up -e botfront,这个指令会启动除了 Botfront 应用之外的所有依赖服务。
  3. 在 botfront 项目根目录下重启 meteor 服务 meteor reset (会 删 除 数 据 库!).
  4. 启动 Botfront 应用: meteor npm run start:docker-compose.dev. 访问 http://localhost:3000 查看结果

# 文档

  • 本地查看: npm run docs:dev
  • 文档编译 : npm run docs:build

本文档是通过 Vuepress 生成的

# 编写、运行测试用例

可以通过 npx cypress run 运行测试用例,或者以交互的方式运行: npx cypress open

::: 注意注意!千万不要在有重要数据的环境下运行测试用例!因为测试用例启动的时候会做些初始化动作,在这个过程中 会 删 除 数 据 库!. :::