Skip to content

启动脚本

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 改成一个数组来使用。