Unity Package Manager 是 Unity 官方的包管理系统。具备以下功能:
使用 Package Manager 可以定义项目依赖项,解析包依赖关系,根据需要下载和添加包,以及将内容集成到项目中。
有关包的简介以及 Unity Package Manager 工作方式的一般信息,请参阅包文档。
包可以包含以下内容:
注意:Package Manager 不支持包中的流媒体资源。而应使用 Addressables 包。
每个包还包含一个包清单文件,其中包含诸如包名称、其版本、其依赖项列表以及其存储库 URL 之类的信息。
要创建新包,请执行以下操作:
1.使用下列其中一种方法来为包创建一个空 shell:
* [设置嵌入式包](#EmbedMe)。
* [设置本地包](#LocalMe)。
Make sure the layout of your package follows the package layout convention for Unity packages.
Rename and configure the assembly definition files.
Implement your tools, libraries, and any assets your package requires.
Add tests to your package. Tests are essential for ensuring that the package works as expected in different scenarios:
Tests/Editor
中。Tests/Runtime
.6.如果有示例,将示例添加到包。
**注意**:包只能包含示例,不过,如果使用相同的布局和 JSON 结构,也可以将示例作为工具或模板包的一部分包含在内。
You can update the CHANGELOG.md
file every time you publish a new version. Every new feature or bug fix should have a trace in this file. For more details on the chosen changelog format, see the Keep a Changelog documentation.
对于未共享的包,这是可选的操作,但对于共享的包,强烈建议这样做,以便用户知道哪个版本最符合他们的需求。
提示:您可以在包的 package.json 清单文件中使用 changelogUrl 属性提供一个指向外部网页(承载该包的更改日志)的链接。
You can include licenses and third-party notices in the LICENSE.md
and THIRD PARTY NOTICES.md
files.
对于未共享的包,这是可选的操作,但对于共享的包,强烈建议这样做,以免用户滥用您的包或违反任何第三方许可证的要求。
提示:您可以在包的 package.json 清单文件中使用 licensesUrl 属性提供一个指向外部网页(承载该包的许可和第三方声明)的链接。
Document your package.
提示:您可以在包的 package.json 清单文件中使用 documentationUrl 属性提供一个指向外部网页(承载该包的文档)的链接。
Share your package.
Follow these instructions if you want to create a custom package inside your project folder. Note: These instructions are part of the larger procedure for Creating custom packages.
Open the Unity Hub, and create an empty project on your computer.
Using your computer’s file manager (for example the Windows File Explorer or the macOS Finder), navigate to your project folder and locate the Packages
subdirectory.
Create a new subdirectory for your package inside the Packages
folder using a name that matches the package name. For example, if your package name is com.example.mypackage
, create a subdirectory called com.example.mypackage
.
Note: This is particularly important if your package contains assets, because the AssetDatabase looks for an asset path that matches Packages/<your-package-name>/Assets
, regardless of the actual folder name.
4.打开所选的文本编辑器,然后创建一个名为 package.json
的 JSON 文件。
5.将这个文件保存在您创建的新包根文件夹下面。
package.json
file. You can use the package manifest example as a reference.重新打开 Unity 时,新包会显示在 Package Manager 窗口中和 Project 窗口中,可以在其中查看和修改包内容。如果在 Project 窗口中选择 package.json
文件,则也可以直接在 Inspector 窗口中修改其内容。
Follow these instructions if you want to create a custom package outside your project folder. Note: These instructions are part of the larger procedure for Creating custom packages.
1.使用计算机的文件管理器(例如 Windows 文件资源管理器或 macOS Finder),为包创建一个文件夹。
如果已经为包创建了一些内容,则也可以使用现有位置。
Editor
and Runtime
folders.3.打开所选的文本编辑器,然后创建一个名为 package.json
的 JSON 文件。
4.将这个文件保存在包根文件夹下。
package.json
file. You can use the package manifest example as a reference.6.在 Unity 中,创建一个新项目或打开一个现有项目。
package.json
file you just created.The new package appears in the Package Manager window and in the Project window, where you can view and modify the package contents. If you select the package.json
file in the Project window, you can also modify its contents directly in the Inspector window.