1# 文件子系统Changelog 2 3## file-access-across-devices 接口行为变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11分布式文件业务在检测到可信设备连接同一个WiFi会自动触发建链,但该规格存在以下两个问题: 12 131.只适用于同WiFi设备场景,不同WiFi间无法建链,导致分布式文件业务无法使用。 14 152.自动建链功能也存在功耗开销,即使用户不使用分布式文件功能,但链路一直存在。 16 17鉴于以上两个原因,需要在新版本上对该规格进行整改。 18 19**变更影响** 20 21该变更为不兼容变更。 22 23变更前:由分布式文件业务监测同WiFi可信设备并自动触发建链,应用无需主动建链,但仅适用同WiFi场景。 24 25变更后:新增主动建链接口,由应用通过主动调用接口触发建链,适用于同WiFi和不同WiFi的场景。 26 27 28**起始 API Level** 29 30API11 31 32**变更发生版本** 33 34从OpenHarmony SDK 5.0.0.39版本开始。 35 36**变更的接口/组件** 37 38本次变更仅涉及新增以下接口: 39 40| 名称 | 描述 | 41|-----------------|------------------------------------------------| 42| connectDfs(networkId: string, listeners: DfsListeners) | 应用调用该接口主动触发建链,执行结果通过DfsListeners回调内onStatus上报。 | 43 44**适配指导** 45 46应用使用新接口可以同时支持用同WiFi和不同WiFi场景下的跨设备文件访问能力,详见[跨设备文件访问](../../../application-dev/file-management/file-access-across-devices.md) 47 48 49