shilang 发表于 2018-1-6 17:46:05

Golang Vendor 包管理工具 glide 使用教程

  Glide 是 Golang 的 Vendor 包管理器,方便你管理 vendor 和 verdor 包。类似 Java 的 Maven,PHP 的 Composer。


[*]Github:https://github.com/Masterminds/glide
[*]在线文档:http://glide.readthedocs.io/en/stable
  主要特性:


[*]  简单管理依赖

[*]  支持 versioning packages,包括 Semantic Versioning 2.0.0 支持

[*]  支持 aliasing packages (e.g. for working with github forks)

[*]  Remove the need for munging import statements

[*]  支持所有 go 工具

[*]  支持 VCS 工具和 Go 支持:git、bzr、hg、svn

[*]  支持定制本地和全局插件 (see docs/plugins.md)

[*]  仓库缓存

  结构:
  

- $GOPATH/src/myProject(Your project)  
|
  
|-- glide.yaml
  
|
  
|-- glide.lock
  
|
  
|-- main.go (Your main go code can live here)
  
|
  
|-- mySubpackage (You can create your own subpackages, too)
  
|    |
  
|    |-- foo.go
  
|
  
|-- vendor
  
|-- github.com
  
|
  
|-- Masterminds
  
|
  
|-- ... etc.
  

安装
  

# 下载源码包(目前版本:0.12.3)  
go get github.com/Masterminds/glide
  

  
# 进入目录
  
cd github.com/Masterminds/glide
  

  
# 编译
  
# 注意,如果是离线安装的话,需要执行 go install
  
make build
  
go build -o glide -ldflags "-X main.version=v0.11.0" glide.go
  

使用

检测项目的依赖包
  Glide 能检测项目的依赖包 并且 创建一个名为 glide.yaml 的文件。能自动识别 Godep, GPM, Gom, and GB 等工具的配置文件。在 项目的 根目录 执行如下命令:

  glide init

  运行 glide init 命令的时候,会询问你是否需要以向导的方式提示及配置依赖包的版本,每步操作都需要你的确认。

更新 依赖包
  执行如下命令,依据配置文件 glide.yaml 的内容,计算各个依赖包的精确版本号:

  glide up

  “up”是“update”的简写。这个命令会根据 glide.yaml 文件计算所需依赖包,并递归计算依赖包所需依赖包,并且确认各个依赖包的版本号。最后把这些信息写到一个名为 glide.lock 的文件中。
  Glide 会把所有依赖包放到项目根目录的 vendor/ 目录下。如果某个依赖包有自己的 vendor/ 目录,默认情况下,Glide 不会删除它。go 工具链会使用它们的嵌套版本。如果想移除它们,使用 up 或 install 命令时,再加一个 --strip-vendor 或 -v 标签。

安装 依赖包
  如果想下载所需依赖包,执行如下命令:

  glide install

  这个命令会做以下 2 件事:
  (1) 如果 glide.lock 文件已经存在,Glide 会把 glide.lock 中已经计算好的确定版本号的依赖包批量下载到 vendor/ 目录下;
  (2) 如果 glide.local 文件不存在,则会先执行 update 命令;

增加更多的 依赖包
  使用 get 命令,Glide 能帮你添加更多的依赖包到 glide.yaml 文件中,如下所示:

  glide get github.com/Masterminds/semver

  glide get 命令功能 类似 go get,但是它会把依赖包下载到 vendor/ 目录,并且把相关信息配置到 glide.yaml 文件。
  这个 get 命令 也可以带版本号,如下所示:

  glide get github.com/Masterminds/semver#~1.2.0

  “#”是依赖包 和 版本号的分隔符,版本号可以是 语义版本,范围版本,分支版本,标签 或 提交的版本ID。
  如果没有指定 具体版本号 或 范围版本号, Glide 会使用 语义版本号,并且提示要求你确认所需要的版本号

  注意:
  glide 会把下载下来的包缓存到~/.glide/cache 目录下 。


版本号的指定(version字段)
  Glide 支持 语义版本,范围版本,分支版本,标签版本,版本ID 最为版本号。

基本范围
  举个简单例子,范围版本 > 1.2.3,表示 Glide 会用 大于 1.2.3 以后的最新版本。目前支持如下操作符:


[*]=: equal (aliased to no operator)
[*]!=: not equal
[*]>: greater than
[*]<: less than
[*]>=: greater than or equal to
[*]<=: less than or equal to
  它们还可以组合用,“,”表示 “逻辑与”,“||”表示“逻辑或”,如 ">= 1.2, < 3.0.0 || >= 4.2.3"

连字符范围


