UnityNuGet与Azure DevOps集成：私有NuGet源的访问配置教程

UnityNuGet与Azure DevOps集成：私有NuGet源的访问配置教程

【免费下载链接】UnityNuGetProvides a service to install NuGet packages into a Unity project via the Unity Package Manager项目地址: https://gitcode.com/gh_mirrors/un/UnityNuGet

UnityNuGet是一款能让开发者通过Unity Package Manager安装NuGet包的实用工具，它架起了Unity项目与NuGet生态之间的桥梁。本教程将详细介绍如何将UnityNuGet与Azure DevOps私有NuGet源集成，帮助团队安全高效地管理内部开发的NuGet包。

准备工作：环境与工具检查

在开始集成前，请确保你的开发环境满足以下条件：

• Unity编辑器（2019.1或更高版本，推荐2021.2+以获得最佳兼容性）
• Azure DevOps账号及私有NuGet源访问权限
• Git工具（用于克隆项目仓库）

首先克隆UnityNuGet项目到本地：

git clone https://gitcode.com/gh_mirrors/un/UnityNuGet

核心配置：NuGet.Config文件设置

NuGet配置文件是连接UnityNuGet与Azure DevOps的关键。项目中提供了基础配置模板，你可以在src/nuget.config找到参考示例。

配置私有源步骤：

1. 复制基础配置文件到项目根目录
2. 添加Azure DevOps NuGet源：

<configuration> <packageSources> <clear /> <add key="nuget.org" value="https://api.nuget.org/v3/index.json" /> <add key="azure-devops" value="https://pkgs.dev.azure.com/[组织名]/_packaging/[源名称]/nuget/v3/index.json" /> </packageSources> </configuration>

3. 替换[组织名]和[源名称]为你的Azure DevOps实际信息

认证设置：安全访问私有源

Azure DevOps私有源需要身份验证，推荐使用个人访问令牌（PAT）进行配置：

1. 在Azure DevOps中创建具有"打包"权限的PAT
2. 使用命令行添加凭据：

nuget sources update -name "azure-devops" -username any -password [你的PAT]

⚠️ 注意：请确保PAT的安全存储，不要提交到版本控制系统中

Unity Package Manager配置

完成NuGet配置后，需要在Unity中添加UnityNuGet源：

1. 打开Unity编辑器，导航到Window > Package Manager
2. 点击左上角"+"按钮，选择"Add package from git URL..."
3. 输入UnityNuGet工具包地址（项目内路径：src/UnityNuGet/UnityNuGet.csproj）

Unity编辑器中使用UnityNuGet安装NuGet包

高级设置：调整服务器配置

对于需要自行托管UnityNuGet服务的团队，可以修改服务器配置文件src/UnityNuGet.Server/appsettings.json来适配Azure DevOps源：

{ "Registry": { "RootHttpUrl": "https://your-custom-server/", "RegistryFilePath": "registry.json", "UpdateInterval": "00:10:00" } }

主要调整参数说明：

• RootHttpUrl: 自定义服务器地址
• RegistryFilePath: 注册表数据文件路径
• UpdateInterval: 包信息同步间隔

验证与测试

配置完成后，通过以下步骤验证集成是否成功：

1. 在Unity Package Manager中切换到"UnityNuGet"源
2. 搜索你的私有NuGet包（如"Company.Project.Core"）
3. 点击"Install"按钮安装测试包
4. 检查控制台输出，确认没有认证错误或连接问题

常见问题解决

连接超时问题

• 检查网络代理设置，确保能访问Azure DevOps域名
• 验证NuGet源URL是否正确（推荐使用V3格式）

认证失败问题

• 确认PAT是否过期或权限不足
• 检查凭据存储是否正确（可使用nuget sources list命令查看）

包版本不显示问题

• 检查src/UnityNuGet.Server/registry.json文件是否已同步
• 手动触发更新：修改UpdateInterval为"00:01:00"等待同步

通过以上步骤，你已经成功将UnityNuGet与Azure DevOps私有NuGet源集成。这一配置将帮助团队在Unity项目中安全、高效地使用内部开发的NuGet包，提升协作开发效率。如需进一步定制，可以参考项目中的示例配置文件examples/docker/docker-compose.yml进行高级设置。

【免费下载链接】UnityNuGetProvides a service to install NuGet packages into a Unity project via the Unity Package Manager项目地址: https://gitcode.com/gh_mirrors/un/UnityNuGet