|
@@ -1,14 +1,31 @@
|
|
|
# 9.8 自定义包的目录结构、go install 和 go test
|
|
# 9.8 自定义包的目录结构、go install 和 go test
|
|
|
|
|
|
|
|
-为了示范,我们创建了一个名为 uc 的简单包,它含有一个 UpperCase 函数将字符串的所有字母转换为大写。当然这并不值得创建一个自己包,同样的功能已被包含在 "strings" 包里,但是同样的技术也可以应用在更复杂的包中。
|
|
|
|
|
|
|
+为了示范,我们创建了一个名为 uc 的简单包,它含有一个 `UpperCase` 函数将字符串的所有字母转换为大写。当然这并不值得创建一个自己包,同样的功能已被包含在 `strings` 包里,但是同样的技术也可以应用在更复杂的包中。
|
|
|
|
|
|
|
|
## 9.8.1 自定义包的目录结构
|
|
## 9.8.1 自定义包的目录结构
|
|
|
|
|
|
|
|
下面的结构给了你一个好的示范(uc 代表通用包名, 名字为粗体的代表目录,斜体代表可执行文件):
|
|
下面的结构给了你一个好的示范(uc 代表通用包名, 名字为粗体的代表目录,斜体代表可执行文件):
|
|
|
|
|
|
|
|
- /home/user/goprograms
ucmain.go (uc包主程序)
Makefile (ucmain的2-makefile)
ucmain
src/uc (包含uc包的go源码)
uc.go
uc_test.go
Makefile (包的1-makefile)
uc.a
_obj
uc.a
_test
uc.a
bin (包含最终的执行文件)
ucmain
pkg/linux_amd64
uc.a (包的目标文件)
|
|
|
|
|
-
将你的项目放在 goprograms 目录下(你可以创建一个环境变量 GOPATH,详见第 2.2/3 章节:在 .profile 和 .bashrc 文件中添加 `export GOPATH=/home/user/goprograms`),而你的项目将作为 src 的子目录。uc 包 中的功能在 uc.go 中实现。
|
|
|
|
|
-
|
|
|
|
|
|
|
+ /home/user/goprograms
|
|
|
|
|
+ ucmain.go (uc包主程序)
|
|
|
|
|
+ Makefile (ucmain的2-makefile)
|
|
|
|
|
+ ucmain
|
|
|
|
|
+ src/uc (包含uc包的go源码)
|
|
|
|
|
+ uc.go
|
|
|
|
|
+ uc_test.go
|
|
|
|
|
+ Makefile (包的1-makefile)
|
|
|
|
|
+ uc.a
|
|
|
|
|
+ _obj
|
|
|
|
|
+ uc.a
|
|
|
|
|
+ _test
|
|
|
|
|
+ uc.a
|
|
|
|
|
+ bin (包含最终的执行文件)
|
|
|
|
|
+ ucmain
|
|
|
|
|
+ pkg/linux_amd64
|
|
|
|
|
+ uc.a (包的目标文件)
|
|
|
|
|
+
|
|
|
|
|
+将你的项目放在 goprograms 目录下(你可以创建一个环境变量 GOPATH,详见第 2.2/3 章节:在 .profile 和 .bashrc 文件中添加 `export GOPATH=/home/user/goprograms`),而你的项目将作为 src 的子目录。uc 包 中的功能在 uc.go 中实现。
|
|
|
|
|
+
|
|
|
示例 9.6 [uc.go](examples/chapter_9/uc.go):
|
|
示例 9.6 [uc.go](examples/chapter_9/uc.go):
|
|
|
|
|
|
|
|
```go
|
|
```go
|
|
@@ -53,21 +70,23 @@ func TestUC(t *testing.T) {
|
|
|
|
|
|
|
|
另外,使用 make,通过以下内容创建一个包的 Makefile(1) 在 src/uc 目录下:
|
|
另外,使用 make,通过以下内容创建一个包的 Makefile(1) 在 src/uc 目录下:
|
|
|
|
|
|
|
|
- include $GOROOT/src/Make.inc
|
|
|
|
|
|
|
+```
|
|
|
|
|
+include $GOROOT/src/Make.inc
|
|
|
|
|
|
|
|
- TARG=uc
|
|
|
|
|
- GOFILES=\
|
|
|
|
|
- uc.go\
|
|
|
|
|
|
|
+TARG=uc
|
|
|
|
|
+GOFILES=\
|
|
|
|
|
+ uc.go\
|
|
|
|
|
|
|
|
- include $(GOROOT)/scr/Make.pkg
|
|
|
|
|
|
|
+include $(GOROOT)/scr/Make.pkg
|
|
|
|
|
+```
|
|
|
|
|
|
|
|
在该目录下的命令行调用: gomake
|
|
在该目录下的命令行调用: gomake
|
|
|
|
|
|
|
|
-这将创建一个 _obj 目录并将包编译生成的存档uc.a放在该目录下
|
|
|
|
|
|
|
+这将创建一个 _obj 目录并将包编译生成的存档 uc.a 放在该目录下。
|
|
|
|
|
|
|
|
-这个包可以通过 go test 测试
|
|
|
|
|
|
|
+这个包可以通过 go test 测试。
|
|
|
|
|
|
|
|
-创建一个 ud.a 的测试文件在目录下,输出为 PASS 时测试通过
|
|
|
|
|
|
|
+创建一个 ud.a 的测试文件在目录下,输出为 PASS 时测试通过。
|
|
|
|
|
|
|
|
在第 13.8 节我们将给出另外一个测试例子并进行深入研究。
|
|
在第 13.8 节我们将给出另外一个测试例子并进行深入研究。
|
|
|
|
|
|
|
@@ -92,32 +111,38 @@ func main() {
|
|
|
|
|
|
|
|
然后在这个目录下输入 `go install`。
|
|
然后在这个目录下输入 `go install`。
|
|
|
|
|
|
|
|
-另外复制 uc.a 到 uc 目录并创建一个 Makefile(2) 并写入文本包含在 $GOROOT/src/Make.inc:
|
|
|
|
|
|
|
+另外复制 uc.a 到 uc 目录并创建一个 Makefile(2) 并写入文本包含在 `$GOROOT/src/Make.inc`:
|
|
|
|
|
|
|
|
|
|
+```
|
|
|
TARG=ucmain
|
|
TARG=ucmain
|
|
|
GOFILES=\
|
|
GOFILES=\
|
|
|
ucmain.go\
|
|
ucmain.go\
|
|
|
|
|
|
|
|
include $GOROOT/src/Make.cmd
|
|
include $GOROOT/src/Make.cmd
|
|
|
|
|
+```
|
|
|
|
|
|
|
|
-执行 gomake 编译 ucmain.go 到 ucmain 目录
|
|
|
|
|
|
|
+执行 gomake 编译 `ucmain.go` 到 ucmain 目录
|
|
|
|
|
|
|
|
-运行 ./ucmain 显示: `USING package uc!`。
|
|
|
|
|
|
|
+运行 `./ucmain` 显示: `USING package uc!`。
|
|
|
|
|
|
|
|
## 9.8.2 本地安装包
|
|
## 9.8.2 本地安装包
|
|
|
|
|
|
|
|
本地包在用户目录下,使用给出的目录结构,以下命令用来从源码安装本地包:
|
|
本地包在用户目录下,使用给出的目录结构,以下命令用来从源码安装本地包:
|
|
|
|
|
|
|
|
- go install /home/user/goprograms/src/uc # 编译安装uc
cd /home/user/goprograms/uc
go install ./uc # 编译安装uc(和之前的指令一样)
cd ..
go install . # 编译安装ucmain
|
|
|
|
|
-
安装到 $GOROOT 下:
|
|
|
|
|
-
如果我们想安装的包在系统上的其他 Go 程序中被使用,它一定要安装到 $GOROOT 下。
|
|
|
|
|
-
这样做,在 .profile 和 .bashrc 中设置 GOPATH=$GOROOT。然后执行 go install uc 将会:
|
|
|
|
|
|
|
+ go install /home/user/goprograms/src/uc # 编译安装uc
|
|
|
|
|
+ cd /home/user/goprograms/uc
|
|
|
|
|
+ go install ./uc # 编译安装uc(和之前的指令一样)
|
|
|
|
|
+ cd ..
|
|
|
|
|
+ go install . # 编译安装ucmain
|
|
|
|
|
|
|
|
-(1) 复制源代码到 $GOROOT/src/pkg/linux_amd64/uc
|
|
|
|
|
|
|
+安装到 `$GOPATH` 下:
|
|
|
|
|
|
|
|
-(2) 复制包存档到 $GOROOT/PKG/LINUX_AMD64/uc
|
|
|
|
|
|
|
+如果我们想安装的包在系统上的其他 Go 程序中被使用,它一定要安装到 `$GOPATH` 下。
|
|
|
|
|
+这样做,在 .profile 和 .bashrc 中设置 `export GOPATH=/home/user/goprograms`。
|
|
|
|
|
|
|
|
-uc 包可以通过 "import uc" 在任何 Go 程序中被引用。
|
|
|
|
|
|
|
+然后执行 go install uc 将会复制包存档到 `$GOPATH/pkg/LINUX_AMD64/uc`。
|
|
|
|
|
+
|
|
|
|
|
+现在,uc 包可以通过 `import "uc"` 在任何 Go 程序中被引用。
|
|
|
|
|
|
|
|
## 9.8.3 依赖系统的代码
|
|
## 9.8.3 依赖系统的代码
|
|
|
|
|
|
|
@@ -125,13 +150,17 @@ uc 包可以通过 "import uc" 在任何 Go 程序中被引用。
|
|
|
|
|
|
|
|
你有一个很好的理由去写平台平台特定的代码,例如汇编语言。这种情况下,按照下面的约定是合理的:
|
|
你有一个很好的理由去写平台平台特定的代码,例如汇编语言。这种情况下,按照下面的约定是合理的:
|
|
|
|
|
|
|
|
- prog1.go
prog1_linux.go
prog1_darwin.go
prog1_windows.go
|
|
|
|
|
-
prog1.go 定义了不同操作系统通用的接口,并将系统特定的代码写到 prog1_os.go 中。
|
|
|
|
|
-
对于 Go 工具你可以指定 prog1_$GOOS.go 或 prog1_$GOARCH.go
|
|
|
|
|
-
或在平台 Makefile 中: prog1_$(GOOS).go\ 或 prog1_$(GOARCH).go\
|
|
|
|
|
|
|
+ prog1.go
|
|
|
|
|
+ prog1_linux.go
|
|
|
|
|
+ prog1_darwin.go
|
|
|
|
|
+ prog1_windows.go
|
|
|
|
|
+
|
|
|
|
|
+prog1.go 定义了不同操作系统通用的接口,并将系统特定的代码写到 prog1_os.go 中。
|
|
|
|
|
+对于 Go 工具你可以指定 `prog1_$GOOS.go` 或 `prog1_$GOARCH.go`
|
|
|
|
|
+或在平台 Makefile 中:`prog1_$(GOOS).go\` 或 `prog1_$(GOARCH).go\`。
|
|
|
|
|
|
|
|
## 链接
|
|
## 链接
|
|
|
|
|
|
|
|
- [目录](directory.md)
|
|
- [目录](directory.md)
|
|
|
- 上一节:[使用 go install 安装自定义包](09.7.md)
|
|
- 上一节:[使用 go install 安装自定义包](09.7.md)
|
|
|
-- 下一节:[通过 git 打包和安装](09.9.md)
|
|
|
|
|
|
|
+- 下一节:[通过 Git 打包和安装](09.9.md)
|