dir_picker 0.5.1

dir_picker: ^0.5.1 copied to clipboard

• Fix flutter build web --wasm. The FFI/JNI implementations are now excluded with dart.library.js_interop instead of dart.library.html, which is false under dart2wasm (#4, authored by coco-de-dev)
• Linux: pick() now throws UnsupportedError when no XDG Desktop Portal, zenity or kdialog is available. Before, it returned null, which looked like a user cancel (#11)
• WebPickedLocation is now declared on native platforms too, so location is WebPickedLocation (as in the README) compiles everywhere. Before, it failed with "'WebPickedLocation' isn't a type" outside the web (#12)
• Allow dbus 0.8.x (#8)
• Format code with the current dart format and silence a lint in the generated JNI bindings (#7)
• Correct the Android minimum (API 24+) and the AndroidOptions.shouldPersist default (false) in the README, and note Wasm support (#6)

• Breaking: Raise minimum supported SDK to Flutter 3.44 / Dart 3.12
• Migrate Android to built-in Kotlin (no longer applies the Kotlin Gradle Plugin)

• Update document

• Add DirPicker.listEntries() to list files and directories from a previously picked location
• Add FileSystemEntry with relativePath, metadata, and nullable web uri
• Breaking: DirPicker.pick() now takes a single PickOptions? options parameter instead of separate per-platform named parameters (androidOptions, linuxOptions, macosOptions, windowsOptions)
• Breaking: Rename SelectedLocation → PickedLocation, NativeLocation → IOPickedLocation, WebSelectedLocation → WebPickedLocation
• Add PickOptions sealed class with platform-specific factory constructors: PickOptions.android(...), PickOptions.macos(...), PickOptions.linux(...), PickOptions.windows(...)
• Migrate jnigen.yaml and ffigen.yaml to Dart scripts in tool/ directory for better maintainability (#3, authored by alihassan143)
• Update jni dependency to 1.0.0 (#3, authored by alihassan143)
• Update jnigen dev dependency to 0.16.0 (#3, authored by alihassan143)
• Fix ffigen configuration to support latest API changes in ffigen 20.1 (#3, authored by alihassan143)

Migration guide #

// Before
DirPicker.pick(androidOptions: AndroidOptions(shouldPersist: true));
DirPicker.pick(macosOptions: MacosOptions(acceptLabel: 'Open'));

// After
DirPicker.pick(options: PickOptions.android(shouldPersist: true));
DirPicker.pick(options: PickOptions.macos(acceptLabel: 'Open'));

// Before
if (location is NativeLocation) { ... }
if (location is WebSelectedLocation) { ... }

// After
if (location is IOPickedLocation) { ... }
if (location is WebPickedLocation) { ... }

• Add README usage examples for handling WebSelectedLocation on web and NativeLocation on native

• Breaking: DirPicker.pick() now returns SelectedLocation? instead of Uri?
• Add SelectedLocation abstract class with NativeLocation (native platforms) and WebSelectedLocation (web)
• Web: return WebSelectedLocation wrapping FileSystemDirectoryHandle — use .handle to access directory contents via the File System Access API
• Web: throw UnsupportedError on browsers that do not support showDirectoryPicker() (Firefox/Safari)

• Fix Swift Package Manager detection on pub.dev

• Add Swift Package Manager (SPM) support for iOS and macOS
• Breaking: Rename MacosOptions.prompt → MacosOptions.acceptLabel for consistency with other platforms
• Add MacosOptions.message parameter to customize the panel message
• Fix AndroidOptions.shouldPersist default value to false

• Initial version