工程接入

工程接入负责让 Oiyo 参与项目的开发、构建和类型生成流程。接入完成后，Oiyo 才能启用页面、扫描和类型生成等框架能力，并在 Vite 构建中处理相关逻辑。

接入内容

工程接入包含三部分：

• 命令接入：通过 oiyo dev、oiyo build、oiyo prepare 运行 Oiyo。
• 构建接入：通过 OiyoPlugin() 接入 Vite 构建系统。
• 类型接入：通过 .oiyo/tsconfig.json 启动类型系统。

配置命令

在 package.json 中配置脚本：

{
  "scripts": {
    "dev": "oiyo dev",
    "build": "oiyo build",
    "postinstall": "oiyo prepare"
  }
}

命令说明：

• oiyo dev 用于开发环境。
• oiyo build 用于生产构建。
• oiyo prepare 用于生成 Oiyo 构建依赖。

配置 Vite 插件

在 vite.config.ts 中注册 OiyoPlugin()：

import { defineConfig } from 'vite'
import OiyoPlugin from '@skiyee/oiyo/plugin'

export default defineConfig({
  plugins: [
    OiyoPlugin(),
  ],
})

配置 TypeScript

让项目根 tsconfig.json 继承 .oiyo/tsconfig.json：

{
  "extends": "./.oiyo/tsconfig.json",
  "compilerOptions": {
    "types": [
      "vite/client"
    ]
  }
}

验证接入

完成工程接入后，按这个顺序检查：

1. 运行 oiyo dev。
2. 检查 .oiyo/tsconfig.json 是否存在。
3. 检查 tsconfig.json 是否继承 ./.oiyo/tsconfig.json。
4. 检查 vite.config.ts 是否注册 OiyoPlugin()。