Skip to content

Commit 864e545

Browse files
chore: bump Flutter to 3.47.7 and render desktop with Impeller (#6916)
* Raise the macOS deployment target to 12.0 for Xcode 27 Xcode 27 fails builds whose macOS deployment target is below 12.0. The template and client pinned 11.0, and Flutter 3.44.8 generates the FlutterMacOS pod at 10.15. Raise the Podfile platform and the Xcode project to 12.0, and let pods below 12.0 inherit the platform, as Flutter 3.47's podhelper does. * Raise the iOS deployment target to 15.0 for Xcode 27 Xcode 27 fails builds whose iOS deployment target is below 15.0. The template and client pinned 13.0, and Flutter 3.44.8 generates the Flutter pod at 13.0. Raise the Podfile platform and the Xcode project to 15.0, let pods below 15.0 inherit the platform, and drop the stale MinimumOSVersion that Flutter strips from AppFrameworkInfo.plist anyway. * Add changelog entry for the Xcode 27 deployment targets * Document the macOS 12 and iOS 15 minimums for built apps Raising the deployment targets is a breaking change under the compatibility policy, so add a 1.0.4 breaking-change guide and register it in the index, the sidebar and the release notes. The release notes also gain the missing 1.0.1-1.0.3 entries. The macOS and iOS publish pages now state the minimum OS version, and the changelog entry links the guide. * Ship the macOS 12 / iOS 15 minimums in Flet 1.1.0 Raising the minimum macOS and iOS versions drops support for macOS 11 and iOS 13-14, so it ships in the 1.1.0 minor release instead of the 1.0.4 patch, together with the Flutter 3.47 bump, whose engine requires the same minimums. Move the changelog entry to 1.1.0 and the breaking-change guide from v1-0-4 to v1-1-0, and update the breaking-changes index, the sidebar and the release notes. Flet 1.0.4 becomes the last release for macOS 11 and iOS 13-14. * Exclude build and platform directories from Dart analysis Flutter 3.47 adds a migration that runs on every `flutter pub get`, `flutter test` and build. It inserts an `analyzer.exclude` block into the `analysis_options.yaml` of any package that depends on Flutter. On CI, `flutter test` in packages/flet would then leave a modified checked-in file, and `dart pub publish --dry-run` fails with exit code 65. Every release job depends on that step. Add the same block the migration writes, placed after `include:` the way Flutter's own app template does it: `build/**` for packages/flet, flet_integration_test and the extension packages, plus the six platform directories for the client and the `flet build` template. The migration only checks that each pattern is present, so it leaves these files alone afterwards. The excludes are valid on older SDKs too. * Bump Flutter to 3.47.5 Flutter 3.47 replaces several exact SDK package pins with caret ranges. The client lock picks up the versions they now require: intl 0.20.3, matcher 0.12.20, meta 1.19.0, test_api 0.7.12 and vector_math 2.4.3. * Drop the Podfile deployment-target clamps that Flutter now applies On Flutter 3.47, flutter_additional_ios_build_settings and flutter_additional_macos_build_settings delete IPHONEOS_DEPLOYMENT_TARGET below 15 and MACOSX_DEPLOYMENT_TARGET below 12 from every pod, whether or not it depends on Flutter, so each pod inherits the Pods project value. The post_install clamps added for Xcode 27 on 3.44.8 now repeat that work and can go. Verified on Xcode 27 with clean client builds (macos --debug, ios --simulator --debug): every Pods target ends up at 12.0 / 15.0 and both builds succeed without FLUTTER_XCODE_* overrides. client/ios/Podfile.lock picks up the new Podfile checksum and the Flutter pod checksum, which changes because 3.47's generated Flutter podspec declares iOS 15.0. * Keep desktop apps on the Skia renderer Flutter 3.47 makes Impeller the default renderer on macOS, Windows and Linux. The Flet desktop client already opts out on macOS (FLTEnableImpeller=false, after blank windows on Intel Macs in #3557), but apps built with `flet build` and the Windows and Linux clients would switch to Impeller with the SDK bump. Upstream still has open Impeller issues on these platforms (flutter#185394 crash on foreground on macOS, flutter#191538 flicker on Intel Macs, flutter#191353 slower on Windows, flutter#192915 flicker in Linux VMs), and Impeller hasn't been tested with Flet on real Windows/Linux hardware. Keep every desktop lane on Skia, as on Flutter 3.44: - Windows client and template runner: set_impeller_switch(Disabled). - Linux client and template runner: fl_dart_project_set_enable_impeller. - macOS apps: flet-cli adds FLTEnableImpeller=false to the Info.plist defaults, so `[tool.flet.macos.info]` or `--info-plist FLTEnableImpeller=true` still switches a built app to Impeller. FLUTTER_ENGINE_SWITCHES=--enable-impeller still enables Impeller in debug builds. Release builds ignore that variable. * Update Semantics and accessibility docs for Flutter 3.47 On iOS, Flutter 3.47 sets VoiceOver's header trait from the heading level, not from the header flag (flutter#186916). Android already did this, so both mobile screen readers now announce a heading only when `heading_level` is set. Describe that on `Semantics.heading_level` and `Semantics.header`. Flutter 3.47 also reports `high_contrast` on Android API 34+, not only on iOS (flutter#182263). * Use super parameters in CustomFilteringTextInputFormatter The Dart 3.13 linter reports use_super_parameters for this constructor. It was the only new analyzer diagnostic in packages/flet on Flutter 3.47.5. The behavior is unchanged: replacementString keeps the super constructor's '' default. * Move Android builds to Gradle 9.3.1, AGP 8.13.2 and Kotlin 2.3.21 Flutter 3.47.5 raised its Android dependency floors: Gradle 8.14, AGP 8.11.1 and KGP 2.2.20, the versions both Android lanes pin, are now the lowest it accepts, and each build printed three "support will soon be dropped" warnings. The next Flutter release will likely reject them. Move the client and the `flet build` template to the newest combination that is supported end to end without AGP 9: - Gradle wrapper 9.3.1, Flutter's template default. - KGP 2.3.21. KGP 2.2.x is documented only up to Gradle 8.14, and Kotlin 2.4 class files need R8 9.1.29 or later. - AGP 8.13.2, the last 8.x release. Its bundled R8 8.13.19 is the minimum Google lists for Kotlin 2.3. With AGP 8.11.1 (R8 8.11.18) and Kotlin 2.4, R8 couldn't parse Kotlin metadata and printed a warning per class whenever kotlin.Metadata was kept. Flutter 3.47.5's AGP/Gradle and AGP/KGP compatibility checks accept this combination. AGP 9 isn't usable yet: file_picker 11 and device_info_plus 12.4 fail to build with either android.builtInKotlin setting. Only the AGP warning remains. Gradle 9.1+ also runs on JDK 25, which crashed Gradle 8.14 with "IllegalArgumentException: 25.0.2". Verified: client `flutter build apk --debug` and `--release` (R8 8.13.19, no Kotlin metadata warnings), and `./gradlew assembleDebug` on JDK 25. * Add changelog entries for the Flutter 3.47.5 bump * Update the macOS 12 / iOS 15 guide for Flutter 3.47 On Flutter 3.47, a custom build template no longer needs the Podfile post_install step: Flutter's migrators raise the deployment targets of the generated project during the build, and podhelper.rb drops lower targets from every pod. Custom templates keep building on Xcode 27, and the Podfile `platform` and project.pbxproj changes only remove that migration step. Staying on macOS 11 or iOS 13-14 needs Flet 1.0.4 or earlier, because the Flutter 3.47 engine itself requires macOS 12 and iOS 15. * Fix the FilePicker docs heading structure The "Picking files with a client action" section sat between the Usage intro and its "Uploading files" and "Upload storage" subsections, so both rendered as children of the client-action section. Move it to just before Examples, where the Clipboard, Share and UrlLauncher pages put theirs. The "Pick and upload files" and "Pick text content" examples kept hand-written headings and intros, which duplicated the headings the remark plugin injects from each example's metadata, and the intros rendered above the injected heading. Move the intros into `docs_intro` and drop the hand-written headings. * Default the Canvas QuadraticTo weight to 1 on the Dart side `Path.QuadraticTo` defaults `w` to 1 in Python, and the serializer omits a field that equals its default, so a plain quadratic curve reaches the client without `w`. The Dart side fell back to a weight of 0. A conic with weight 0 is a straight line between its end points. Flutter 3.44 measured and dashed such conics as curves anyway, but Flutter 3.47 handles them correctly, so dashed paths built from `QuadraticTo` lost their curves (`test_draw_dashed_path_with_fill` dropped to 87.9% similarity). Fall back to 1, the same default as Python. * Turn off Kotlin incremental compilation for Android builds Kotlin Gradle plugin 2.3 compiles through the Build Tools API by default (`kotlin.compiler.runViaBuildToolsApi` defaults to true; it was false in 2.2.20). Its incremental cache stores every source path relative to the Android project. On Windows, when the pub cache and the app sit on different drives (C: and D: on GitHub's Windows runners), there is no relative path. Compiling a plugin such as battery_plus then fails with "Could not close incremental caches ... this and base files have different roots", which broke every apk-windows and aab-windows job. Set `kotlin.incremental=false` in the client and in flet-cli's default gradle.properties for generated projects. The plugin modules are small and Gradle still skips unchanged ones, so builds barely slow down. `[tool.flet.android.gradle_properties]` can turn it back on. * Fix pricing primary button text contrast (#6929) * Render desktop apps with Impeller and add a --no-impeller opt-out Desktop apps and the flet run client now use Flutter 3.47's default renderer, Impeller. The client and template runners switch to Skia when FLET_NO_IMPELLER is true at startup; release engines ignore Flutter's own engine-switch variables, and on macOS the runner replaces the private FlutterDartProject.enableImpeller getter only when asked. flet run --no-impeller (or impeller = false in pyproject) sets the variable for the client it opens. flet build/debug/test get --impeller/--no-impeller with [tool.flet(.<platform>)].impeller: the template runners bake it in on Windows and Linux, macOS gets FLTEnableImpeller=false and Android the EnableImpeller=false meta-data. Integration tests keep rendering with Skia until the goldens are regenerated. * Document the Impeller default and the --no-impeller opt-out * Bump Flutter to 3.47.6 3.47.6 fixes Windows release apps hanging while waiting on a timer (flutter/flutter#192513) and moves to Dart 3.13.5. The client lock and the generated icon lists don't change. * Link Impeller and Skia from the Renderer docs * Exclude build output from Dart analysis in flet_shadcn_ui Flutter 3.47's AnalysisOptionsMigration writes this block on every pub get, as for the other extensions in this branch. * Keep shadcn text field context menus working on Flutter 3.47 Flutter 3.47 shows a text field's context menu in the root overlay without the themes between the field and the Navigator. flet_shadcn_ui provides its ShadTheme only around each control, so right-clicking or long-pressing an Input, Textarea, InputOTP or TimePicker threw "ShadTheme.of() called with a context that does not contain a ShadTheme" and covered the window with an error box. Input and Textarea build shadcn_ui's menu inside the field's ShadTheme. InputOTP and TimePicker take no contextMenuBuilder, so their native menu is turned off. * Keep flet-1.1.0's shadcn_ui dependency versions in the client lock Regenerating the lock after the merge had moved flutter_shaders and theme_extensions_builder_annotation, which Flutter 3.47 doesn't require. * Bump Flutter SDK pin to 3.47.7 * Update Flutter version references to 3.47.7 --------- Co-authored-by: Feodor Fitsner <[email protected]>
1 parent 1eceaa3 commit 864e545

70 files changed

Lines changed: 533 additions & 161 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.fvmrc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
"flutter": "3.44.8"
2+
"flutter": "3.47.7"
33
}

‎CHANGELOG.md‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,10 @@
1111

1212
### Improvements
1313

14+
* Bump the bundled Flutter to [3.47.7](https://github.com/flutter/flutter/blob/stable/CHANGELOG.md#3477) (from 3.44.8). Android builds use Gradle 9.3.1, Android Gradle Plugin 8.13.2 and Kotlin 2.3.21 by @ndonkoHenri.
15+
16+
**Compatibility:** Desktop apps and the desktop app that `flet run` opens now render with Impeller, Flutter 3.47's default desktop renderer, instead of Skia. Use `flet build --no-impeller` (or `impeller = false` under `[tool.flet]`), `flet run --no-impeller` or the `FLET_NO_IMPELLER` environment variable to render with Skia; see [Renderer](/docs/publish#renderer). Android plugins that still use `jcenter()` or other APIs removed in Gradle 9 no longer build. `flet build` downloads Flutter 3.47.7 on first use.
17+
1418
* Add `Theme.surfaces` and the `ThemeSurfaces` enum (`NEUTRAL`, `TONAL`) to choose whether surface colors are neutral or tinted with the seed color ([#6921](https://github.com/flet-dev/flet/issues/6921)) by @FeodorFitsner.
1519
* Add `flet test --update-failed-goldens` (`FLET_TEST_GOLDEN=failed`): compares screenshots as usual and overwrites only golden images that are missing or no longer match, so unchanged goldens stay untouched ([#6921](https://github.com/flet-dev/flet/issues/6921)) by @FeodorFitsner.
1620
* Add `bgcolor` to `FletTestApp.take_page_controls_screenshot()`, `assert_control_screenshot()` and `wrap_page_controls_in_screenshot()` to paint an opaque background behind the captured controls instead of a transparent one ([#6918](https://github.com/flet-dev/flet/pull/6918)) by @InesaFitsner.
@@ -19,7 +23,7 @@
1923

2024
* Fix `flet build`, `flet debug` and `flet test` failing for macOS and iOS on Xcode 27, which rejects deployment targets below macOS 12 and iOS 15 ([#6874](https://github.com/flet-dev/flet/issues/6874)) by @ndonkoHenri.
2125

22-
**Compatibility:** Apps built with `flet build` and the macOS desktop client now require macOS 12 or later, and iOS apps require iOS 15 or later. Custom build templates need the same `Podfile` and Xcode project changes to build on Xcode 27. See the [macOS 12 and iOS 15 minimum](/docs/updates/breaking-changes/v1-1-0/minimum-macos-12-ios-15) guide.
26+
**Compatibility:** Apps built with `flet build` and the macOS desktop client now require macOS 12 or later, and iOS apps require iOS 15 or later. Custom build templates keep building, because Flutter 3.47 raises the deployment targets during the build; apply the same `Podfile` and Xcode project changes to skip that step. See the [macOS 12 and iOS 15 minimum](/docs/updates/breaking-changes/v1-1-0/minimum-macos-12-ios-15) guide.
2327

2428
### Documentation
2529

‎client/analysis_options.yaml‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,16 @@
99
# packages, and plugins designed to encourage good coding practices.
1010
include: package:flutter_lints/flutter.yaml
1111

12+
analyzer:
13+
exclude:
14+
- build/**
15+
- android/**
16+
- ios/**
17+
- web/**
18+
- windows/**
19+
- macos/**
20+
- linux/**
21+
1222
linter:
1323
# The lint rules applied to this project can be customized in the
1424
# section below to disable rules from the `package:flutter_lints/flutter.yaml`

‎client/android/gradle.properties‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,4 @@ android.useAndroidX=true
33
android.enableJetifier=true
44
android.builtInKotlin=true
55
android.newDsl=true
6+
kotlin.incremental=false

‎client/android/gradle/wrapper/gradle-wrapper.properties‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@ distributionBase=GRADLE_USER_HOME
22
distributionPath=wrapper/dists
33
zipStoreBase=GRADLE_USER_HOME
44
zipStorePath=wrapper/dists
5-
distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-all.zip
5+
distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-all.zip

‎client/android/settings.gradle.kts‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ pluginManagement {
1818

1919
plugins {
2020
id("dev.flutter.flutter-plugin-loader") version "1.0.0"
21-
id("com.android.application") version "8.11.1" apply false
21+
id("com.android.application") version "8.13.2" apply false
2222
// Plugin applies kotlin-android for us (Built-in Kotlin) — uses this KGP version.
23-
id("org.jetbrains.kotlin.android") version "2.2.20" apply false
23+
id("org.jetbrains.kotlin.android") version "2.3.21" apply false
2424
}
2525

2626
include(":app")

‎client/ios/Podfile‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,6 @@ end
3737
post_install do |installer|
3838
installer.pods_project.targets.each do |target|
3939
flutter_additional_ios_build_settings(target)
40-
# Pods targeting iOS older than 15.0 (e.g. Flutter at 13.0) inherit the platform
41-
# of the project instead, because Xcode 27 rejects deployment targets below 15.0.
42-
if target.deployment_target.to_s[/\d+/].to_i < 15
43-
target.build_configurations.each do |config|
44-
config.build_settings.delete('IPHONEOS_DEPLOYMENT_TARGET')
45-
end
46-
end
4740

4841
target.build_configurations.each do |config|
4942
# You can remove unused permissions here

‎client/ios/Podfile.lock‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,10 @@ EXTERNAL SOURCES:
1919
:path: ".symlinks/plugins/media_kit_video/ios"
2020

2121
SPEC CHECKSUMS:
22-
Flutter: cabc95a1d2626b1b06e7179b784ebcf0c0cde467
22+
Flutter: 71a624a5bc0c04062bf19101d501e466baf2fb47
2323
media_kit_libs_ios_video: 5a18affdb97d1f5d466dc79988b13eff6c5e2854
2424
media_kit_video: 1746e198cb697d1ffb734b1d05ec429d1fcd1474
2525

26-
PODFILE CHECKSUM: 4b18c31af6d6aafa5a8fdba6006c7c36242190b1
26+
PODFILE CHECKSUM: 1553ec89ac4decbfc4e0d104faad488c0393f4dc
2727

2828
COCOAPODS: 1.14.3

‎client/linux/my_application.cc‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,20 @@ struct _MyApplication {
1414

1515
G_DEFINE_TYPE(MyApplication, my_application, GTK_TYPE_APPLICATION)
1616

17+
// Returns TRUE when the app should render with Skia instead of Flutter's
18+
// default, Impeller: FLET_NO_IMPELLER is "1", "true" or "yes" (any case), or
19+
// FLUTTER_LINUX_RENDERER picks the software renderer, which can't draw
20+
// Impeller's text.
21+
static gboolean no_impeller_requested() {
22+
const gchar* no_impeller = g_getenv("FLET_NO_IMPELLER");
23+
if (no_impeller != nullptr && (g_strcmp0(no_impeller, "1") == 0 ||
24+
g_ascii_strcasecmp(no_impeller, "true") == 0 ||
25+
g_ascii_strcasecmp(no_impeller, "yes") == 0)) {
26+
return TRUE;
27+
}
28+
return g_strcmp0(g_getenv("FLUTTER_LINUX_RENDERER"), "software") == 0;
29+
}
30+
1731
// Implements GApplication::activate.
1832
static void my_application_activate(GApplication* application) {
1933
MyApplication* self = MY_APPLICATION(application);
@@ -100,6 +114,10 @@ static void my_application_activate(GApplication* application) {
100114

101115
g_autoptr(FlDartProject) project = fl_dart_project_new();
102116
fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments);
117+
// `flet run --no-impeller` sets FLET_NO_IMPELLER.
118+
if (no_impeller_requested()) {
119+
fl_dart_project_set_enable_impeller(project, FALSE);
120+
}
103121

104122
FlView* view = fl_view_new(project);
105123
gtk_widget_show(GTK_WIDGET(view));

‎client/macos/Podfile‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,6 @@ end
3636
post_install do |installer|
3737
installer.pods_project.targets.each do |target|
3838
flutter_additional_macos_build_settings(target)
39-
# Pods targeting macOS older than 12.0 (e.g. FlutterMacOS at 10.15) inherit the
40-
# platform above instead, because Xcode 27 rejects deployment targets below 12.0.
41-
if target.deployment_target.to_s[/\d+/].to_i < 12
42-
target.build_configurations.each do |config|
43-
config.build_settings.delete('MACOSX_DEPLOYMENT_TARGET')
44-
end
45-
end
4639

4740
# Ensure rive_native's setup script runs from the project root so pubspec.yaml is found in CI.
4841
next unless target.name == 'rive_native'

0 commit comments

Comments
 (0)