NuGet 包注册表

发布您的用户或组织的 NuGet 包。包注册表支持 V2 和 V3 API 协议，您可以与 NuGet 符号包 协同工作。

要求

要使用 NuGet 包注册表，您可以使用命令行界面工具以及各种 IDE（如 Visual Studio）中的 NuGet 功能。有关 NuGet 客户端的更多信息，请参见 官方文档。以下示例使用 dotnet nuget 工具。

配置包注册表

要注册包注册表，您需要配置一个新的 NuGet 源。

dotnet nuget add source --name {source_name} --username {username} --password {password} https://gitea.example.com/api/packages/{owner}/nuget/index.json

参数	描述
source_name	所需的源名称。
username	您的 Gitea 用户名。
password	您的 Gitea 密码。如果您使用的是 2FA 或 OAuth，请使用 个人访问令牌 而不是密码。
owner	包的所有者。

例如

dotnet nuget add source --name gitea --username testuser --password password123 https://gitea.example.com/api/packages/testuser/nuget/index.json

您可以添加没有凭据的源，并在发布包时使用 --api-key 参数。在这种情况下，您需要提供一个 个人访问令牌。

发布包

通过运行以下命令来发布包。

dotnet nuget push --source {source_name} {package_file}

参数	描述
source_name	所需的源名称。
package_file	包 .nupkg 文件的路径。

例如

dotnet nuget push --source gitea test_package.1.0.0.nupkg

如果已存在相同名称和版本的包，则无法发布包。您必须先删除现有包。

符号包

NuGet 包注册表为符号服务器提供构建支持。客户端可以请求嵌入符号包 (.snupkg) 中的 PDB 文件。为此，请将 NuGet 包注册表注册为符号源。

https://gitea.example.com/api/packages/{owner}/nuget/symbols

参数	描述
owner	包注册表的所有者。

例如

https://gitea.example.com/api/packages/testuser/nuget/symbols

安装包

要从包注册表安装 NuGet 包，请执行以下命令。

dotnet add package --source {source_name} --version {package_version} {package_name}

参数	描述
source_name	所需的源名称。
package_name	包名称。
package_version	包版本。

例如

dotnet add package --source gitea --version 1.0.0 test_package

支持的命令

dotnet add
dotnet nuget push
dotnet nuget delete