管理资源包
资源包(Package)是存储在单个*.upackage文件中的UNIGINE项目的文件和数据的集合。资源包压缩数据,同时保留原来的目录结构。资源包可以用来方便地在项目之间传输文件或与其他用户交换数据,无论是内容(单个模型或一组对象,这些对象由通过 c#组件实现的逻辑驱动)还是文件(插件、库、执行文件等)。
创建资源包#
UnigineEditor允许从Asset Browser和外部文件(即存储在data_path目录之外的文件)导出资源到一个资源包文件。
一般来说,这两种情况下的管道是相似的,但是存在一些差异。
从资源浏览器导出资源#
将资源从Asset Browser导出到资源包文件中:
-
在菜单栏中,选择Packages -> Export Package,然后在打开的Export Package窗口中单击Add Assets From Asset Browser按钮。
-
在Select Assets窗口中选择您想要添加到Package中的资源,然后单击OK。您甚至可以选择包含整个项目的文件夹,然后在下一步中取消选择不需要的数据。
注意,您可以在Asset Browser中执行相同的操作:右键单击所需的资源或文件夹,并在上下文菜单中选择Export As Package选项。
-
现在您可以在Export Package窗口中使用每个资源的复选框来选择要导出的资源。
请记住,您想要包含的任何单个文件都必须小于2 GB。资源包装尺寸不受限制。 -
你可以通过Include Dependencies复选框自动将所有依赖资源添加到资源包中(材质使用的纹理,分配给对象的材料等)(依赖资源在列表中被标记为绿色)。
-
选择资源后,单击Export Package将它们打包到一个新的*.upackage文件中。
必须选择至少一个资源来激活Export Package按钮。 - 在打开的对话框窗口中,定义资源包的名称和路径,然后单击Save。
成功创建资源包后,*.upackage 文件的位置将显示在文件管理器中。
出口外部文件#
将外部文件(即存储在data_path目录之外的项目文件)复制到资源包文件:
- 打开Export Package窗口:在菜单栏中,选择Packages -> Export Package。如果您已经添加了从Asset Browser资源,你可以跳过这一步,窗户是开着的。
-
Сlick Add External Files按钮,在打开的对话框窗口中选择文件或文件夹,然后单击Open。注意,外部文件夹是红色的,而来自Asset Browser的文件夹是蓝色的。
你不能添加文件存储在项目文件夹。 - 选择要导出的文件和/或文件夹,单击Export Package,指定新*.upackage文件的名称和路径,然后单击Save。
导入资源包#
导入现有的资源包的内容到你的项目,你需要:
-
直接从文件资源管理器将它拖到Asset Browser或选择Packages -> Import Package在菜单栏,选择*.upackage文件。Asset Browser还可以右击,选择Import New Asset上下文菜单并选择资源包。
如果您已经将*.upackage文件添加到目标项目中,请双击它。
不要使用操作系统的文件管理器将资源包复制到项目的文件夹中,因为在这种情况下,资源包将显示在Asset Browser中,但其内容不会被提取。以下窗口将被打开:
检查将要导入的资源。资源包中的资源可以被涂成白色、红色和黄色:
- 是可以导入资源没有任何变化。
- 导入带有后缀的黄色资源以解决名称冲突。
-
红色的资源不能进口由于以下原因之一:
- 在项目中可以找到相同的资源。
- 资源来源相同的项目中运行时发现GUID。
- 在项目中找到具有相同运行时GUID的资源。
- 指定的目标挂载点是只读的。
要为选中的资源导入所有依赖的资源,请选中Force Import Dependencies。这些资源将被标记为绿色。例如,如果您取消选中所选材质使用的纹理,该纹理无论如何都会被导入。- 在选择进口所需的所有资源,单击Import Package按钮。
- 等待提取过程。提取时间取决于为导入选择的资源的大小
除了资源,您还可以导入存储在资源包中的文件。如果这样的文件已经存在于项目中,它将被标记为红色,没有导入选项。
成功导入资源包,一个新的文件夹中相应的内容将提供Asset Browser和将显示以下信息:
管理资源包#
插件商店(Add-On Store)中提供的资源包可能会由资源包创建者不时更新。在这种情况下,您需要删除以前添加的文件并添加新的资源包版本。Add-On Store Package History窗口显示所有添加包下载插件,帮助删除资源包的文件存储在一个点击。
要打开Add-On Store Package History窗口,请在菜单中选择Packages -> Add-On Store Package History。
以下窗口将被打开:
此窗口提供以下详细信息和选项:
Imported Packages | 已导入到此项目的Add-On Store中的资源包列表。 |
---|---|
File Hierarchy |
所选资源包中可用文件的层次结构。如果一些包文件没有被导入,它们仍然会显示在File Hierarchy列表中,但是会以灰色显示,因为它们是不可用的。 在此选项卡下面的选项可用:
|
Description |
显示的描述提供的资源包作为资源包创造者等附加存储资源包版本。 |