PackageManager是Unity推出的一套新的插件模块管理器,能快速方便的添加或者完整的移除插件,能自动添加依赖插件。
本文讲解UPM(Unity PackageManager) 插件包的开发流程,学会UPM插件包的正确构建与调试流程、GitHub发布、插件更新与下载使用。
Unity的包管理方式
一、Unity Packages (.unitypackage文件)
Unity 包(Packages)是分享和重新使用Unity项目和资源集合的便捷方式;例如:Unity 标准资源(Standard Assets)和Unity 资源商店(Asset Store)上的项目以包为单位提供。
Unity 包(Packages)是来自Unity项目或项目元素的文件和数据的集合,它们被压缩并存储在一个文件中,类似于Zip文件。像Zip文件一样,当包解压缩时,包将保持其原始目录结构,以及关于资源产的元数据(例如导入设置和到其他资源的链接)。
使用方法
1.导入包(Import Package) Assets-->Import Package-->Custom Package-->选择package包-->导入
2.导出包(Export Package)
3.导出更新包(Exporting Updated Packages)
二、Unity Package Manager
打开包管理器窗口的方法:在Unity的主菜单栏中依次点Window > Package Manager,在该窗口你可以安装、移除、更新一个package。
注:Unity 2018.1及以后的版本可以使用Package Manager
Package简介
Package目录结构示例
Project manifests
项目清单(manifest.json)告诉包管理器当前项目可以使哪些包的哪些版本。
项目清单文件存放在[project_root_folder]/Packages/manifest.json
Package manifests
包清单(package.json)是包的基本信息,用于包管理来确定要加载哪个版本的包,以及要在包管理器窗口中显示哪些信息。
package.json文件示例:
{
"name": "com.companyname.packagename",
"displayName": "Package Name",
"version": "0.0.1-prerelease",
"unity": "2018.3",
"unityRelease": "0f1",
"description": "",
"keywords": [],
"category": "tool",
"author": "",
"license": "MIT",
"type": "",
"hideInEditor": false
}
官方资料
Creating custom packages
AssemblyDefinition使用方法
Package Manager创建Git包
从Unity2019.3开始, Unity Package Manager已经支持Git Unity支持Git
发布UPM包
如果想要发布 UPM 包,我们必须通过如下git 命令把插件包所在的文件夹创建为 subtree
git subtree split --prefix=Assets/PackageName --branch upm
这个命令将 "Assets/PackageName" 目录放到“ upm” 分支。
通过这一步其他目录及文件不会出现在 upm 分支中。
接下来,为这个分支添加一个 tag 并推到远端。
git tag 1.0.0 upm
git push origin upm --tags
版本更新
- 在 "master" 分支开发和调试然后在 package.json 更新版本信息
- 执行 "git subtree split"
- 添加 tag 然后 push。
安装UPM包
UPM Install via manifest.json
打开项目根目录manifest.json文件, 合并以下代码就可以安装UPM包
{
"dependencies": {
"com.sourcemuch.quickeditor.monitor": "https://github.com/henry-yuxi/QuickEditor.Monitor.git#0.0.8",
}
}
Unity 2019.3 Git URL
在2019.3及以上版本, package manager 支持Git Url安装UPM包。
打开Package Manager Window (menu: Window > Package Manager), 选择 "Add package from git URL...", 在文本框中输入以下链接: https://github.com/henry-yuxi/QuickEditor.Monitor.git#0.0.6.
请确保安装的是最新版本的UPM包
参考
[教程]开发Unity PackageManager 插件包
Unity:使用Package Manager开发和管理自定义插件