A
Air官方
移植标准 S7:选择器——系统 Picker 语义对齐
「Air 系列移植标准」第七篇:S7 要求文件选择场景全部对齐系统选择器语义——打开、保存、另存、目录选择、格式选择,都走系统通道并语义正确。
▍定义
应用内一切文件选择动作(打开、导入、保存、另存、导出、目录选择)使用系统选择器(Picker),携带正确的参数(类型过滤、默认名、格式列表、多选支持),返回的授权 URI 正确消费。应用自绘的文件浏览器(应用内画一个假的文件管理器)不达标——除非它是应用的核心功能(文件管理类应用除外条款)。
▍为什么重要
系统选择器是安全模型与用户习惯的交汇点:用户在系统界面里完成授权(安全感与熟悉感);系统选择器有最近文件、收藏、云盘集成(用户效率);应用自绘文件界面对沙箱路径的呈现要么误导(显示不完整路径)要么危险(诱导授权理解偏差)。
▍达成要点
调用参数的完整性(文件类型过滤按应用实际支持格式给全——过滤器写错是打开失败的日常原因;保存场景带默认文件名与格式列表);URI 消费链(选择结果的读取、长期使用的持久化授权、会话结束的失效处理);多类型场景的分诊(打开与导入走选择器、目录授权走目录选择器——两类通道别混);格式选择交互(导出多格式时的格式选择用原生面板——CAD 工程导出格式走动作面板的实践可参考)。
▍自查方法
全场景矩阵:打开各类型文件、保存覆盖与新建、另存为改名、导出各格式、目录授权、取消路径(用户取消不报错不残留状态);跨启动的授权保持(昨天选的目录今天还能用——持久化授权的验证);外部分享进来的文件打开(别的应用分享文件给本应用的场景)。
▍常见不达标形态
类型过滤器错(看得见选不了、或选了打不开);保存无默认名(每次都要手输全名);取消报错(用户取消被当异常处理——弹错误框)。
▍一句话
S7 的完成度看细节:默认名、过滤器、取消路径——用户一天碰三次的地方,每次都要顺。
更多文件桥实战案例,欢迎到 apps 板块翻看 56 篇《鸿蒙PC适配全记录》系列实录。
「Air 系列移植标准」第七篇:S7 要求文件选择场景全部对齐系统选择器语义——打开、保存、另存、目录选择、格式选择,都走系统通道并语义正确。
▍定义
应用内一切文件选择动作(打开、导入、保存、另存、导出、目录选择)使用系统选择器(Picker),携带正确的参数(类型过滤、默认名、格式列表、多选支持),返回的授权 URI 正确消费。应用自绘的文件浏览器(应用内画一个假的文件管理器)不达标——除非它是应用的核心功能(文件管理类应用除外条款)。
▍为什么重要
系统选择器是安全模型与用户习惯的交汇点:用户在系统界面里完成授权(安全感与熟悉感);系统选择器有最近文件、收藏、云盘集成(用户效率);应用自绘文件界面对沙箱路径的呈现要么误导(显示不完整路径)要么危险(诱导授权理解偏差)。
▍达成要点
调用参数的完整性(文件类型过滤按应用实际支持格式给全——过滤器写错是打开失败的日常原因;保存场景带默认文件名与格式列表);URI 消费链(选择结果的读取、长期使用的持久化授权、会话结束的失效处理);多类型场景的分诊(打开与导入走选择器、目录授权走目录选择器——两类通道别混);格式选择交互(导出多格式时的格式选择用原生面板——CAD 工程导出格式走动作面板的实践可参考)。
▍自查方法
全场景矩阵:打开各类型文件、保存覆盖与新建、另存为改名、导出各格式、目录授权、取消路径(用户取消不报错不残留状态);跨启动的授权保持(昨天选的目录今天还能用——持久化授权的验证);外部分享进来的文件打开(别的应用分享文件给本应用的场景)。
▍常见不达标形态
类型过滤器错(看得见选不了、或选了打不开);保存无默认名(每次都要手输全名);取消报错(用户取消被当异常处理——弹错误框)。
▍一句话
S7 的完成度看细节:默认名、过滤器、取消路径——用户一天碰三次的地方,每次都要顺。
更多文件桥实战案例,欢迎到 apps 板块翻看 56 篇《鸿蒙PC适配全记录》系列实录。
楼主
7 天前