扩展主菜单

package.json 文件中的 main-menu 字段里,加入自己的菜单路径和菜单设置选项。下面是一份主菜单的配置样例:

  1. { "main-menu": { "Examples/FooBar/Foo": { "message": "my-package:foo" }, "Examples/FooBar/Bar": { "message": "my-package:bar" } }}

message 字段中的 IPC 消息到主进程中。比如我们点击 “Foo” 将会发送 my-package:foo 这个消息。

菜单路径

/ 作为分割符。在主菜单注册过程中,Cocos Creator 会根据路径一级一级往下寻找子菜单项,如果在寻找路径中没有找到对应的子菜单,就会在对应的路径中进行创建,直到最后一级菜单,将被当做菜单项加入。 在注册过程中也会遇到一些出错的情况:

注册的菜单项已经存在

这种情况多发生在多个扩展包之间,当你的扩展包和其他用户的扩展包的菜单注册路径相同时,就会发生该冲突。

注册菜单项的父级菜单已经被其他菜单项注册,其类型不是一个子菜单(submenu)

这个情况和上一种情况类似,我们可以用以下这个例子来说明:

  1. { "main-menu": { "Examples/FooBar": { "message": "my-package:foo" }, "Examples/FooBar/Bar": { "message": "my-package:bar" } }}

在这个例子中,我们先在主菜单中注册了一份菜单路径 “Examples/Foobar”,这之后我们有注册了 “Examples/Foobar/Bar”,而第二个菜单路径的注册要求 Foobar 的类型为一个分级子菜单(submenu),然而由于上一次的注册已经将 Foobar 的类型定义为菜单选项(menu-item),从而导致了注册失败。

i18n

i18n:examples/i18n:foobar,Cocos Creator 会帮助我们查找对应的 i18n 字符串并进行替换。

菜单选项

message 菜单选项。菜单注册过程中还有许多其他的可选项,例如:icon、accelerator、type 等。更多选项,请阅读主菜单字段参考。