当前位置：首页 > news >正文

Golang编写客户端SDK，并开源发布包到GitHub，供其他项目import使用

news 2025/8/15 19:10:57

编写客户端SDK，并开源发布包到GitHub

如果希望其他项目能够使用该SDK，可以将该SDK打包为一个Go模块，并将其发布到Go模块仓库中。这将使其他项目能够通过Go的模块依赖机制来使用该SDK。可以轻松地引用和使用你的代码。

1. 创建 GitHub 仓库

登录到你的 GitHub 帐户。
在 GitHub 主页点击右上角的加号（+），然后选择 “New repository”（新建仓库）。
给你的仓库起一个名称，选择是公共的，然后点击 “Create repository”（创建仓库）按钮。

克隆项目到本地：使用 git clone 命令来克隆仓库到本地。需要提供 GitHub 仓库的 URL，可以在仓库页面的右上角找到 “Code” 按钮，然后选择 HTTPS 或 SSH URL。

使用 HTTPS URL 克隆仓库：

git clone https://github.com/用户名/仓库名.git

使用 SSH URL 克隆仓库（需要配置 SSH 密钥）：
```
git clone git@github.com:用户名/仓库名.git
```

2. 构建项目，编写代码

克隆成功后，此时项目是一个空仓库，使用 go mod 的方式管理包，对项目进行初始化：

git mod init github.com/用户名/仓库名

初始化成功后，项目根目录下会新增一个 go.mod 文件。
⚠️ 注意：这里的项目名需要为 github.com/用户名/仓库名（将用户名、仓库名替换为你实际项目中的名称）

Go 代码示例：

package clienttype Client struct {AccessKey stringSecretKey string
}func NewClient(accessKey, secretKey string) *Client {return &Client{AccessKey: accessKey,SecretKey: secretKey,}
}func (c *Client) GetNameByGet(name string) (data interface{}, err error) {return "名字是" + name, nil
}

项目目录结构展示：

在这里插入图片描述

3. 提交代码到 GitHub仓库

完成了代码编写及测试正常后，将代码提交到远程仓库中。

添加文件到暂存区：使用 git add 命令将你要提交的文件添加到 Git 的暂存区。可以使用以下命令添加所有更改：

git add .	//这个命令将当前目录下所有文件（包括新添加、修改和删除的文件）添加到暂存区。但它不会包括未跟踪的文件，也就是那些没有被 Git 管理的文件。如果你在项目中新建了文件，使用这个命令将不会将它们添加到暂存区。
git add -A 或 git add --all	//这个命令会将当前目录下的所有更改（包括新添加、修改、删除的文件）以及未跟踪的文件全部添加到暂存区。它是一个更全面的命令，适用于确保所有更改都被提交到 Git。

或者，如果你只想添加特定文件，可以使用：

git add 文件名

提交更改：使用 git commit 命令将暂存区的更改提交到本地仓库，并添加提交消息来描述你的更改。例如：
```
git commit -m "添加了一个新功能"
```
推送到远程仓库：使用 git push 命令。例如：
```
git push -u origin 分支名
```
将 “分支名” 替换为你要推送的分支名称。通常，main 或 master 是默认的主分支名称。
📢 注意，如果你是第一次提交到 GitHub 仓库，需要配置 Git 以关联本地仓库和远程仓库。使用 git remote 命令来添加远程仓库的别名。例如：
```
git remote add origin 仓库URL
```
“origin” 是远程仓库的别名，可以自定义。“仓库URL” 是你 GitHub 仓库的 URL。
一旦关联了远程仓库，就使用 git push 将更改推送到远程仓库

4. 发布版本

push成功后，刷新GitHub上的仓库，确认项目代码已经上传成功。然后点击tags 创建标签和构建release版本。
在这里插入图片描述
接着点击：Create a new release

然后，添加一个版本号打上tag，完善描述信息后，点击 Publish release 发布。
![在这里插入图片描述](https://img-blog.csdnimg.cn/3404adc6ff7048acac4ecc897506066e.pn

5. 现在其他人可以引用使用你的模块包了

成功发布后，其他人就可以像平时使用第三方包一样直接go get 和 import 我们的模块包了。

go get github.com/用户名/仓库名

或者

require (github.com/用户名/仓库名 v1.0.0
)

然后运行 go get 命令下载该依赖。

使用该模块包：

package main
import "github.com/xiaoxiongmao5/xapi-clientsdk/client"func main() {accessKey, secretKet := "zs", "123456"clientsdk = client.NewClient(accessKey, secretKey)data, err := clientsdk.GetNameByGet(name)if err != nil {fmt.Println("ERROR: Failed to read response, err=", err)return}fmt.Printf("SUCCESS: data=%T data=%v \n", data, data)
}