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