跳至主要内容
版本:1.24.6

NuGet 軟體包註冊表

發佈适用于您的使用者或組織的 NuGet 軟體包。軟體包註冊表支持 V2 和 V3 API 协议,並且您還可以使用 NuGet 符号軟體包

要求

要使用 NuGet 軟體包註冊表,您可以使用命令行界面工具,以及各种集成开发环境(IDE)中的 NuGet 功能,如 Visual Studio。有关 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