mirror of
https://github.com/NetEase/tango.git
synced 2026-09-21 05:43:16 +08:00
97 lines
3.7 KiB
Plaintext
97 lines
3.7 KiB
Plaintext
# tango.config.json
|
|
|
|
`tango.config.json` 是 Tango 项目的核心配置文件，当您的项目使用 Tango 设计器在线开发时会读取该文件进行线上开发环境的初始化。
|
|
|
|
## entry
|
|
|
|
非必填。`entry` 是项目的入口文件，用于在线设计器的初始化，默认取值为 `/src/index.js`。
|
|
|
|
## packages
|
|
|
|
项目使用的 npm 包依赖信息，用于定义依赖的类型以及外置依赖资源。该配置项为一个 map，key 为对应的 npm 包名，value 为该依赖的配置信息。
|
|
|
|
- version 包的版本号，必选
|
|
- library UMD 包中的全局变量名，必选
|
|
- type 依赖的类型
|
|
- baseDependency 基础依赖包
|
|
- bizDependency 业务组件依赖包
|
|
- dependency 其他依赖包
|
|
- resources 外置依赖资源列表
|
|
- designerResources 在设计器视图载入的外置资源列表，用来需要区别加载时使用
|
|
- description 描述信息
|
|
|
|
依赖的类型 `type` 可以是 `baseDependency` 即项目的基础依赖，用于获取项目基础物料列表的信息；也可以是 `bizDependency` 即业务组件依赖，用于获取合并到物料面板业务组件菜单中的业务组件列表；也可以是 `depenency` 即项目的其他依赖，只用于提供 external 信息与版本信息等，不会和物料面板产生关系。
|
|
|
|
当配置了外置依赖资源 `resources` 与其对应的全局变量 `library` 时，当这些依赖被 import 时，相关资源不会被打包到 bundle 中，而是在运行时再去外部获取这些扩展依赖，其等效于之前的 `sandbox.externalResources` 与 `sandbox.externals` 配置项。此外，可以将 `resource` 中的版本号替换为 `{{version}}`，其会在平台上构建时替换为版本号。特殊的，可以定义 `designerResources` 用于适配平台的设计器视图。
|
|
|
|
```json
|
|
{
|
|
"react": {
|
|
"version": "17.0.2",
|
|
"library": "React",
|
|
"type": "dependency",
|
|
"resources": ["https://unpkg.com/react@{{version}}/umd/react.development.js"]
|
|
},
|
|
"react-dom": {
|
|
"version": "17.0.2",
|
|
"library": "ReactDOM",
|
|
"type": "dependency",
|
|
"resources": ["https://unpkg.com/react-dom@{{version}}/umd/react-dom.development.js"]
|
|
},
|
|
"@music163/tango-boot": {
|
|
"version": "0.1.3",
|
|
"library": "TangoBoot",
|
|
"type": "baseDependency",
|
|
"resources": ["https://unpkg.com/@music163/tango-boot@{{version}}/dist/boot.js"],
|
|
"description": "云音乐低代码运行时框架"
|
|
},
|
|
"@music163/antd": {
|
|
"version": "0.1.2",
|
|
"library": "TangoAntd",
|
|
"type": "baseDependency",
|
|
"resources": [
|
|
"https://unpkg.com/@music163/antd/{{version}}/dist/index.js",
|
|
"https://unpkg.com/@music163/antd/{{version}}/dist/index.css"
|
|
],
|
|
"description": "云音乐低代码中后台应用基础物料",
|
|
"designerResources": [
|
|
"https://unpkg.com/@music163/antd/{{version}}/dist/designer.js",
|
|
"https://unpkg.com/@music163/antd/{{version}}/dist/index.css"
|
|
]
|
|
},
|
|
"@music163/biz-comp": {
|
|
"type": "bizDependency",
|
|
"version": "0.0.2"
|
|
}
|
|
}
|
|
```
|
|
|
|
:::tip 注意依赖的先后顺序
|
|
由于依赖是按照定义的先后顺序注入至沙箱内，因此需要确保 `packages` 内依赖的先后顺序，否则可能会导致应用加载依赖失败（例如将 `react` 放置在组件包之后，会导致组件包无法正常加载）。
|
|
:::
|
|
|
|
## externalResources
|
|
|
|
除了上述 `packages` 定义的外置依赖资源外，在这里可以定义沙箱启动时引入的非 npm 包的外置依赖资源列表，可以是 `js` 或 `css` 等静态文件。例如：
|
|
|
|
```json
|
|
{
|
|
"externalResources": ["https://tango.netease.io/script.js"]
|
|
}
|
|
```
|
|
|
|
## proxy
|
|
|
|
非必填。项目的代理规则。
|
|
|
|
```json
|
|
{
|
|
"proxy": {
|
|
"/api/pms": {
|
|
"target": "http://cms.qa.igame.163.com",
|
|
"changeOrigin": true
|
|
}
|
|
}
|
|
}
|
|
```
|