mirror of
https://github.com/unknwon/the-way-to-go_ZH_CN.git
synced 2025-08-12 05:33:04 +08:00
9.7
This commit is contained in:
@@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
## 翻译进度
|
## 翻译进度
|
||||||
|
|
||||||
9.5 [自定义包和可见性](eBook/09.5.md)
|
9.7 [使用 go install 安装自定义包](eBook/09.7.md)
|
||||||
|
|
||||||
## 支持本书
|
## 支持本书
|
||||||
|
|
||||||
|
@@ -1,29 +1,29 @@
|
|||||||
# 9.6 为自定义包使用 godoc
|
# 9.6 为自定义包使用 godoc
|
||||||
|
|
||||||
208
|
godoc工具(第 3.6 节)在显示自定义包中的注释也有很好的效果:注释必须以 // 开始并无空行放在声明(包,类型,函数)前。godoc 会为每个文件生成一系列的网页。
|
||||||
godoc工具(3.6章节)在显示自定义包中的注释也有很好的效果:注释必须以//开始并无空行放在声明(包,类型,函数)前。godoc会为每个文件生成一系列的网页。
|
|
||||||
|
|
||||||
例如:
|
例如:
|
||||||
|
|
||||||
-在do_examples目录下我们有11.7章节中的用来排序的go文件,文件中有一些注释(文件需要未编译)
|
- 在 do_examples 目录下我们有第 11.7 节中的用来排序的 go 文件,文件中有一些注释(文件需要未编译)
|
||||||
|
|
||||||
- 命令行下进入目录下并输入命令:
|
- 命令行下进入目录下并输入命令:
|
||||||
|
|
||||||
godoc -http =:6060 -paht="."
|
godoc -http =:6060 -paht="."
|
||||||
|
|
||||||
(.是指当前目录,-path参数可以是/path/to/my/package1这样的形式指出package1在你源码中的位置或接受用冒号形式分隔的路径,无根目录的路径为相对于当前目录的相对路径)
|
(`.` 是指当前目录,-path 参数可以是 /path/to/my/package1 这样的形式指出 package1 在你源码中的位置或接受用冒号形式分隔的路径,无根目录的路径为相对于当前目录的相对路径)
|
||||||
|
|
||||||
-在浏览器打开地址 http://localhost:6060
|
- 在浏览器打开地址:http://localhost:6060
|
||||||
|
|
||||||
|
然后你会看到本地的 godoc 页面(详见第 3.6 节)从左到右一次显示出目录中的包:
|
||||||
|
|
||||||
然后你会看到本地的godoc页面(参见3.6章节)从左到右一次显示出目录中的包
|
|
||||||
doc_example:
|
doc_example:
|
||||||
|
|
||||||
doc_example | Packages | Commands | Specification
|
doc_example | Packages | Commands | Specification
|
||||||
|
|
||||||
下面是链接到源码和所有对象时有序概述(所以是很好的浏览和查找源代码的方式),连同文件/评论。
|
下面是链接到源码和所有对象时有序概述(所以是很好的浏览和查找源代码的方式),连同文件/注释:
|
||||||
|
|
||||||
sort 包
|
sort 包
|
||||||
|
|
||||||
|
```go
|
||||||
func Float64sAreSorted
|
func Float64sAreSorted
|
||||||
|
|
||||||
type IntArray
|
type IntArray
|
||||||
@@ -31,6 +31,7 @@ type IntArray
func IntsAreSortedfunc IsSortedfunc Sort
|
|||||||
func IntsAreSortedfunc IsSortedfunc Sort
|
func IntsAreSortedfunc IsSortedfunc Sort
|
||||||
|
|
||||||
func (IntArray) Len
|
func (IntArray) Len
|
||||||
|
|
||||||
func SortFloat64s
|
func SortFloat64s
|
||||||
|
|
||||||
|
func (IntArray) Less
|
@@ -6,32 +6,40 @@ go install是Go中自动包安装工具:如需要将包安装到本地它会
|
|||||||
|
|
||||||
被安装包的列表可以在 $GORROT/goinstall.log 找到。
|
被安装包的列表可以在 $GORROT/goinstall.log 找到。
|
||||||
|
|
||||||
go install使用了GOPATH变量(参见2.2章节)。
|
go install 使用了 GOPATH 变量(详见第 2.2 节)。
|
||||||
|
|
||||||
远端包(参见9.5章节):
|
远端包(详见第 9.5 节):
|
||||||
|
|
||||||
假设我们要安装一个有趣的包tideland(它包含了许多帮助示例,参见http://code.google.com/p/tideland-cgl)。
|
假设我们要安装一个有趣的包 tideland(它包含了许多帮助示例,参见:http://code.google.com/p/tideland-cgl)。
|
||||||
|
|
||||||
因为我们需要创建目录在 Go 安装目录下,所以我们需要使用 root 或者 su 的身份执行命令。
|
因为我们需要创建目录在 Go 安装目录下,所以我们需要使用 root 或者 su 的身份执行命令。
|
||||||
|
|
||||||
确保 Go 环境变量已经设置在 root 用户下的 ./bashrc 文件中。
|
确保 Go 环境变量已经设置在 root 用户下的 ./bashrc 文件中。
|
||||||
|
|
||||||
使用命令安装:go install tideland-cgl.googlecode.com/hg
|
使用命令安装:`go install tideland-cgl.googlecode.com/hg`
|
||||||
|
|
||||||
可执行文件 hg.a 将被放到 $GOROOT/pkg/linux_amd64/tideland-cgl.googlecode.com 目录下,源码文件被放置在 $GOROOT/src/tideland-cgl.googlecode.com/hg 目录下,同样有个 hg.a 放置在 _obj 的子目录下。
|
可执行文件 hg.a 将被放到 $GOROOT/pkg/linux_amd64/tideland-cgl.googlecode.com 目录下,源码文件被放置在 $GOROOT/src/tideland-cgl.googlecode.com/hg 目录下,同样有个 hg.a 放置在 _obj 的子目录下。
|
||||||
|
|
||||||
现在就可以在 go 代码中使用这个包中的功能了,例如使用报名 cgl 导入:
|
现在就可以在 go 代码中使用这个包中的功能了,例如使用报名 cgl 导入:
|
||||||
|
|
||||||
|
```go
|
||||||
import cgl "tideland-cgl.googlecode.com/hg"
|
import cgl "tideland-cgl.googlecode.com/hg"
|
||||||
|
```
|
||||||
|
|
||||||
从Go1起go install安装Google Code的导入路径形式是:"code.google.com/p/tideland-cgl"
|
从 Go1 起 go install 安装 Google Code 的导入路径形式是:`"code.google.com/p/tideland-cgl"`
|
||||||
|
|
||||||
升级到新的版本:
|
升级到新的版本:
|
||||||
|
|
||||||
更新到新版本的Go之后本地安装包的二进制文件将全被删除。当调用install-a工具将通过读取$GOROOT/goinstall.log重新安装以前的安装包。如果你想更新,重编译,重安装所有的go安装包可以使用:go install -a -u -clean 或者 go install -a -u -nuke
|
更新到新版本的 Go 之后本地安装包的二进制文件将全被删除。当调用 install -a 工具将通过读取 $GOROOT/goinstall.log 重新安装以前的安装包。如果你想更新,重编译,重安装所有的go安装包可以使用:`go install -a -u -clean` 或者 `go install -a -u -nuke`。
|
||||||
|
|
||||||
go 的版本发布的很频繁,所以需要注意发布版本和包的兼容性。go1 之后都是自己编译自己了。
|
go 的版本发布的很频繁,所以需要注意发布版本和包的兼容性。go1 之后都是自己编译自己了。
|
||||||
|
|
||||||
go install同样可以使用go install编译链接并安装本地自己的包:参见9.8.2章节。
|
go install 同样可以使用 go install 编译链接并安装本地自己的包(详见第 9.8.2 节)。
|
||||||
|
|
||||||
更多信息可以在 http://golang.org/cmd/go 和 http://golang.org/cmd/goinstall 找到。
|
更多信息可以在 http://golang.org/cmd/go 和 http://golang.org/cmd/goinstall 找到。
|
||||||
|
|
||||||
|
## 链接
|
||||||
|
|
||||||
|
- [目录](directory.md)
|
||||||
|
- 上一节:[为自定义包使用 godoc](09.6.md)
|
||||||
|
- 下一节:[自定义包的目录结构、go install 和 go test](09.8.md)
|
||||||
|
@@ -1,5 +1,6 @@
|
|||||||
#9.8 自定义包:目录结构,go install和go test
|
# 9.8 自定义包的目录结构、go install 和 go test
|
||||||
|
|
||||||
|
212
|
||||||
为了示范,我们创建了一个名为uc的简单包,它含有一个UpperCase函数将字符串的所有字母转换为大写。当然这并不值得创建一个自己包,同样的功能已被包含在"strings"包里,但是同样的技术也可以应用在更复杂的包中。
|
为了示范,我们创建了一个名为uc的简单包,它含有一个UpperCase函数将字符串的所有字母转换为大写。当然这并不值得创建一个自己包,同样的功能已被包含在"strings"包里,但是同样的技术也可以应用在更复杂的包中。
|
||||||
##9.8.1 自定义包的目录结构
|
##9.8.1 自定义包的目录结构
|
||||||
下面的结构给了你一个好的示范(uc代表通用包名, 名字为粗体的代表目录,斜体代表可执行文件):
|
下面的结构给了你一个好的示范(uc代表通用包名, 名字为粗体的代表目录,斜体代表可执行文件):
|
||||||
|
@@ -79,6 +79,8 @@
|
|||||||
- 9.4 [精密计算和 big 包](09.4.md)
|
- 9.4 [精密计算和 big 包](09.4.md)
|
||||||
- 9.5 [自定义包和可见性](09.5.md)
|
- 9.5 [自定义包和可见性](09.5.md)
|
||||||
- 9.6 [为自定义包使用 godoc](09.6.md)
|
- 9.6 [为自定义包使用 godoc](09.6.md)
|
||||||
|
- 9.7 [使用 go install 安装自定义包](09.7.md)
|
||||||
|
- 9.8 [自定义包的目录结构、go install 和 go test](09.8.md)
|
||||||
- 第10章:结构(struct)与方法(method)
|
- 第10章:结构(struct)与方法(method)
|
||||||
- 第11章:接口(interface)与反射(reflection)
|
- 第11章:接口(interface)与反射(reflection)
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user