spacetimedb-upgrade

将此技能用于 SpacetimeDB 1.0 到 2.0 的迁移工作。

核心迁移检查

• Reducer 回调已更改。对于持久化且可订阅的结果通知，优先使用事件表；仅当指南中的限制可以接受时，才使用每次调用的 _then() 风格回调。
• 事件类型已更改。在假设旧的 reducer 结果事件结构仍然存在之前，请先更新客户端事件处理。
• 订阅 API 和表访问器名称已更改。请重新生成绑定，并更新调用以使用生成的名称，而不要猜测标识符并手动修改。
• 客户端通过数据库名称或身份连接，而不是沿用旧的模块命名假设。
• 在 Rust 和 C++ 中，sender 现在是一个方法：使用 ctx.sender()。TypeScript 和 C# 的属性语法保持不变。
• 只有主键会生成更新方法。对于其他更改，请通过主键索引更新；如果主键发生变化，则删除后重新插入。
• 定时函数、私有代码生成、轻量模式、CallReducerFlags 和已确认读取都有各自的迁移说明。编辑这些部分之前，请先查看指南中的对应章节。

参考索引

需求	打开
迁移指南和检查清单	references/upgrade.md

指导原则

• 编辑代码前，先确定具体的破坏性变更；指南针对回调、事件、订阅、表命名、连接名称、sender、更新、调度、代码生成、轻量模式、标志和已确认读取分别提供了修复方法。
• 指南建议使用事件表时，优先采用事件表，而不是旧的 reducer 回调模式。
• 更改模块名称、表访问器、可见性或私有项后，请检查生成的客户端 API。