自定义项目设置面板 ​

项目设置是存放和项目开发相关配置的地方，例如引擎模块、文件后处理配置等，对应配置的修改变动会记录在项目目录的 settings 目录下。

注意 ：settings 目录默认是进入项目版本管理的，在扩展自定义项目设置时，请不要记录一些临时数据或者是存在系统差异的数据配置，以免不同设备的用户在同步数据时遇到问题。

面板介绍 ​

项目设置 里存放的是和项目运行相关的配置，这部分配置存放在项目目录下的 settings 文件夹中，需要纳入版本管理，多人共享配置，否则可能导致不同机器上运行不一致的问题。

可在顶部菜单栏中找到 项目 -> 项目设置 菜单，如下图所示：

点击后可打开设置设置面板，如下图所示：

项目设置面板左侧是功能模块选项卡，右侧则对应功能的配置修改界面。

我们可以通过自定义此面板的显示数据，为项目新增自定义配置，借助项目设置面板实现项目配置的可视化管理。

如果不需要纳入版本管理，同时对本机的所有项目生效，则需要自定义编辑器相关的配置，请参考文档 自定义偏好设置 。

自定义项目设置 功能允许一个我们注册多个选项卡，所以左侧选项卡上会有一行小字，标示选项卡属于哪一个扩展。

数据配置与显示 ​

我们在项目配置里新增扩展的配置，也需要通过在扩展定义文件 package.json 里添加 contributions 配置来实现。

自定义项目设置需要依赖数据配置，需要先在 contributions.profile.project 里定义好相关数据字段。更多详细信息可以参看 配置系统

这里我们举例新建一个叫做 first-panel 的扩展：

// package.json
    "name": "first-panel",
    "contributions": {
        "profile": {
            "project": {
                "foo": {
                    "default": 1
                "foo1": {
                    "default": 0.4
                "foo2": {
                    "default": false
                "foo3": {
                    "default": 0
                "foo4": {
                    "default": "label"
}

注意 ：项目设置里的配置数据，都应该存放在 profile.project 字段中，标记这份配置需要跟随项目，并且需要同步给该项目的其他开发者。

当定义好数据字段后，还需要在 contributions.project 字段里定义需要显示的数据以及用什么 UI 组件来显示。如下所示：

// package.json
    "name": "first-panel",
    "contributions": {
        "profile": {
            // ...
        "project": {
            "tab1": {
                "label": "test",
                "content": {
                    "foo": {
                        "ui": "ui-num-input"
                    "foo1": {
                        "ui": "ui-slider",
                        "attributes": {
                            "min": 0,
                            "max": 1,
                            "step": 0.1
                    "foo2": {
                        "ui": "ui-checkbox"
                    "foo3": {
                        "ui": "ui-select",
                        "items": [
                                "value": 0,
                                "label": "ITEM 0"
                                "value": 1,
                                "label": "ITEM 1"
                                "value": 2,
                                "label": "ITEM 2"
            "tab2": {
                "label": "test2",
                "content": {
                    "foo4": {
                        "ui": "ui-input"