Skip to main content

快速上手

准备工作​

需要一台安装了 nodejs 和 go 编译环境的主机，本文档以 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。