History

Seth Ladd 4a3cc9d4f9 explicitly say how to launch the app for iOS (#2401 ) Replace this paragraph with a description of what this PR is changing or adding, and why. Consider including before/after screenshots. List which issues are fixed by this PR. For larger changes, raising an issue first helps reduce redundant work. ## Pre-launch Checklist - [x] I read the [Flutter Style Guide] _recently_, and have followed its advice. - [x] I signed the [CLA]. - [x] I read the [Contributors Guide]. - [ ] I updated/added relevant documentation (doc comments with `///`). - [ ] All existing and new tests are passing. If you need help, consider asking for advice on the #hackers-devrel channel on [Discord]. <!-- Links --> [Flutter Style Guide]: https://github.com/flutter/flutter/blob/master/docs/contributing/Style-guide-for-Flutter-repo.md [CLA]: https://cla.developers.google.com/ [Discord]: https://github.com/flutter/flutter/blob/master/docs/contributing/Chat.md [Contributors Guide]: https://github.com/flutter/samples/blob/main/CONTRIBUTING.md		4 months ago
..
android_view	Update add to app android_view to api 35 (#2368 )	5 months ago
books	Bump pigeon from 21.2.0 to 22.0.0 in /add_to_app/books/flutter_module_books (#2392 )	4 months ago
fullscreen	explicitly say how to launch the app for iOS (#2401 )	4 months ago
multiple_flutters	Update add to app android_view to api 35 (#2368 )	5 months ago
plugin	Update add to app code to run on modern versions of agp and gradle. (#2330 )	6 months ago
prebuilt_module	Bump espresso from 0.3.0+10 to 0.4.0 in /add_to_app/prebuilt_module/flutter_module (#2350 )	5 months ago
README.md	remove outdated links at bottom of README (#2400 )	4 months ago

README.md

Add-to-App Samples

This directory contains Android and iOS projects that import and use a Flutter module. They're designed to show recommended approaches for adding Flutter to existing Android and iOS apps.

Samples Listing

fullscreen — Embeds a full screen instance of Flutter into an existing iOS or Android app.
prebuilt_module — Embeds a full screen instance of Flutter as a prebuilt library that can be loaded into an existing iOS or Android app.
plugin — Embeds a full screen Flutter instance that is using plugins into an existing iOS or Android app.
books — Mimics a real world use-case of embedding Flutter into an existing Android app and demonstrates using Pigeon to communicate between Flutter and the host application.
multiple_flutters — Shows the usage of the Flutter Engine Group APIs to embed multiple instances of Flutter into an existing app with low memory cost.
android_view — Shows how to integrate a Flutter add-to-app module at a view level for Android.

Goals for these samples

Show developers how to add Flutter to their existing applications.
Show the following options:
- Whether to build the Flutter module from source each time the app builds or rely on a separately pre-built module.
- Whether plugins are needed by the Flutter module used in the app.
Show Flutter being integrated ergonomically with applications with existing middleware and business logic data classes.

Installing Cocoapods

The iOS samples in this repo require the latest version of Cocoapods. To make sure you've got it, run the following command on a macOS machine:

sudo gem install cocoapods

See https://guides.cocoapods.org/using/getting-started.html for more details.

Debugging

You can flutter attach to the running host application to debug the Flutter module. This will allow you to hot reload, set breakpoints, and use DevTools and other debugging functionality, similar to a full Flutter app.

Issues

If you run into an issue with the sample itself, please file an issue in the main Flutter repo.