THIS IS A BREAKING CHANGE. See below for migration steps for existing projects.

Previously, Flutter app code was built as a raw dylib on iOS. Dynamic libraries outside of a framework bundle are not supported on iOS, except for the system Swift libraries provided by Xcode.

See:
https://developer.apple.com/library/content/technotes/tn2435/_index.html#//apple_ref/doc/uid/DTS40017543-CH1-TROUBLESHOOTING_BUNDLE_ERRORS-EMBEDDED__DYLIB_FILES

• Migrates Xcode build from app.dylib to App.framework
• Migrates flutter create template
• Migrates example projects

Migration steps for existing projects

The following steps should be taken from the root of your Flutter project:

1. Edit ios/.gitignore: add /Flutter/App.framework on a new line.
2. In the Xcode project navigator, remove app.dylib from the Flutter folder. Delete this file from the ios/Flutter directory in your project.
3. Run a build to generate ios/Flutter/App.framework. From the command line, run flutter build ios. If you have not configured app signing in Xcode, an alternative method is to open the simulator, then run flutter run -d iP.
4. In the Xcode project navigator, select the Runner project. In the project settings that are displayed in the main view, ensure that the Runner target is selected. You can verify this by exposing the sidebar using the [| ] icon in the upper-left corner of the main view.
5. Select the General tab in the project settings. Under the Embedded Binaries section, click '+' to add App.framework. In the sheet that drops down, click the Add Other... button. Navigate to the ios/Flutter directory and select App.framework. Click Open. In the sheet that drops down, select Create folder references, then click Finish.
6. In the project settings, verify that App.framework has been added to the Embedded Binaries and Linked Frameworks and Libraries lists.
7. In the Xcode project navigator, drag App.framework under the Flutter folder.
8. Download a copy of AppFrameworkInfo.plist and save it to the ios/Flutter directory of your project.
9. In the Xcode project navigator, select Flutter then from the File menu, select Add Files to "Runner".... Navigate to the ios/Flutter directory, select AppFrameworkInfo.plist and click
   the Add button.
10. From the command line, in your project directory, run flutter build clean, then flutter run.

The final state of your project should appear as follows:

At this point your project should be fully migrated.