persistent_file_access_backend library
Advanced backend APIs for persistent filesystem access.
Most applications should rely on automatic platform selection and import
only package:persistent_file_access/persistent_file_access.dart.
Import this library to configure a built-in backend, migrate legacy handles,
or implement support for another platform or access mechanism.
Classes
- MacOSPersistentAccessBackend
- macOS persistent access implemented with bounded security-scoped operations.
- PersistentAccessBackend
- Platform-specific creation, recovery, and lifecycle behavior.
- PersistentAccessHandleDescription
- Non-secret metadata that a backend can recover without opening a handle.
- WindowsPathPersistentAccessBackend
- Windows persistent access backed by versioned normalized filesystem paths.
Enums
- PersistentAccessEntityKind
- The filesystem entity represented by a persistent access handle.
Functions
-
platformPersistentAccessBackend(
{PersistentAccessEntityKind? macOSLegacyHandleKind}) → PersistentAccessBackend - Creates the built-in backend for the current desktop platform.
Exceptions / Errors
- InvalidPersistentAccessHandleException
- A stored handle is structurally malformed and cannot become usable later.
- PersistentAccessDeniedException
- A handle resolved, but its platform access grant could not be activated.
- UnsupportedPersistentAccessHandleException
- A stored handle uses a backend or schema version this package cannot read.