17370845950

salix 前端框架已正式停止维护，其功能由更活跃、更稳定的 `salix-core` 取代；本文指导开发者快速迁移原有 salix 应用（如计数器示例），替换依赖、更新 api 调用方式，并验证渲染流程。

如果你正遇到类似 Uncaught TypeError: Cannot read properties of undefined (reading 'edits') 的错误（尤其在 salix.js:257 报错），这通常是因仍在使用已废弃的原始 Salix 库所致——该库自 2025 年起不再维护，与现代 Rascal 运行时及前端环境存在兼容性断裂。

✅ 正确做法是迁移到官方推荐的继任者：salix-core。它重构了核心渲染机制，修复了 DOM 补丁（patchDOM）中对 edits 字段的未定义访问问题，并提供了更健壮的初始化协议和类型安全的 API。

迁移关键步骤

1. 替换依赖路径
   在 .rascal 项目中，将旧的 import salix::... 改为：

   import salix::core::App;
   import salix::core::Dom;
   import salix::core::Effects;

2. 更新应用构造方式
   salix-core 不再使用 makeApp，而是通过 App::create 构建：

   App[Model] counterApp(str appId = "counterApp") 
     = App::create(appId, init, view, update);

3. 确保 HTML 初始化匹配新协议
   salix-core 要求页面加载后显式调用 SalixCore.start()，且

   必须存在。你的 index.html 中应包含：

4. 检查构建输出路径
   使用 webApp(...) 时，确保 salix-core.js 已正确复制到 lib/ 目录（而非旧版 salix.js）。推荐通过 Rascal Maven 插件 自动管理依赖。

⚠️ 注意事项：

• salix-contrib（如 ACE 编辑器、Mermaid 图表等扩展）需同步升级至兼容 salix-core 的版本；
• 旧版 SalixApp 类型和 webApp 的底层行为已被重写，直接复用原代码将导致运行时失败；
• /init 端点返回 HTML 仅说明服务端渲染成功，但客户端 JS 无法解析旧协议 → 迁移后该端点行为不变，但客户端启动逻辑必须匹配 salix-core 的生命周期。

完成迁移后，刷新页面即可看到计数器正常渲染与响应——错误 Cannot read properties of undefined (reading 'edits') 将彻底消失。建议同步查阅 salix-core 官方示例 获取完整可运行模板。