egret-docs-master/Wing/resdepot/README.md

3.8 KiB
Raw Permalink Blame History

简介

egret项目中所用的资源配置文件是json格式的文件。资源配置文件可以用任何文本编辑器编辑在wing里则提供了可视化的编辑方式可视化的编辑提供了更加简便的操作自动检查配置文件的中错误批量操作等功能。

功能介绍

打开default.res.json显示如下界面 上面是设计视图界面,可以点源码切换到文本编辑界面。 设计界面大致分为以下几个区,与上图数字对应:

  • 1资源树区
  • 2资源信息区
  • 3资源预览区
  • 4组信息
  • 5组内资源

1.资源树区域

这里以树的形式展示了资源文件的内容。树的左上角有折叠/展开树的功能按钮,和搜索框(采用了模糊匹配),搜索效果如下:

选中一项会在信息区和预览区显示所选资源。 右键可以删除资源/在资源管理器中查看。如果是图片资源,可以编辑九宫格。 可以批量删除资源同时按住ctrl/command/shift键即可选择多项。 可以删除文件夹。 删除资源的同时会从相关的组里自动删除。 可以从本地文件系统中拖入图片等资源到资源树中,拖入的文件自动添加到资源配置中。 支持拖入文件/文件夹的方式。 如果拖入的资源文件不在当前项目资源目录下则会自动拷贝到当前项目资源目录的assets目录下。

2.信息区

这里显示了所选资源的详细内容主要有资源名资源类型在配置中的相对资源路径附加参数9切信息二级keysheet文件的subkeys等。 资源名可以在这里编辑修改。 可以修改资源项的类型。 可以刷新二级key。

3.预览区

这里是各种资源的预览效果image类型的展示为图片sheet文件展示为整张图位图字体显示位图字。 对于image类型的资源预览区左下角有一个9切编辑按钮可以打开9切编辑界面 编辑后将在资源文件中写入该资源的9切数据。

4.资源组

这里显示的是资源文件中groups分组情况。 点‘添加’按钮可以添加新的资源组。 右键菜单里可以选择删除组。 可以多选。 可以批量删除。

5.组内资源

这里显示了当前所选组里的资源。选择一项将会在信息区预览区显示该资源详细内容,并在资源树里定位到该资源。 右键菜单里可以选择删除项。 可以多选。 可以批量删除。 双击名字可以改名。 可以从本地文件系统拖入资源到当前区域。支持拖入文件/文件夹的方式。 如果拖入的资源不在当前项目的资源目录下则自动拷贝到当前项目资源目录下的assets下。 可以从资源树拖拽资源到当前区,将自动添加到当前组。

资源冲突

如果资源文件中有重名的资源项,或者资源对应的文件不存在等错误,则会自动检测出来,并通过标记红框或黄框的形式提醒。在界面底部也会有提示性文字。 上图展示了三种错误:

  • button_down.png文件刚被我删掉该项资源对应的文件不存在显示为黄色。
  • checkbox里checkbox_select_down.png的资源名被我改为了checkbox_select_disabled_png与checkbox_select_disabled.png的资源名产生了冲突资源重名显示为红色。
  • 表单文件pic.json里的subkey则有一项重名显示为黄色。

其他

编辑资源后需要ctrl+s保存一下。

资源编辑器基于wing项目需要从项目的配置文件wingProperties.json中读取资源配置。打开wingProperties.json在resourcePlugin->configs下加入自己的资源文件