Flutter Version Management
When Shorebird CLI is installed, it pulls down the latest stable version of Shorebird’s Flutter. In this section, we’ll take a look at how to list and change the Flutter version used by Shorebird CLI.
Shorebird supports creating a release with older versions of Flutter (back to 3.10.0 for Android or 3.22.3 for iOS), a release created with one of these versions may not contain all of the most recent Shorebird features. Because of this, we recommend using the latest stable version of Flutter whenever possible.
To list all Flutter versions Shorebird has published, use the
shorebird flutter versions list
command:
$ shorebird flutter versions list📦 Flutter Versions✓ 3.22.3 3.22.2 3.22.1 3.22.0 3.19.6 3.19.5 3.19.4 3.19.3 3.19.2 3.19.1 3.19.0-0.4.pre 3.19.0 3.16.9 3.16.7 3.16.5 3.16.4 3.16.3 3.13.9 3.13.8 3.13.7 3.13.6 3.13.5 3.13.4 3.13.3 3.13.2 3.13.1 3.13.0 3.10.6 3.10.5 3.10.4 3.10.3 3.10.2 3.10.1 3.10.0
By default, Shorebird will use the latest stable version of Flutter. If you need
to create a release with a different version of Flutter, you can use the
--flutter-version
option with the shorebird release
command:
shorebird release android --flutter-version=3.10.6
Any patches created with this release will be built with the version of Flutter used by the release.
At this time, not all functionality is supported for each Flutter version.
Android requires Flutter 3.10.0 or later.
package:shorebird_code_push
requires Flutter 3.10.6 or later.
iOS requires Flutter 3.22.3 or later.
June, 11, 2024: Disabled releasing and patching for iOS 3.19.5 - 3.22.1 due to a bug where “try/catch” clauses would not always run the “catch” block after an exception was thrown. This bug only affected iOS apps after patching.
April 8, 2024: Disabled releasing for iOS 3.10.6 - 3.19.4 due to various crashers found in previous iOS releases. Patching continues to be supported.