安装与分享

Cocos Creator 在启动项目的过程中会搜索并加载 全局项目 两个路径下的扩展。

如果需要将扩展应用到所有的 Cocos Creator 项目,可以选择将扩展包放在 全局 扩展包路径中:

  • Windows%USERPROFILE%\.CocosCreator\extensions
  • macOS$HOME/.CocosCreator/extensions

如果只希望将扩展应用到指定的项目,可以选择将扩展包放在 项目 扩展包路径中:

  • $你的项目地址/extensions

打包扩展

当编写好一个扩展后,如果要将扩展共享给其他人使用,则需要将该扩展包压缩。

例如扩展包 hello-world,如果放在项目扩展包路径中,其目录结构如下:

  1. MyProject
  2. |--assets
  3. |--extensions
  4. |--hello-world
  5. |--package.json
  6. |--browser.js
  7. ...

全选 hello-world 的内部文件(package.jsonbrowser.js),将所有文件压缩成 zip 包,并命名为 hello-world.zip

zip 包内容格式和文件格式一致:

  1. hello-world.zip
  2. |--package.json
  3. |--browser.js

请注意不要在 zip 包内再嵌套一层扩展目录

安装扩展包

  • 首先在编辑器顶部菜单栏中点击 扩展 -> 扩展管理器,打开 扩展管理器 面板。

    安装与分享 - 图1

  • 然后在 扩展管理器 中选择 项目/全局 选项卡,点击 + 按钮,在弹出的文件选择框中选择打包后的扩展 zip 文件,点击 打开。导入的扩展压缩包会被解压并放到指定的位置(项目/全局 扩展包路径)。

  • 最后在 扩展管理器 对应的 项目/全局 选项卡中找到扩展,点击右边的 启用 按钮,刚刚导入的扩展就可以正常运行了。

卸载已安装的扩展

扩展管理器 中找到需要删除的扩展,点击 删除 图标按钮即可,同时扩展所在的文件夹也会删除。如果只需要禁用,可以只选择 “关闭”。

重载扩展

开发过程中,有时候需要修改扩展的内容,但修改后扩展已经运行的逻辑不会自动更新,这时候就需要在编辑器内手动重新载入一次扩展。

扩展管理器 中找到对应的扩展,然后点击 重新载入 图标按钮,这时候编辑器中的扩展将使用最新的代码和文件重新运行。