[*]1.2 - 1.4.5 which is equivalent to >= 1.2, <= 1.4.5
[*]2.3.4 - 4.5 which is equivalent to >= 2.3.4, <= 4.5
通配符比较
  字符 “x”、“X”、"*" 可以当做通配符,它可以应用于所有的比较操作中。当应用于“=”操作符中,它表示补丁最低级别的比较,如下所示:


[*]1.2.x is equivalent to >= 1.2.0, < 1.3.0
[*]>= 1.2.x is equivalent to >= 1.2.0
[*]<= 2.x is equivalent to < 3
[*]* is equivalent to >= 0.0.0
波浪线 范围比较(补丁)
  波浪线比较操作符主要用于补丁级别范围比较,当为次要版本数字没指定时,次要版本不变,主版本修改。如下所示:


[*]~1.2.3 is equivalent to >= 1.2.3, < 1.3.0
[*]~1 is equivalent to >= 1, < 2
[*]~2.3 is equivalent to >= 2.3, < 2.4
[*]~1.2.x is equivalent to >= 1.2.0, < 1.3.0
[*]~1.x is equivalent to >= 1, < 2
脱字符 范围比较(主版本)
  脱字符比较操作符是 为主版本号修改服务的。通常用于接口 主版本比较,如下所示:


[*]^1.2.3 is equivalent to >= 1.2.3, < 2.0.0
[*]^1.2.x is equivalent to >= 1.2.0, < 2.0.0
[*]^2.3 is equivalent to >= 2.3, < 3
[*]^2.x is equivalent to >= 2.0.0, < 3
glide.yaml 文件
  文件 glide.yaml 包含了 当前包(项目)及依赖包 的相关信息,以下示例罗列了该文件的主要元素:
  

package: github.com/Masterminds/glide  
homepage: https://masterminds.github.io/glide
  
license: MIT
  
owners:
  
- name: Matt Butcher
  
email: technosophos@gmail.com
  
homepage: http://technosophos.com
  
- name: Matt Farina
  
email: matt@mattfarina.com
  
homepage: https://www.mattfarina.com
  
ignore:
  
- appengine
  
excludeDirs:
  
- node_modules
  
import:
  
- package: gopkg.in/yaml.v2
  
- package: github.com/Masterminds/vcs
  
version: ^1.2.0
  
repo:    git@github.com:Masterminds/vcs
  
vcs:   git
  
- package: github.com/codegangsta/cli
  
version: f89effe81c1ece9c5b0fda359ebd9cf65f169a51
  
- package: github.com/Masterminds/semver
  
version: ^1.0.0
  
testImport:
  
- package: github.com/arschles/assert
  

  有以下元素:


[*]package: 顶级包导入路径,即 相对 GOPATH/src 的包的导入路径。
[*]homepage: 项目的主页,如 http://k8s.io 。
[*]license: 项目的使用权协议。
[*]owners: 项目的作者信息,如 姓名、联系方式(email)、个人主页 等。
[*]ignore: 需要忽略导入的包名列表。注意,不是文件夹名。
[*]excludeDirs: 需要忽略扫描依赖包的文件夹列表。
[*]import: 需要导入的依赖包,每个依赖包 包含以下元素:

[*]package: 包路径信息。
[*]version: 版本号,如 语义版本、范围版本、分支版本、标签版本、提交号版本等,更多的信息查看文档:versioning documentation。
[*]repo: 包的仓库地址信息。如果包名不是包仓库路径信息 或者是 私有仓库,可以从线上的仓库 check out 文件到 包名中指定的(本地)路径,也可以使用 fork 指令。
[*]vcs: 使用到的版本控制系统,如 git、hg、bzr 或 svn。如果不能从上述的 package 中确定 版本控制系统类型的话,需要在这里指定。如 仓库路径带有 .git 后缀 或 GitHub 仓库路径 等都可以自动识别类型为 git。
[*]subpackages: 当前包所使用到的子包名列表。
[*]os: 能适用于哪些操作系统? 与 运行时(runtime) 当中的 操作系统变量(GOOS) 匹配比较,如果是匹配上,就获取该包。
[*]arch: 能使用于哪些结构?与 运行时(runtime) 当中的 runtime architecture 变量(GOARCH)匹配比较,如果匹配上,就获取该包。

[*]testImport: 用于测试的包。
  翻译自 官方教程:
  http://glide.readthedocs.io/en/stable/versions/
  延伸阅读:
  .yaml 文件格式简介
  【Go命令教程】命令汇总
  【推荐】Golang Vendor 包机制 及 注意事项
页: [1]
查看完整版本: Golang Vendor 包管理工具 glide 使用教程