UFilesChannel class abstract final

Static Methods

deleteSecret(String alias) → Future<void>

excludeFromBackup(String path) → Future<void>

iOS/macOS: keeps path out of iCloud and device backups.

freeSpace(String path) → Future<int?>

Bytes available to the app on the volume holding path.

keepAwake({required bool enabled, String? title, String? text, int progress = -1}) → Future<void>

Keeps the process alive and the machine awake while downloads run. On Android this is a dataSync foreground service whose notification shows title, text and progress (0-100, or -1 for indeterminate); elsewhere it is a power assertion or a background-task grant.

loadSecret(String alias) → Future<Uint8List?>

Null means "no such secret". A locked or failing key store throws instead, so callers never mistake a temporarily unreadable key for a missing one and overwrite it.

open(String pathOrUri, {String? mimeType}) → Future<bool>

Opens a file (path or content URI) with the default app.

reveal(String pathOrUri) → Future<bool>

Shows the file in Finder / Explorer / the Files app / the Downloads app.

saveAs({required String sourcePath, required String fileName, String? mimeType}) → Future<String?>

Shows the native "save as" UI and copies sourcePath to the chosen place. Returns the destination (path or URI), or null when the user cancelled.

saveToDownloads({required String sourcePath, required String fileName, String? mimeType, String? subfolder}) → Future<String?>

Android: copies sourcePath into the public Downloads collection through MediaStore (or the legacy public directory below API 29). Returns the resulting content URI.

storeSecret(String alias, Uint8List secret) → Future<bool>

systemCancel(String id) → Future<void>

systemDownloadsSupported() → Future<bool>

Whether this platform can hand downloads to an OS service that survives the app being killed.

systemEnqueue({required String id, required String url, required Map<String, String> headers, required String fileName, String? path, String? title, String? mimeType, bool wifiOnly = false, bool publicDownloads = false, bool showNotification = true}) → Future<bool>

Hands a download to the OS. path is the final file path; with publicDownloads on Android the file goes to the shared Downloads collection instead and path is ignored.

systemQuery() → Future<List<USystemDownloadStatus>>