Skip to main content

快速上手

准备工作

需要一台安装了 nodejsgo 编译环境的主机,本文档以 MacOS 为例, 其他系统需要做适当的调整。

启动项目

创建新仓库

打开 ReactGo 模板仓库, 在页面中找到 Use this template 绿色按钮,点击它(懒得找直接点 这里 也行), 将开始创建一个新的仓库,按照页面的提示创建仓库,完成后 clone 到你的开发机。

初始化数据库

这一步将创建数据库和数据表,ReactGO 支持 Sqlite, MySQL, 以及 PostgreSQL

这里以 Sqlite 为例,打开一个终端窗口,进入 migrate 子目录,有 3 种方式可用:

  1. 使用 migrate 命令(这是推荐的方式):

    ./migrate-sqlite.sh up

    创建的数据库文件为 /tmp/reactgo.db

    安装 migrate

    可以从 migrate 项目页 下载对应的版本安装, 请注意,该版本不支持 Sqlite 驱动,如果要用 Sqlite 驱动,还需要从源码编译。

  2. 使用 sqlite3 命令(临时方案,不推荐):

    如果你暂时不想安装 migrate 工具,你可以用 sqlite3 命令初始化数据库,这需要安装 sqlite3 工具。

    sqlite3 /tmp/reactgo.db -init ./001_v0.up.sql --version
  3. 直接将 001_v0.up.sql 中的 SQL 语句复制到你的数据库客户端执行(临时方案,不推荐)。

启动前端

开一个终端窗口,进入仓库 web 子目录,运行 yarn 安装 npm 模块, 然后运行 yarn build 构建,完了运行 yarn start 启动前端开发服务器, 会在浏览器打开登录页面。 一共要运行 3 个命令。

ReactGO

启动后端

运行 make ,完了运行 ./reactgo -adduser -config ./config.yaml, 按照提示添加一个后台用户(注意会在终端打印一个随机密码,登录需要)。

运行 make dev 启动后台服务,然后转到浏览器,使用刚刚创建的用户登录。

遇到问题

我们的目标是让系统即可能的简单,如果你按照上面的操作出现问题,说明系统还不够简单,请 提交一个 issue。 如果是网络连接方面的问题,例如不能访问 npm 或 github 网站,那需要自行在网上找一些方法。

更多

启动 ReactGO 非常的容易,开发也是同样的简单,ReactGO 面向套路编程,在开发时只需要掌握好套路, 就能得心应手的进行开发,并得到不错的结果,你可以用 Lighthouse 评估一下网站得分, 或使用 WAVE 评估一下可访问性,或者使用你信赖的工具评估一下性能。

下一步将了解 ReactGO 的套路,掌握这些套路后,你就完全掌握了 ReactGO。