翻译Unity中文版的初衷是因为官方提供的中文版存在缺陷，而且翻译的不全。现在基于Unity2023.2版本对官方文档进行翻译。

Unity’s Package Manager(一) 🔗

包是一个容器，存储各种类型的特征或资产，例如：

• 编辑器工具和库，如文本编辑器，动画查看器或测试框架。
• 运行时工具和库，如Physics API或图形管道。
• 资产集合，如纹理或动画。
• 项目模板，以与他人共享常见的项目类型。

通过Package Manager，packages为Unity提供了广泛的增强功能。为了帮助查找和使用这些包，Package Manager的窗口提供了可以一起使用的包集合，称为特性集。

在Editor中，你可以通过此菜单访问Package Manager窗口：Window > Package Manager。

Package Manager还支持管理你从Unity Asset Store 下载或导入的包。

Unity提供了三个Package Manager接口：Package Manager窗口，Scripting API，和manifest文件。下表包含了对每个接口的介绍，以及更多信息。

How Unity works with packages 🔗

当Unity打开一个项目时，Unity包管理器会读取项目清单

• 来确定在项目中需要加载哪些包。然后它发送请求

• 到包注册服务器

• 对于在清单中出现作为依赖项的每个包。然后，包注册器将请求的信息和数据发送回包管理器

• 进而在项目中安装这些包

• 每个项目都有自己的清单，列出了需要作为项目“依赖项”来加载的包。

Unity包管理器如何安装包

向项目添加一个包需要更新项目清单，确保包管理器在依赖项列表中包含该包。尽管你可以直接修改项目清单，但使用包管理器窗口，它可以为你管理项目清单的修改，这会更安全，也更容易。

Concepts 🔗

这一部分解释了许多有关Unity包管理器功能的概念：

• Versions(版本)
• Manifests(清单)
• Registry(注册表)
• Package Management(包管理)
• Package sources(包资源)
• Package states and lifecycle(包状态和生命周期)
• Dependency and resolution(依赖和解析)
• Global cache(全局缓存)

Versions 🔗

每个包都有多个版本供选择，标记着该包在其生命周期中的变化。每次开发者更新包，他们都会给它一个新的版本号。包版本的变化告诉你它是否包含一种破坏性改变(主版本)，新的向后兼容功能(次版本)，或者仅有的修复错误(补丁版)，遵循语义版本控制。

要查看特定包的可用版本列表，请查看查找特定版本。

Manifests 🔗

有两种类型的清单文件：

• Project manifests(项目清单) (manifest.json)储存包管理器需要找到并加载正确包的信息，包括声明为依赖项的包和版本列表。
• Package manifests(包清单) (package.json)储存关于特定包的信息，以及包所需的包和版本的列表。

两种文件都使用JSON（JavaScript 对象表示法）语法。

Registry 🔗

在Unity的包管理器领域，包注册表是一个服务器，它存储包内容以及每个包版本的信息（元数据）。Unity维护一个可供分发的官方包的中心注册表。默认情况下，所有项目都使用官方的Unity包注册表，但您可以添加额外的注册表以存储和分发私人包，或者在开发自定义包时对其进行暂存。

Package Management 🔗

Unity包管理器是一个管理整个包系统的工具。它的主要任务包括以下几点：

• 它与Unity包注册表服务器以及您指定的任何其他注册表进行通信。
• 它读取您的项目清单和获取包内容及元数据。
• 它安装、升级及卸载包，无论它们是项目的依赖关系还是已安装包中的一种。
• 它导入您以前下载或购买的Asset Store包。
• 它启用和禁用Unity的内置包。
• 它显示每个包的每个版本的信息。
• 在项目及其包需要多个包版本时，它解决冲突。

Unity包管理器按项目安装样本、工具和资产，而不是在特定机器或设备的所有项目间安装。它使用全局缓存存储下载的包元数据和内容。一旦在项目中安装，Unity将包资产视为项目中的其他任何资产，只是这些资产存储在包文件夹内并且是不可变的。您只能从Local和Embedded包源永久性改变内容。

Package sources 🔗

源描述了包的来源：

要编辑包的包清单，请查看检查包。

包管理器窗口会显示对应于这些源中的一些的标签。有关更多信息，请查看标签。

注意：包管理器将您从Asset Store下载的包存储在一个与全局缓存分开的缓存中。请查看Asset Store包以获取更多信息。

Package states and lifecycle 🔗

从Unity编辑器2021.1版本开始，包在其生命周期中可能会经历以下状态：

