启动脚本
Cordis 提供了一套命令行工具,用于读取配置文件并启动应用。
应用目录
任何 Cordis 应用都有一个顶层 package.json
文件。包含该文件的目录称为 应用目录。
根据你的安装方式,应用目录的位置可能不同:
- 模板项目:你所创建的项目目录,如
D:/dev/cordis-app
。
本节中介绍的所有命令都需要在应用目录下运行。
基本用法
打开应用目录下的 package.json
文件,你将看到以下内容:
json
{
"scripts": {
"dev": "cross-env NODE_ENV=development cordis start --import tsx",
"start": "cordis start"
}
}
这里定义的两个脚本分别能够在生产模式和开发模式下启动 Cordis 应用。
现在让我们尝试运行 dev
脚本:
yarnnpmpnpm
yarn
yarn dev
模块热替换
内置插件 @cordisjs/plugin-hmr 实现了插件级别的模块热替换。每当你修改你的本地文件时,Cordis 就会尝试重载你的插件,并在命令行中提醒你。
这里的行为也可以在配置文件中进行定制:
cordis.yml
- id: biv21g
name: cordis/group
config:
- id: 0txz1f
name: '@cordisjs/plugin-hmr'
config:
root: '**/src'
TIP
由于部分 Linux 系统有着 8192 个文件的监听数量限制,你可能会发现开发模式运行出现如下的报错:
text
NOSPC: System limit for number of file watchers reached
此时你可以使用下面的命令来增加监听数量限制:
sh
echo fs.inotify.max_user_watches=524288 |
sudo tee -a /etc/sysctl.conf &&
sudo sysctl -p
另一种方案是只监听部分子路径,例如将 root
改为 external/foo
(其中 foo
是你正在开发的插件目录,参见下一节的工作区指南),这将忽略其他目录下的变化,并依然对你的插件进行热重载。当你同时开发多个插件时,你也可以将 root
改成一个数组来使用。