FluidFramework v2.30.0 版本技术解析

FluidFramework 是微软开发的一个分布式实时协作框架，它通过提供数据同步和协作功能，使开发者能够构建多人实时协作的应用程序。最新发布的 v2.30.0 版本带来了一系列重要的功能更新和API改进，特别是在SharedTree DDS（分布式数据结构）方面有显著增强。

SharedTree DDS 增强

TreeBranchEvents 事件扩展

新版本中，TreeBranchEvents 接口现在包含了来自 TreeViewEvents 的 rootChanged 事件。这一改进使得开发者能够更方便地监听树结构根节点的变化，为构建响应式UI提供了更好的支持。

SchemaFactoryAlpha 新增 scopedFactory 方法

SchemaFactoryAlpha 类新增了 scopedFactory 方法，这个方法为开发者提供了一种简便的方式来创建具有嵌套作用域字符串的新 SchemaFactory。这一改进简化了复杂数据结构的定义过程，特别是在需要多个作用域的场景下。

延迟模式引用规则明确化

新版本对延迟模式引用（lazy schema references）的解析规则进行了明确和规范化。延迟模式引用通常表现为 () => MySchema 的形式，用于处理模式间的正向引用（forward reference），包括递归和共递归模式。

TreeViewConfiguration 现在明确记录了它与延迟模式引用的关系，并强制执行了一些隐式假设，如禁止在解析延迟模式引用后修改 AllowedTypes。此外，新增的 evaluateLazySchema API 为内部代码提供了一致的延迟模式引用评估方式，包括错误报告和缓存机制。

导出格式中的句柄替换API重新设计

v2.30.0 版本重新设计了处理导出格式中句柄替换的Alpha API。移除了各种导入导出API中的 valueConverter 选项，改为支持对结果树进行后续处理来实现所需的替换操作。新增了四个辅助API来支持这一改进：

1. cloneWithReplacements
2. replaceHandles
3. replaceConciseTreeHandles
4. replaceVerboseTreeHandles

API 清理与优化

IContainer.getContainerPackageInfo() 弃用

IContainer.getContainerPackageInfo() 方法已被标记为弃用，并计划在2.40.0版本中移除。开发者应改用 IContainer.getLoadedCodeDetails() 返回的 IFluidCodeDetails.package 属性来获取相同信息。

容器运行时模块清理

新版本从 @fluidframework/container-runtime 包中移除了多个不再需要对外公开的类型定义，包括：

• 与文档模式相关的类型（如 IDocumentSchema, IDocumentSchemaChangeMessage 等）
• 垃圾回收相关的类型（如 GCFeatureMatrix, GCNodeType 等）
• 摘要相关的类型（如 ISummarizerInternalsProvider, ISummarizerRuntime 等）

这些清理工作有助于减少API表面积，提高框架的易用性和维护性。

消息处理函数统一

process 函数已被 processMessages 替代，这一变更影响了多个接口和类，包括：

• FluidDataStoreRuntime
• IDeltaHandler
• IFluidDataStoreChannel
• MockFluidDataStoreRuntime
• MockDeltaConnection

同时，processDocumentSchemaOp 也被 processDocumentSchemaMessages 替代。这些变更使得API命名更加一致和直观。

OrderedEditSet 接口增强

OrderedEditSet 接口新增了 getLocalEdits 方法，这一改进消除了之前需要通过导入 EditLog 并强制类型转换来访问本地编辑的需求。同时，移除了 ./test/EditLog 导出，进一步简化了API结构。

总结

FluidFramework v2.30.0 版本在SharedTree DDS功能上进行了多项增强，包括事件系统扩展、模式工厂改进、延迟引用规则明确化等。同时，通过API清理和优化，提高了框架的一致性和易用性。这些改进为开发者构建更强大、更可靠的实时协作应用提供了更好的支持。