Starter/samples
1
0
Fork 0
mirror of https://github.com/flutter/samples.git synced 2026-04-14 02:51:15 +00:00
Code Issues Releases Wiki Activity

Migrate desktop_photo_search to top level (#1002)

Browse Source
This commit is contained in:
Brett Morgan
2022-02-04 08:33:53 +10:00
committed by GitHub
parent 93bf3263c5
commit 9c02a0fa09
208 changed files with 9408 additions and 535 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
desktop_photo_search/material/README.md Normal file
View File

@@ -0,0 +1,64 @@
# 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/wiki/Flutter-build-release-channels
[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/