gf tool chain

GF v1.9版本开始提供了gf命令行开发辅助工具,将会随着框架发展不断完善,作为未来框架发展的一个重要组成部分,工具开源项目地址:https://github.com/gogf/gf-cli

我们推荐通过下载安装预编译的二进制使用。工具安装成功后,可以通过gf或者gf -h查看所有支持的命令。复杂的命令可以通过gf help COMMAND或者gf COMMAND -h查看更详细的使用帮助信息,例如:gf help gengf gen -h

工具运行初始化时将会自动打开Go Modules特性并设置反向代理地址为 https://goproxy.cn

当前帮助文档以gf cli v0.7.5版本为例进行简单的介绍,详细的介绍信息请查看命令行帮助信息。本章内容信息可能会有滞后,最新的具体详细介绍请查看工具帮助信息。

  1. $ gf
  2. USAGE
  3. gf COMMAND [ARGUMENT] [OPTION]
  4. COMMAND
  5. env show current Golang environment variables
  6. get install or update GF to system in default...
  7. gen automatically generate go files for ORM models...
  8. mod extra features for go modules...
  9. run running go codes with hot-compiled-like feature...
  10. init initialize an empty GF project at current working directory...
  11. help show more information about a specified command
  12. pack packing any file/directory to a resource file, or a go file...
  13. build cross-building go project for lots of platforms...
  14. docker create a docker image for current GF project...
  15. swagger swagger feature for current project...
  16. update update current gf binary to latest one (might need root/admin permission)
  17. install install gf binary to system (might need root/admin permission)
  18. version show current binary version info
  19. OPTION
  20. -y all yes for all command without prompt ask
  21. -?,-h show this help or detail for specified command
  22. -v,-i show version information
  23. ADDITIONAL
  24. Use 'gf help COMMAND' or 'gf COMMAND -h' for detail about a command, which has '...'
  25. in the tail of their comments.

install 工具安装

使用方式:./gf install

该命令往往是在gf命令行工具下载到本地后执行(注意执行权限),用于将gf命令安装到系统环境变量默认支持的目录路径中,以便于在系统任何的地方直接可以使用gf工具。

部分系统需要管理员权限支持。

如果是MacOS下使用zsh的小伙伴可能会遇到别名冲突问题,可以通过alias gf=gf来解决,运行一次之后gf工具会自动修改profile中的别名设置,用户重新登录就好了。

version 工具版本查看

使用方式:

  • gf -v
  • gf -i
  • gf version

用以查看当前gf命令行工具编译时的版本信息。例如:

  1. $ gf -v
  2. GoFrame CLI Tool v0.7.5, https://goframe.org
  3. Built Detail:
  4. Go Version: go1.13.5
  5. GF Version: v1.13.0
  6. Git Commit: 0ab2a4a9e753f4f5fae1e96ecf40cae94895d494
  7. Built Time: 2020-06-05 23:30:39

init 项目初始化

使用方式:gf init [NAME]

我们可以使用init命令在当前目录生成一个示例的GF空框架项目,并可给定可选的项目名称参数。生成的项目目录结构仅供参考,根据业务项目具体情况可自行调整。

GF框架开发推荐统一使用官方的go module特性进行依赖包管理,因此空项目根目录下也有一个go.mod文件。

build 交叉编译

使用方式:gf build FILE [OPTION]

仅限于交叉编译使用到GF框架的项目,支持绝大部分常见系统的直接交叉编译。并且支持配置文件管理编译选项、嵌入编译时变量。使用gf build的项目将会默认嵌入以下变量(参考gf -v):

  1. 当前Go版本。
  2. 当前GF版本。
  3. 当前编译时间。
  4. 当前Git Commit(如果存在)。

编译配置文件选项示例(默认读取config.toml):

  1. [compiler]
  2. name = "my-app"
  3. version = "1.0.0"
  4. arch = "386,amd64"
  5. system = "linux,windows,darwin"
  6. output = ""
  7. path = "./bin"
  8. extra = "-ldflags \"-s -w\""
  9. # 自定义编译时内置变量
  10. [compiler.VarMap]
  11. author = "john"
  12. email = "john@goframe.org"

配置选项的释义同命令行同名选项。

编译时的内置变量可以在运行时通过gbuild包获取。

gen 代码生成命令

使用方式:gf gen model [PATH] [OPTION]

gen命令用以自动化从数据库直接生成模型文件。可以参考gf-demos示例项目中的模型文件即是通过该命令生成的:https://github.com/gogf/gf-demos/tree/master/app/model

模型生成采用了Active Record设计模式。该命令将会根据数据表名生成对应的目录,该目录名称即数据表包名。目录下自动生成3个文件:

  1. 数据表名.go 自定义文件,开发者可以自由定义填充的代码文件,仅会生成一次,每一次模型生成不会覆盖。
  2. 数据表名_entity.go 表结构文件,根据数据表结构生成的结构体定义文件,包含字段注释。数据表在外部变更后,可使用gen命令重复生成更新该文件。
  3. 数据表名_model.go 表模型文件,为数据表提供了许多便捷的CURD操作方法,并可直接查询返回该表的结构体对象。数据表在外部变更后,可使用gen命令重复生成更新该文件。

数据表模型生成支持的数据库类型为:MySQL/MariaDBPostgreSQLSQLiteSQLServer。目前暂不支持Oracle,若有需求请联系作者。

run 热编译(自动编译)

使用方式:gf run FILE

由于Go是不支持热编译特性的,每一次代码变更后都要重新手动停止、编译、运行代码文件。run命令也不是实现热编译功能,而是提供了自动编译功能,当开发者修改了项目中的go文件时,该命令将会自动编译当前程序,并停止原有程序,运行新版的程序。

run命令会递归监控当前运行目录的所有go文件变化来实现自动编译。

get 依赖包下载

使用方式:gf get PACKAGE

gf get命令和go get命令类似,内部自动提供了代理设置功能,并智能识别并设置最快的下载代理地址。

docker 镜像编译

使用方式:gf docker [FILE] [OPTIONS]

自动编译并生成docker镜像。非必需FILE参数为编译文件路径,默认为main.go。非必需参数OPTIONSdocker build命令相同参数及选项。

update 工具更新

使用方式:gf update

该命令用以检测gf命令行工具的版本,并自动执行版本更新。

部分系统需要管理员权限支持。如果更新失败,请手动重新下载更新。

pack 二进制打包

使用方式:gf pack SRC DST

该命令用以将任意的文件打包为二进制文件,或者Go代码文件,可将任意文件打包后随着可执行文件一同发布。此外,在build命令中支持打包+编译一步进行,具体请查看build命令帮助信息。

mod 包管理扩展功能

使用方式:gf mod path

该命令用于将当前go modules包拷贝到GOPATH中,以便使用原始的GOPATH方式开发,往往为了方便调试本地开发的依赖包。

help 命令行帮助

使用方式:

  • gf -h
  • gf -?
  • gf help [COMMAND]
  • gf [COMMAND] -h

任何不懂的,就用help看看吧。