作用域注册表

作用域注册表允许 Unity 将任何自定义包注册表服务器的位置传达给 Package Manager，以便您可以同时访问多个包集合。

以下是一些重要概念，可帮助您理解此功能：

与作用域注册表交互的方式取决于您的角色：

• 除了 Unity 注册表，包提供者还可以设置自定义注册表服务器来托管和分发自定义包。
• 包使用者为每个项目设置作用域注册表，以便访问自定义包提供者的注册表服务器。

作用域注册表的完整性和安全性

作为包提供商，请确保您设置的所有包注册表服务器符合 Unity 的服务条款和 Unity 的包指导原则和指南。Unity 提供对 Package Manager 的访问以促进知识和创作的共享，但不是作为第三方产品的市场。

作为包使用者，安装作用域注册表时，应像安装其他任何第三方软件一样谨慎：

• 仅从受信任的来源安装作用域注册表，因为这些注册表中的包可以包含可执行代码。
• 警惕可能有害或在缺乏适当控制的情况下收集数据的第三方注册表。此外，还要警惕那些将自己伪装成 Unity，或声称得到 Unity 认可、支持的第三方。

作用域注册表的优势

作用域注册表可以帮助：

• 通过分发工具、库和其他资源来提供新的功能。

  作为提供者，您可以创建自己的注册表来分发工具和脚本（或其他类型的资源），版本号表明包的成熟度。版本号还指示更新是基于语义版本控制引入重大 API 更改还是小修复。您的代码可以依赖于其他包中的代码，因为 Package Manager 支持包的依赖关系。

  作为使用者，您在 Package Manager 中浏览和安装第三方自定义包的体验与浏览 Unity 包相同。

• 扩展现有 Unity 包的功能。

  作为使用者，您可以获得无缝体验，其中自定义包可覆盖 Unity 包，而无需手动更改注册表或显式安装不同的包版本。这是因为您可以将包映射到特定的注册表，以便 Package Manager 从 Unity 注册表或自定义包注册表服务器获取。

• 在封闭网络环境中访问包。

  某些组织在封闭的网络中工作，这使得访问 Unity 的包注册表变得困难。在这些情况下，组织可以在其封闭网络内的服务器上设置自己的包注册表。然后，网络管理员可以定期与 Unity 的包注册表同步，以确保作用域注册表具有最新的可用包集合。

如果您是包裹使用者，请参阅管理项目的作用域注册表了解有关如何连接到 Unity 项目中现有的自定义包注册表服务器的信息。如果您是包制作者，请参阅共享包以了解有关支持的包注册表服务器的信息。此信息还包括有关如何设置它们以便与作用域注册表一起使用的信息的链接。

注意：如果您正在设置作用域注册表指向具有受限访问权限的包注册表服务器，您可以配置 Package Manager 将您的 npm 身份验证令牌传递给服务器。有关更多信息，请参阅作用域注册表身份认证。

添加和删除作用域注册表

使用项目设置 (Project Settings) 窗口的 Package Manager 类别可以添加、修改或删除项目的作用域注册表。

导入作用域注册表

如果您在一个共享项目中工作，并且另一个用户向该项目添加了一个作用域注册表，Unity 会警告您另一个用户已经添加了一个新的作用域注册表。

当您单击关闭 (Close) 按钮，将出现 Package Manager 项目设置窗口，您可以添加、修改或者移除项目的作用域注册表。

如果单击阅读更多 (Read more)，Unity 将在默认 Web 浏览器中打开当前正在阅读的页面。

提示：要随时访问 Package Manager 项目设置窗口，请使用 Unity 中的主菜单（__编辑 (Edit) > 项目设置 (Project Settings)，然后 Package Manager__ 类别）。您还可以从 Package Manager 窗口的高级设置菜单中选择__高级项目设置 (Advanced Project Settings)__。

管理项目的作用域注册表

要管理项目中的作用域包注册表，可以：

• 直接编辑您的项目清单文件。
• 使用 Package Manager 项目设置窗口可让 Unity 为您更改清单。

项目清单使用一个 scopedRegistries 属性，其中包含一个作用域注册表配置对象数组。每个对象都具备以下属性：

示例

在以下项目清单中，有两个作用域注册表（General 和 Tools）：

{
    "scopedRegistries": [
        {
            "name": "General",
            "url": "https://example.com/registry",
            "overrideBuiltIns": false,
            "scopes": [
                "com.example", "com.example.tools.physics"
            ]
        },
        {
            "name": "Tools",
            "url": "https://mycompany.example.com/tools-registry",
            "overrideBuiltIns": true,
            "scopes": [
                "com.example.mycompany.tools"
            ]
        }
    ],
    "dependencies": {
        "com.unity.animation": "1.0.0",
        "com.example.mycompany.tools.animation": "1.0.0",
        "com.example.tools.physics": "1.0.0",
        "com.example.animation": "1.0.0"
    }
}

Package Manager 决定从哪个注册表获取包时，会将包 name 的值与 scopes 的值进行比较，并找到 scopes 最匹配的注册表。

• 当 Package Manager 查找 com.example.animation 包时，发现 com.example 命名空间与其名称最匹配，并且从 General 注册表获取包。
• 当 Package Manager 查找 com.example.tools.physics 包时，General 注册表具有与包名称完全匹配的作用域。
• 当 Package Manager 查找 com.example.mycompany.tools.animation 包时，Package Manager 发现 com.example.mycompany.tools 命名空间与其名称最匹配，因此从 Tools 注册表获取包。虽然它也与 General 作用域匹配，但 com.example 命名空间的匹配程度并不高。
• Package Manager 查找 com.unity.animation 包时，Package Manager 在任何作用域注册表中都找不到匹配项。在这种情况下，它会从默认注册表获取包。

如果 General 和 Tools 注册表在编辑器中也有内置包，Package Manager 会按如下方式进行解析：

• Package Manager 会跳过 General 作用域注册表中的内置包，因为 overrideBuiltIns 值为 false。相反，Package Manager 使用 Unity 编辑器附带的内置版本。
• Package Manager 使用 Tools 作用域注册表中的内置包而不是编辑器，因为 overrideBuiltIns 值为 true。

其他资源

• 作用域注册表身份验证
• 项目设置窗口 (Package Manager)