[][]

使用Unity包管理器的包生命周期

包管理器窗口显示与这些状态中的一些相对应的标签。

注意：这些包状态仅适用于Unity内部开发的包。要了解他们特定的流程，请联系第三方包开发者。

Dependency and resolution 🔗

当你在包管理器窗口工作时，你可以从几个来源安装包（库、本地文件夹或压缩包、Git URL以及名称）。然而，当包管理器从这些来源无缝安装包时，它首先要进行一系列的计算来决定安装哪个版本。它还需要决定安装哪些其他包和版本以支持你选择的包。

Direct dependencies直接依赖

当你通过包管理器窗口选择一个包版本进行安装时，你正在向你的项目manifest添加一个“依赖”。这是一个声明，即你需要一个特定版本的某个包才能使项目正常工作。要向项目添加依赖，你需要以包名称@包版本的形式在<项目根目录>/Packages/manifest.json文件的依赖属性中添加对包和版本的引用。这些被称为“直接”依赖，因为你的项目直接依赖它们。

Indirect dependencies间接依赖

包也可以需要其他包才能工作。这些被称为“间接”（或转移）依赖。包开发者在开发过程中将这些添加到包manifest文件的依赖属性（<包根目录>/package.json）。例如，在下面的图表中，alembic@1.0.7包依赖于timeline@1.0.0包，所以timeline包是一个“间接”依赖。反过来，项目依赖于cinemachine@2.6.0和alembic@1.0.7包，所以它们都是“直接”依赖。

该图展示了直接依赖和间接依赖

Version overrides版本覆盖

当你添加一个包版本作为依赖时，该版本并不一定是包管理器安装的版本。原因是包管理器必须考虑你项目中的所有依赖，无论是直接还是间接的。在以下示例中，请求的XR插件管理包版本是4.0.3。然而，包管理器安装的版本是4.0.6，因为另一个包依赖于更高的版本，如信息消息(B)所示：

当你在详情面板中点击信息按钮（A）时，会出现一个文本框（B）解释为何安装了这个版本而不是你请求的版本

Dependency graph依赖图

包管理器一次只能安装一个包的版本，所以它必须构建一个依赖图。这个图是项目的每个直接依赖和间接依赖的列表。依赖图决定安装每个包的哪个版本。

Lock file锁定文件

当包管理器解决所有版本冲突后，它会将解决方案保存在一个锁定文件中，原因有两个：

• 确定性，确保每次都可靠地安装相同的包。
• 效率，减少重新计算依赖图所需的时间和资源。

Global cache 🔗

当Unity包管理器从注册表下载包内容和元数据时，它会将它们存储在全局缓存中。这使得重用和共享包更加高效，并且允许你在离线时安装和更新存储的包。

注意：全局缓存不包含来自资产商店的.unitypackage格式的包。包管理器将这些类型的包存储在一个单独的缓存中。更多信息，请参考资产商店包。

Location 🔗

默认情况下，Unity将全局缓存存储在一个根目录中，这个目录取决于操作系统（以及Windows上的用户账户类型）：

Tip: You can override the location of this root directory. Refer to Customize the global cache for more information.

Structure 🔗

包管理器的全局缓存使用多个子缓存，每个子缓存都有不同的用途。包管理器将这些子缓存存储在全局缓存的文件夹下的子文件夹中：

在这些子文件夹中，每个注册表都有自己的路径，以便不同注册表上托管的包不会混淆。

提示：您可以重写这些文件夹的位置。有关更多信息，请参阅定制全局缓存。

Size 🔗

从Unity编辑器的2023.2.0f1版本开始，注册表数据缓存（db子文件夹）的大小限制为10 gigabytes (GB)。当达到该限制时，PackageManager会通过剔除最近最少使用的内容（基于最旧的一个程序包安装到项目的日期）来修剪注册表数据缓存。换句话说，PackageManager首先剔除的是您在最早时间内添加到项目中的程序包。然而，尽管PackageManager将这些程序包从缓存中剔除，但它们仍然存在于安装了它们的任何项目中。下次您将这些包添加到其他项目时，PackageManager将从适当的注册表中获取它们，而不是从您的缓存中获取。

您可以重写注册表数据缓存限制的大小。有关信息，请参考定制全局缓存。

Requirements 🔗

运行Unity编辑器进程的用户账户必须对根目录及其内容拥有完全的写入权限。没有这些权限，PackageManager无法在缓存中下载和保存程序包的元数据和内容。

结论 🔗

搬砖愉快！