配置说明

IDE 配置

product.json

IDE 的产品标识配置，位于项目根目录：

json

{
  "productName": "MiniDev Studio",
  "applicationName": "minidev-studio",
  "dataFolderName": ".minidev-studio",
  "version": "1.3.6",
  "urlProtocol": "minidev-studio",
  "darwinBundleIdentifier": "com.woodare.minidev-studio"
}

环境变量

通过 .env 文件（参考 .env.sample）配置开发环境：

变量名	说明	默认值
`IDE_SERVER_PORT`	Node Server 端口	自动分配
`WS_PATH`	WebSocket 路径	默认路径
`OPENSUMI_DEVTOOLS`	开启 IDE DevTools	`false`

bash

# .env
OPENSUMI_DEVTOOLS=true
IDE_SERVER_PORT=8080

编译器配置

模拟器使用 Vite 驱动编译。编译器根据 app.json 的 framework 字段自动选择：

framework	编译器行为
`vue`	使用 Vue 3 插件集，解析 `.vue` 页面
`react`	使用 React 插件集，解析 `.tsx/.jsx` 页面

Vite 插件：vite-plugin-minidev

IDE 内置的 Vite 插件，负责：

Shell HTML 注入 — 生成包含 NavBar/TabBar/StatusBar 的容器页面
rpx → vw 转换 — CSS 中的 rpx 单位自动转为 vw
桥接 API 注入 — 通过 preload 脚本注入 window.__MINIDEV__

rpx 单位

rpx（responsive pixel）是小程序的响应式单位。1rpx = 屏幕宽度 / 750。编译器会自动转换为 vw 单位以在模拟器中正确显示。

常用命令

bash

# IDE 开发相关
yarn                     # 安装依赖
yarn rebuild-native      # 重建原生模块
yarn download-extension  # 下载 VS Code 扩展

# 启动
yarn start               # 完整编译后启动
yarn start:dev           # 增量编译 + 热监听启动（推荐）
yarn start:quick         # 跳过编译直接启动（需 out/ 已存在）

# 调试
OPENSUMI_DEVTOOLS=true yarn start  # 开启 DevTools

# 打包
yarn make                # 生成安装包

配置说明 ​

IDE 配置 ​

product.json ​

环境变量 ​

编译器配置 ​

Vite 插件：vite-plugin-minidev ​