迁移指南· 15 分钟阅读

Julian's Editor 用户迁移指南

手把手教你把 Julian's Editor 项目无损迁移到 Builda。

Julian's Editor 用户迁移指南

如果你之前一直在用 Julian's Editor,这份指南能帮你在 15 分钟内把旧项目完整搬到 Builda,几乎不丢失任何内容

兼容性对照表#

开工之前先看这张表,帮你预判哪些功能需要手动调整:

功能模块Julian's EditorBuilda迁移策略
角色(Sprite)
text
.sprite
text
.blda-actor
自动转换,无损
积木脚本Scratch 方言Builda 标准积木自动映射 95%
音频MP3/OGGMP3/OGG/WAV直接拷贝
自定义扩展
text
.js
扩展
TS 扩展需手动重写
云变量Julian CloudBuilda Cloud需重新配置

⚠️ 唯一需要注意:自定义 JS 扩展无法自动迁移,建议先查清你用了哪些扩展。大多数新手项目不涉及这块。

迁移三步法#

第 1 步:从 Julian's Editor 导出项目#

打开你的旧项目,菜单 → 文件 → 导出为

text
.sb3
/
text
.sb2

这是 Scratch 通用格式,Builda 原生支持。保存到桌面备用。

第 2 步:在 Builda 中导入#

登录 Builda → 首页右上角 「导入项目」 → 选择刚才导出的文件。

Builda 会自动执行:

  • 🔄 角色转换:所有 Sprite 转换为 Builda Actor
  • 🔄 积木映射:Scratch 积木自动翻译为 Builda 积木
  • 🔄 资源迁移:图片、音频原封不动搬过来
  • ⚠️ 警告列表:无法转换的部分会在侧边栏列出

第 3 步:处理警告项#

典型的警告类型与解决方案:

builda
# 警告示例 1:未知积木 [cloud_variable_set]
→ 解决方案:用 Builda 的「云变量」模块替代
  新建云变量 → 设置初始值 → 同步到 Builda Cloud

# 警告示例 2:自定义扩展 [pen.js] 未找到
→ 解决方案:
  1. 在 Builda 扩展市场搜索同名扩展
  2. 或联系原作者提供 TS 版本
  3. 或暂时注释掉,后续手动重写

常见问题#

Q:迁移后积木的执行顺序变了?
A:Julian's Editor 的"并行执行"默认是帧同步,而 Builda 默认事件驱动。如果出现问题,在项目设置里把执行模式切回「帧同步」即可。

Q:字体显示不一样?
A:Builda 使用系统字体栈,Julian's Editor 默认嵌入字体。如需复刻原效果,在资源中心上传字体文件(.ttf / .woff2),在文本组件里选择它。

Q:音效有杂音?
A:Builda 使用更现代的 Web Audio API,对低码率 MP3 可能产生伪影。建议把音频重新编码为 128 kbps 以上 OGGWAV

迁移后的收益#

完成迁移你将获得:

  • 🚀 运行性能提升 2~3 倍(WebGL 2 硬件加速)
  • 📱 原生移动端适配(无需额外打包)
  • ☁️ 云变量跨设备同步
  • 🎨 全新的主题系统(含暗色模式)

需要更多帮助?#

如果你遇到自动迁移无法解决的疑难杂症,请把警告日志发到联系我们页面,我们会 24 小时内回复。