目录结构说明

• examples 本地运行示例
• src
  • code 代码编辑器相关
  • config 项目配置项
  • events 事件
  • extension-manager 扩展管理
  • gui 组件
  • helper 辅助方法 主要供sdk和组件调用
    • storage 存储相关
    • logger 控制台打印
  • import 项目引用的一些json文件
  • libs 第三方js
  • msg 多语言配置
  • polyfills 历史兼容处理
  • resource 项目资源
  • scratch-extend 对scratch方法的扩展或修改
    • widgets 自定义组件
    • generator Blockly转码
  • sdk 接口
  • util 工具方法

安装依赖

yarn

私有 npm 库配置

因为使用了公司内部 npm 服务器，绑定方法如下：

vim /etc/hosts
# 添加如下地址到 hosts 中
192.168.13.228 npm.makeblock.local 【ip地址具体参考下面文档】

设置仓库

npm set registry http://npm.makeblock.local:4873

参考：http://km.makeblock.com/pages/viewpage.action?pageId=23979311

运行

mac

# 运行
npm start
# 编译到开发环境
npm run build
# 编译到生产环境
npm run dist

win

# 运行
npm run _start

启动硬件联调模式

npm install sensorium-server -g

在命令行任意目录，输入以下命令，开启工具，即可连线调试 mscratch:

ss

其他问题

mscratch更新须知

• webpack.config.js 和 scratch-extend/ 文件：

  改动地方应添加简单注释，方便文件更新时对比，建议格式为：

  // modified by Kane: url changed, file changed, new file...

• scratch-vm 和 scratch-gui 更新

  1. 项目存放在 https://github.com/MakeblockTeam中
  2. 将官方最新的 develop 分支合并到我们 fork 的仓库中
  3. mscratch 中更新这中 npm 包路径为 github 项目的，需要使用 yarn add 的方式

遇到 yarn 安装 startaudiocontext 报错，需要将 yarn 的版本号切换到 v0.27.5

scratch3 扩展中如果有新增的勾选块，需要将信息更新到 opcode-labels.js 中，参照 music_getTempo