flutter/examples/README.md

56 lines
2.3 KiB
Markdown
Raw Normal View History

Flutter Examples
================
This directory contains several examples of using Flutter. Each of these is an
individual Dart application package.
To run an example, use `flutter run` inside that example's directory. See the
2016-01-15 21:08:27 +00:00
[getting started guide](https://flutter.io/getting-started/) to install
the `flutter` tool.
**Tip:** To see examples of how to use a specific Flutter framework class,
copy and paste a URL with this format in your browser. Replace `foo` with the
classname you are searching for (for example, here's the
[query](https://github.com/flutter/flutter/search?q=path%3Aexamples+new+AppBar)
for examples of the
[`AppBar`](https://docs.flutter.io/flutter/material/AppBar-class.html) class).
```
2016-09-30 20:57:39 +00:00
https://github.com/flutter/flutter/search?q=path%3Aexamples+new+foo
```
Available examples include:
- **Hello, world** The [hello world app](hello_world) is a basic app that shows
the text "hello, world."
2016-05-09 18:00:54 +00:00
- **Flutter gallery** The [flutter gallery app](flutter_gallery) showcases
Flutter's widgets, including its implementation of
[material design](https://material.google.com/).
- **Platform Channel** The [platform channel app](platform_channel)
demonstrates how to connect a Flutter app to platform-specific APIs. For
documentation, see <https://flutter.io/platform-channels/>.
2017-05-29 04:44:38 +00:00
- **Platform Channel Swift** The [platform channel swift app](platform_channel_swift)
2017-05-09 19:29:28 +00:00
is the same as [platform channel](platform_channel) but the iOS version is in
Swift and there is no Android version.
- **Flutter View** The [flutter view app](flutter_view) demonstrates how to
embed Flutter within an iOS or Android app.
- **Layers** The [layers vignettes](layers) show how to use the various layers
2017-05-29 04:44:38 +00:00
in the Flutter framework. For details, see the [layers README](layers/README.md).
- **Stocks** The [stocks](stocks) demo shows how one might structure
an application with several screens.
Note on Gradle wrapper files in `.gitignore`:
Gradle wrapper files should normally be checked into source control.
The example projects don't do that to avoid having several copies of the
wrapper binary in the Flutter repo. Instead, the Gradle wrapper is
injected by Flutter tooling, and the wrapper files are .gitignore'd to
avoid making the Flutter repository dirty as a side effect of running
the examples.