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