Getting Started with FRAME.SCRIPTS v2

scripts 可全局安装

npm install -g yswl2.scripts

1. Available Scripts

In the project directory, you can run:

1.1 yswl2-scripts start

Runs the app in the development mode.

• -t
  html title

yswl2-scripts start -title [title]

• -r
  webpack 打包的入口的文件

yswl2-scripts start -r [roopPath]

• -e
  当前使用的环境变量名称 (默认 development)
  例如 -e test 则匹配的文件为
  .env.test.local
  .env.test
  .env

yswl2-scripts start -e [env]

• -f
  html favicon 路径

yswl2-scripts start -f [favicon]

webpack 启动项目的端口, 优先级为最高优先级

• -p

yswl2-scripts start -p [port]

1.2 yswl2-scripts build

builid the app in the production mode.

• -t
  html title

yswl2-scripts start -title [title]

• -r
  webpack 打包的入口的文件

yswl2-scripts start -r [roopPath]

• -e
  当前使用的环境变量名称 (默认 production)
  例如 -e test 则匹配的文件为
  .env.test.local
  .env.test
  .env

yswl2-scripts start -e [env]

• -f
  html favicon 路径

yswl2-scripts start -f [favicon]

• -o
  打包输出文件路径 默认 dist

yswl2-scripts start -p [outputPath]

• -d
  生成注释文件 index.d.ts

yswl2-scripts start -d

• -l
  深度打包关联子项目

yswl2-scripts start -l

• -c
  是否压缩打包文件

yswl2-scripts start -c

2. HTML ENV

自定义环境 .env 变量合并输出
匹配规则 -e [envname] -> ( .env | .env.[envname] | .env.[envname].local) 变量权重 .env.[envname].local > .env.[envname] > .env

例如:
.env

MODULE_NAME = name1
MODULE_TEST = test1
MODULE_NUMBER = 1

.env.[envname]

MODULE_NAME = name2
MODULE_NUMBER = 2

.env.[envname].local

MODULE_NUMBER = 3

输出为:

MODULE_NAME = name2
MODULE_TEST = test1
MODULE_NUMBER = 3

3. yswl2.config.js

配置文件, 根据 -env 匹配
yswl2.config.js
yswl2.config.[envname].js
yswl2.config.[envname].local.js

root?: boolean

pacakges?: Package[]
    
serverOptions?: Configuration

    /** 排序 */
descOrder?: string[]

    /** 类型 */
moduleTest?: RegExp

    /** only root production module using'
     * @default './'
     */
publicPath?: string

    /** css px 转 rem 设计宽度 */
pxToRem?: false | number

3.1 pacakges

默认 pacakges

• react v19.2
• react-dom v19.2
• react-router-dom v6
• antd v5.21.3
• @ant-design/icons v5.6.1
• react-redux v9.2.0
• @reduxjs/toolkit v2.9.1
• rxjs
• axios
• dayjs

4. BUG 修复

4.1 修复 编辑器 braft-editor 不支持 react 19