# file_selector_macos 0.9.5+2

macOS implementation of the file_selector plugin.




## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add file_selector_macos
```
Published: 2026-10-19T21:35:44.870641Z
Expected archive SHA-256: d785431f1910aac8a50e5c492cae912320158030a88703c67b9ef7f1f96fd7ba

Available in cache; verification: upstream_checksum
## Direct dependencies
- cross_file: ^0.3.1
- file_selector_platform_interface: ^2.7.0
- flutter: map[sdk:flutter]
- meta: ^1.10.0

## Package README (untrusted upstream documentation)
# file\_selector\_macos

The macOS implementation of [`file_selector`][1].

## Usage

This package is [endorsed][2], which means you can simply use `file_selector`
normally. This package will be automatically included in your app when you do,
so you do not need to add it to your `pubspec.yaml`.

However, if you `import` this package to use any of its APIs directly, you
should add it to your `pubspec.yaml` as usual.

### Entitlements

You will need to [add an entitlement][3] for either read-only access:
```xml
	<key>com.apple.security.files.user-selected.read-only</key>
	<true/>
```
or read/write access:
```xml
	<key>com.apple.security.files.user-selected.read-write</key>
	<true/>
```
depending on your use case.

[1]: https://pub.dev/packages/file_selector
[2]: https://flutter.dev/to/endorsed-federated-plugin
[3]: https://flutter.dev/desktop#entitlements-and-the-app-sandbox

## Changelog
## 0.9.5+2

* Updates minimum supported SDK version to Flutter 3.47/Dart 3.13.
* Updates minimum macOS version to 12.
* Removes the macOS 10.15 code path that used the deprecated `allowedFileTypes` property.

## 0.9.5+1

* Updates pigeon dev_dependency to ^27.3.2 for analyzer 14 compatibility.
* Updates minimum supported SDK version to Flutter 3.38/Dart 3.10.

## 0.9.5

* Adds `getDirectoryPathWithOptions` and `getDirectoryPathsWithOptions` implementations.

## 0.9.4+6

* Updates to Pigeon 26.

## 0.9.4+5

* Updates minimum supported version to macOS 10.15.
* Updates minimum supported SDK version to Flutter 3.35/Dart 3.9.

## 0.9.4+4

* Updates to Pigeon 25.5.0.

## 0.9.4+3

* Updates configuration to not set `nameFieldStringValue` for `NSOpenPanel`.
* Updates minimum supported SDK version to Flutter 3.27/Dart 3.6.

## 0.9.4+2

* Updates Pigeon for non-nullable collection type support.

## 0.9.4+1

* Adds privacy manifest.
* Updates minimum supported SDK version to Flutter 3.19/Dart 3.3.

## 0.9.4

* Adds Swift Package Manager compatibility.
* Updates minimum supported SDK version to Flutter 3.13/Dart 3.1.

## 0.9.3+3

* Fixes handling of unknown file extensions on macOS 11+.

## 0.9.3+2

* Adds pub topics to package metadata.
* Updates minimum supported SDK version to Flutter 3.7/Dart 2.19.
* Migrates `styleFrom` usage in examples off of deprecated `primary` and `onPrimary` parameters.

## 0.9.3+1

* Updates to the latest version of `pigeon`.

## 0.9.3

* Adds `getSaveLocation` and deprecates `getSavePath`.
* Updates minimum supported macOS version to 10.14.

## 0.9.2

* Adds support for MIME types on macOS 11+.

## 0.9.1+1

* Updates references to the deprecated `macUTIs`.

## 0.9.1

* Adds `getDirectoryPaths` implementation.

## 0.9.0+8

* Updates pigeon for null value handling fixes.
* Updates minimum Flutter version to 3.3.

## 0.9.0+7

* Updates to `pigeon` version 9.

## 0.9.0+6

* Clarifies explanation of endorsement in README.
* Aligns Dart and Flutter SDK constraints.

## 0.9.0+5

* Updates links for the merge of flutter/plugins into flutter/packages.
* Updates example code for `use_build_context_synchronously` lint.
* Updates minimum Flutter version to 3.0.

## 0.9.0+4

* Converts platform channel to Pigeon.

## 0.9.0+3

* Changes XTypeGroup initialization from final to const.

## 0.9.0+2

* Updates imports for `prefer_relative_imports`.
* Updates minimum Flutter version to 2.10.

## 0.9.0+1

* Updates README for endorsement.
* Updates `flutter_test` to be a `dev_dependencies` entry.

## 0.9.0

* **BREAKING CHANGE**: Methods that take `XTypeGroup`s now throw an
  `ArgumentError` if any group is not a wildcard (all filter types null or
  empty), but doesn't include any of the filter types supported by macOS.
* Ignores deprecation warnings for upcoming styleFrom button API changes.

## 0.8.2+2

* Updates references to the obsolete master branch.

## 0.8.2+1

* Removes unnecessary imports.
* Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors
  lint warnings.

## 0.8.2

* Moves source to flutter/plugins.
* Adds native unit tests.
* Converts native implementation to Swift.
* Switches to an internal method channel implementation.

## 0.0.4+1

* Update README

## 0.0.4

* Treat empty filter lists the same as null.

## 0.0.3

* Fix README

## 0.0.2

* Update SDK constraint to signal compatibility with null safety.

## 0.0.1

* Initial macOS implementation of `file_selector`.