From a6ca3dbc269805aff5c314374bed30d2d12d1c61 Mon Sep 17 00:00:00 2001 From: Stuart Morgan Date: Thu, 23 Jan 2025 10:57:06 -0500 Subject: [PATCH] [image_picker] Reference alternate macOS implementations Since we don't currently plan to fix https://github.com/flutter/flutter/issues/125829 in our implementation, and there is now a community implementation that does, reference that in the README and provide a link to quickly locate alternate implementations. Also fixes a copy-paste mistake that was referencing the wrong app-facing plugin in the instructions. --- .../image_picker/image_picker_macos/CHANGELOG.md | 3 ++- packages/image_picker/image_picker_macos/README.md | 12 +++++++++++- .../image_picker/image_picker_macos/pubspec.yaml | 2 +- 3 files changed, 14 insertions(+), 3 deletions(-) diff --git a/packages/image_picker/image_picker_macos/CHANGELOG.md b/packages/image_picker/image_picker_macos/CHANGELOG.md index f1b3bd3f1597..61975da84720 100644 --- a/packages/image_picker/image_picker_macos/CHANGELOG.md +++ b/packages/image_picker/image_picker_macos/CHANGELOG.md @@ -1,5 +1,6 @@ -## NEXT +## 0.2.1+2 +* Updates README to reference alternate implementations. * Updates minimum supported SDK version to Flutter 3.22/Dart 3.4. ## 0.2.1+1 diff --git a/packages/image_picker/image_picker_macos/README.md b/packages/image_picker/image_picker_macos/README.md index 9aa87453532e..7415dfb6cda1 100644 --- a/packages/image_picker/image_picker_macos/README.md +++ b/packages/image_picker/image_picker_macos/README.md @@ -7,16 +7,18 @@ A macOS implementation of [`image_picker`][1]. `ImageSource.camera` is not supported unless a `cameraDelegate` is set. ### pickImage() + The arguments `maxWidth`, `maxHeight`, and `imageQuality` are not currently supported. ### pickVideo() + The argument `maxDuration` is not currently supported. ## Usage ### Import the package -This package is [endorsed][2], which means you can simply use `file_selector` +This package is [endorsed][2], which means you can simply use `image_picker` 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`. @@ -32,7 +34,15 @@ need to add a read-only file acces [entitlement][4]: ``` +## Alternatives + +If you would prefer an implementation that uses the dedicated photo picker UI +available in newer versions of macOS, which is more similar to the iOS +experience, you may want to consider using +[an alternate, unendorsed implementation built by the community][5]. + [1]: https://pub.dev/packages/image_picker [2]: https://flutter.dev/to/endorsed-federated-plugin [3]: https://pub.dev/packages/file_selector [4]: https://flutter.dev/to/macos-entitlements +[5]: https://pub.dev/packages?q=topic%3Aimage-picker+platform%3Amacos diff --git a/packages/image_picker/image_picker_macos/pubspec.yaml b/packages/image_picker/image_picker_macos/pubspec.yaml index d5f7181c903a..ddcd0f118ddd 100644 --- a/packages/image_picker/image_picker_macos/pubspec.yaml +++ b/packages/image_picker/image_picker_macos/pubspec.yaml @@ -2,7 +2,7 @@ name: image_picker_macos description: macOS platform implementation of image_picker repository: https://github.com/flutter/packages/tree/main/packages/image_picker/image_picker_macos issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+image_picker%22 -version: 0.2.1+1 +version: 0.2.1+2 environment: sdk: ^3.4.0