blob: 361f2c4314a103bab6a25637cc462da7fc0f620e [file] [log] [blame] [view]
Adam Bartha74d02d2015-09-26 12:37:27 -07001Flutter Examples
2================
Collin Jackson633b6502015-07-16 11:54:25 -07003
Michael Thomsen2c063b72018-10-08 08:45:24 +02004This directory contains several examples of using Flutter. To run an example,
5use `flutter run` inside that example's directory. See the [getting started
Tim Sneath52918972019-04-05 11:39:30 -07006guide](https://flutter.dev/getting-started/) to install the `flutter` tool.
Collin Jackson633b6502015-07-16 11:54:25 -07007
Michael Thomsen2c063b72018-10-08 08:45:24 +02008For additional samples, see the
9[`flutter/samples`](https://github.com/flutter/samples) repo.
qchong517ddab2016-09-27 14:39:15 -070010
Jim Beveridge93fa4462015-10-13 13:53:05 -070011Available examples include:
12
Michael Thomsen2c063b72018-10-08 08:45:24 +020013- **Hello, world** The [hello world app](hello_world) is a minimal Flutter app
14 that shows the text "hello, world."
Collin Jackson633b6502015-07-16 11:54:25 -070015
Hans Muller74c3e742016-05-09 11:00:54 -070016- **Flutter gallery** The [flutter gallery app](flutter_gallery) showcases
Michael Thomsen2c063b72018-10-08 08:45:24 +020017 Flutter's widgets, including its implementation of [material
MhdHejaziaf3cdb32019-02-01 21:14:48 +030018 design](https://material.io/design/).
Sarah Zakarias3c992722017-03-24 11:51:54 +010019
Adam Barth140bf642016-04-20 10:58:06 -070020- **Layers** The [layers vignettes](layers) show how to use the various layers
Michael Thomsen2c063b72018-10-08 08:45:24 +020021 in the Flutter framework. For details, see the [layers
22 README](layers/README.md).
Ian Hicksona52c7b42017-04-05 11:28:33 -070023
Michael Thomsen2c063b72018-10-08 08:45:24 +020024- **Platform Channel** The [platform channel app](platform_channel) demonstrates
25 how to connect a Flutter app to platform-specific APIs. For documentation, see
Tim Sneath52918972019-04-05 11:39:30 -070026 <https://flutter.dev/platform-channels/>.
Michael Thomsen2c063b72018-10-08 08:45:24 +020027
28- **Platform Channel Swift** The [platform channel swift
29 app](platform_channel_swift) is the same as [platform
30 channel](platform_channel) but the iOS version is in Swift and there is no
31 Android version.
32
33## Notes
Mikkel Nygaard Ravn1731a162017-06-29 09:48:01 +020034
35Note on Gradle wrapper files in `.gitignore`:
36
Michael Thomsen2c063b72018-10-08 08:45:24 +020037Gradle wrapper files should normally be checked into source control. The example
38projects don't do that to avoid having several copies of the wrapper binary in
39the Flutter repo. Instead, the Gradle wrapper is injected by Flutter tooling,
40and the wrapper files are .gitignore'd to avoid making the Flutter repository
41dirty as a side effect of running the examples.