You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
samples/desktop_photo_search/material/README.md

65 lines
3.0 KiB

# Photo Search app
This desktop application enables you to search
[Unsplash](https://unsplash.com/) for photographs that interest you.
To use it, you need to add an **Access Key** from
[Unsplash API](https://unsplash.com/developers) to
`lib/unsplash_access_key.dart`.
This sample works on Windows, macOS and Linux.
## A quick tour of the code
This Flutter project builds a desktop application. It utilises the following
desktop specific plugins:
- [file_chooser] to enable the application user to select where to save a photo
from the Unsplash API.
- [menubar] for exposing Image Search functionality through the menu bar.
- [url_launcher] to open external links.
The Unsplash API client entry point is in the [Unsplash] class, and is built
atop [http], [built_value] and [built_collection] for JSON Rest API access.
## Deploying to the Microsoft Store
This sample uses Yehuda Kremer's [MSIX pub package] to bundle up the Windows
release build for distribution to the [Microsoft Store]. Microsoft maintains
a [plethora of documentation][ms_store_publishing_doc] on deploying to the
Microsoft Store.
See the `msix_config` stanza in this sample's `pubspec.yaml` for an
example configuration. Make sure the `display_name`, `publisher_display_name`,
`publisher` and `identity_name` attributes match the settings in your
Microsoft Partner Center application submission.
## macOS Network and File entitlements
To access the network, macOS requires applications enable the
[com.apple.security.network.client entitlement][macOS-client]. For this
sample, this entitlement is required to access the Unsplash API.
Likewise, to save a Photo to the local file system using the `file_chooser` plugin requires the
[com.apple.security.files.user-selected.read-write entitlement][macOS-read-write].
Please see [macOS Signing and Security][macOS-security] for more detail.
[Unsplash]: lib/src/unsplash/unsplash.dart
[built_collection]: https://pub.dev/packages/built_collection
[built_value]: https://pub.dev/packages/built_value
[file_chooser]: https://github.com/google/flutter-desktop-embedding/tree/master/plugins/file_chooser
[flutter_channels]: https://github.com/flutter/flutter/blob/master/docs/releases/Flutter-build-release-channels.md
[http]: https://pub.dev/packages/http
[macOS-client]: https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_network_client
[macOS-read-write]: https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_files_user-selected_read-write
[macOS-security]: https://github.com/google/flutter-desktop-embedding/blob/master/macOS-Security.md
[menubar]: https://github.com/google/flutter-desktop-embedding/tree/master/plugins/menubar
[setup documentation]: https://flutter.dev/desktop#set-up
[url_launcher]: https://pub.dev/packages/url_launcher
[MSIX pub package]: https://pub.dev/packages/msix
[Microsoft Store]: https://www.microsoft.com/en-au/p/flutter-desktop-photo-search/9nh719dxcpj4
[ms_store_publishing_doc]: https://docs.microsoft.com/en-us/windows/uwp/publish/