filepicker_windows

🔄 Breaking Changes

• FileDialog.hWndOwner type changed from int to Pointer.
• WindowsKnownFolder is now an extension type that wraps a GUID, allowing it to be used directly anywhere a GUID is expected without unwrapping.
• CustomPlace.field has been replaced with a new folder field of type WindowsKnownFolder.
• CustomPlace now holds a WindowsKnownFolder folder instead.

🚀 Features

• In Flutter apps, when hWndOwner is not set explicitly, the dialog now automatically detects the Flutter window and uses it as the owner.

  This ensures the dialog always opens as a modal in front of the Flutter window, preventing the app from appearing frozen when the user clicks away while the dialog is open.

  In Dart-only apps, no owner is set and the previous behaviour is preserved.

📦 Dependencies

• Bumped minimum required Dart SDK version to 3.11.0.

• Bump minimum required Dart version to 3.4.0

• Add initialDirectory and alwaysShowInitialDirectory fields to DirectoryPicker (#36).

• Add alwaysShowInitialDirectory field to control whether the dialog box should always show the directory defined in initialDirectory to the user, regardless of previous user interaction.

• Fix deprecation warnings
• Update links

• Add addToRecentDocuments field to control whether an item being opened or saved will be added to the recent documents list.
• Add dereferenceLinks field to specify whether shortcuts should be treated as their target items.
• Add showHiddenAndSystemItems field to control whether hidden and system items are displayed in the file dialog.
• Bump minimum required Dart version to 3.2.0.

• Improved code quality.

• Improved code quality.
• Improved documentation.
• Added example for selecting a directory.

• Add getFiles() method into the OpenFilePicker to enable selecting multiple files (#12, thanks to @ritheshSalyan)

• Add support for setting the initial directory (#23, thanks to @amarland)

• Fix crashes in v2.0.6 (#24)

• Update win32 dependency

• Tidy up folders and remove some potential memory leaks

• Update win32 dependency

2.0.3 - 2026-04-11

📦 Dependencies

• Lower minimum Dart SDK to 3.10.

• Upgrade dependencies and resolve lint warnings

• Upgrade win32 dependency

• Enable sound null safety

• Mark as stable version
• Update to new Windows template for example application
• Update package dependencies

• Update APIs

• Basic implementation using win32.
• Add example that shows using OpenFileDialog to select desktop wallpaper.