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