• package.json 字段参考
    • name (String)
    • version (String)
    • description (String)
    • author (String)
    • main (String)
    • main-menu (Object)
    • panel (Object)

    package.json 字段参考

    name (String)

    你的扩展包名字。扩展包名字是全局唯一的,他关系到你今后在官网服务器上登录时的名字。

    version (String)

    版本号,我们推荐使用 semver 格式管理你的包版本。

    description (String)

    一句话描述你的扩展包是用来做什么的。

    author (String)

    注明扩展包的作者,可以是你的名字,团队的名字或者公司的名字。

    main (String)

    入口函数文件。通常我们会在包中存放一个 main.js 文件作为入口函数文件。你也可以在入口函数文件放在扩展包中的其他位置例如:main/index.js,只要在 main 字段中正确书写你的文件的相对路径即可。

    main-menu (Object)

    主菜单注册,主菜单注册的键值(Key)是一段菜单路径,注册信息为一个对象,关于注册信息可详细阅读主菜单字段参考。

    其中菜单路径为一份 posix 格式的路径,菜单会根据路径中的名字,依次注册到主菜单中。例如:“My Package/Preview/Foo Bar” 将会在主菜单中寻找 My Package > Preview 这个菜单路径,如果寻找过程中没有发现对应的菜单项,将会自动添加。最终 Cocos Creator 会将 “Foo Bar” 添加到对应的路径中,如图:

    menu-path

    panel (Object)

    面板注册,面板注册的键值(Key)是一个以 panel 开头的字符串,字符串后面可跟上后缀名用于多面板的注册。
    注册完的面板,将会生成以 ${包名}${面板后缀名} 为组合的面板 ID,如果没有后缀名(通常我们如果注册一个面板就不会带后缀),
    则面板 ID 直接等于插件包的名字。

    关于多面板注册,这里我们提供了一个简单的例子,在 package.json 中:

    1. {
    2. "name": "simple-package",
    3. "panel": {
    4. "main": "panel/index.js",
    5. "type": "dockable",
    6. "title": "Simple Panel",
    7. "width": 400,
    8. "height": 300
    9. },
    10. "panel-02": {
    11. "main": "panel-02/index.js",
    12. "type": "dockable",
    13. "title": "Simple Panel 02",
    14. "width": 400,
    15. "height": 300
    16. },
    17. }

    这样注册完的面板,将会生成两份面板 ID 分别为:simple-packagesimple-package-02.

    关于面板注册信息可详细阅读面板字段参考。