@ziioapp/finder-opfs
v0.1.0
Published
ZiioApp OPFS backend adapter for @ziioapp/finder
Readme
@ziioapp/finder-opfs
把 @ziioapp/os-features 的 ZiioApp OPFS 应用数据目录接入 @ziioapp/finder。这是可选适配包;Finder 核心不依赖它。
import { createOpfsFinderBackend } from "@ziioapp/finder-opfs";
const opfsBackend = createOpfsFinderBackend({ appId: "unia" });
await opfsBackend.ensureLayout();
// <FinderDesktop backend={opfsBackend} api={finderStore} />appId 决定文件根目录,即 getZiioOpfsAppPaths(appId).appData;可选 userId 会同时传给目录布局初始化。也可以通过 id、label 覆盖 Finder 中展示的后端标识和名称。调用 ensureLayout() 后再展示或操作文件。
文件路径对 Finder 保持无前导斜杠的相对形式,适配器负责与 OPFS 绝对路径转换。它沿用原 unia 和 demo-paper-smasher 实现的读写、重命名及不支持原生 move() 时的复制回退逻辑。浏览器需要支持 OPFS;不同 origin/存储分区不会因为安装同一个包而自动共享文件。
该包不适配 opfs-tools API;使用它的应用可以继续提供自己的 FsBackend。
