Openblock-Web与OpenBlock-Desktop 开发与构建
这里写目录标题
- 🚀OpenBlock-WEB 开发环境搭建
- 一、环境要求
- 二、获取源代码
- 三、安装依赖并本地链接
- 链接验证
- 四、启动项目（需开**三个独立终端**）
- 1. 启动硬件接口服务器
- 2. 启动外部资源服务器
- 3. 启动 GUI 界面
- 五、代码修改生效规则
- 🚀OpenBlock-Desktop 开发环境搭建
- 一、环境要求
- 二、项目架构说明
- 1. 主进程（Main Process）
- 2. 渲染进程（Renderer Process）
- 3. 核心依赖关系
- 三、基于本地核心库开发（Link 模式）
- 1. 准备本地核心库
- 2. 链接本地包到 Desktop 项目
- 3. 验证链接
- 四、安装与编译
- 1. 安装依赖
- 2. 开发模式启动
- 3. 生产模式编译
- 五、打包构建
- 1. 快速打包（不下载外部资源）
- 2. 完整打包（含外部资源）
- 3. 下载指定资源
- 六、构建配置说明
- 1. Webpack 配置
- 2. Electron Builder 配置
- 七、常见问题排查
- 1. `dist/main.js` 未生成
- 2. 本地链接包找不到模块
- 3. node-gyp 编译失败
- 4. 内存不足导致编译失败
- 八、开发工作流建议
- 1. 日常开发流程
- 2. 修改核心库后同步
- 3. 发布前检查清单
🚀OpenBlock-WEB 开发环境搭建
一、环境要求
需提前安装以下软件/工具，版本不匹配易导致编译失败：
- Node.js 14/16（推荐16）
- Python 2.7
- Git
- node-gyp（需按官方说明安装本地编译工具）
二、获取源代码
- 创建项目目录并进入
mkdiropenblockcdopenblock- 克隆核心仓库
gitclone https://github.com/openblockcc/openblock-guigitclone https://github.com/openblockcc/openblock-vmgitclone https://github.com/openblockcc/openblock-blocksgitclone https://github.com/openblockcc/openblock-linkgitclone https://github.com/openblockcc/openblock-resource三、安装依赖并本地链接
- 安装并链接
openblock-blocks
cdopenblock-blocksnpminstallnpmlinkcd..- 安装并链接
openblock-vm
cdopenblock-vmnpminstallnpmlinkcd..- 安装
openblock-gui依赖并关联本地包
cdopenblock-guinpminstallnpmlinkopenblock-blocks openblock-vmcd..链接验证
查看openblock-gui/node_modules下的openblock-blocks、openblock-vm，若指向本地工程目录则链接成功。
四、启动项目（需开三个独立终端）
1. 启动硬件接口服务器
cdopenblock-linknpmstart2. 启动外部资源服务器
cdopenblock-resourcenpmstart3. 启动 GUI 界面
cdopenblock-guinpmrun start- 访问地址：
http://127.0.0.1:8601/ - Webpack 会自动监听代码变动并热更新
五、代码修改生效规则
- openblock-gui / op