package.json 字段参考
version (String)
版本号,我们推荐使用 格式管理你的包版本。
description (String)
一句话描述你的扩展包是用来做什么的。
注明扩展包的作者,可以是你的名字,团队的名字或者公司的名字。
main (String)
入口函数文件。通常我们会在包中存放一个 main.js 文件作为入口函数文件。你也可以在入口函数文件放在扩展包中的其他位置例如:,只要在 main
字段中正确书写你的文件的相对路径即可。
main-menu (Object)
主菜单注册,主菜单注册的键值(Key)是一段菜单路径,注册信息为一个对象,关于注册信息可详细阅读。
面板注册,面板注册的键值(Key)是一个以 panel
开头的字符串,字符串后面可跟上后缀名用于多面板的注册。
注册完的面板,将会生成以 ${包名}${面板后缀名}
为组合的面板 ID,如果没有后缀名(通常我们如果注册一个面板就不会带后缀),
则面板 ID 直接等于插件包的名字。
关于多面板注册,这里我们提供了一个简单的例子,在 package.json
中:
这样注册完的面板,将会生成两份面板 ID 分别为:simple-package
和 .
关于面板注册信息可详细阅读面板字段参考。
reload (Object)
runtime-resource (Object)
插件通过在 package.json
文件中配置 runtime-resource
字段来 mount runtime 资源到资源管理器中。配置的格式如下:
最终在资源管理器中由插件 mount 的文件夹名称为 [packageName]-[runtime-resource.name]
。且插件导入的资源文件夹为只读的。
需要注意的是,通过配置 runtime-resource
字段将扩展包中的文件夹 mount 到项目资源后,本身就具备自动同步的功能,也就是对扩展包中的 进行的修改会自动同步到项目资源中并触发编译等流程,所以应该将 runtime-resource
里 path
字段指向的路径添加到 package.json
中的 reload.ignore
中,否则会引起插件的重复加载:
scene-script
字段用于声明一个扩展包内的脚本,在该脚本中可以使用引擎 API,并访问当前场景中的节点和组件。
声明形式如下: