跳至主要内容
版本:1.23.6

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