From 1cc6f912b71c1609668cc751d942896e4a366a33 Mon Sep 17 00:00:00 2001 From: Aaron Clarke Date: Tue, 28 Jul 2026 13:43:24 -0700 Subject: [PATCH 1/5] Updates impeller page to mention desktop compatibility. --- sites/docs/src/content/perf/impeller.md | 56 ++++++++++++++++++++----- 1 file changed, 46 insertions(+), 10 deletions(-) diff --git a/sites/docs/src/content/perf/impeller.md b/sites/docs/src/content/perf/impeller.md index 02edb1d53e..293014f4c3 100644 --- a/sites/docs/src/content/perf/impeller.md +++ b/sites/docs/src/content/perf/impeller.md @@ -88,24 +88,60 @@ It might use Impeller in the future. ### macOS -You can try out Impeller for macOS behind a flag. -In a future release, the ability to opt-out of -using Impeller will be removed. +Impeller is **available and enabled by default on Flutter 3.47**. In a future +release, the ability to opt-out of using Impeller will be removed. -To enable Impeller on macOS when debugging, -pass `--enable-impeller` to the `flutter run` command. +To disable Impeller on macOS when debugging, pass `--no-enable-impeller` to the +`flutter run` command. ```console -flutter run --enable-impeller +flutter run --no-enable-impeller ``` -To enable Impeller on macOS when deploying your app, -add the following tags under the top-level -`` tag in your app's `Info.plist` file. +To disable Impeller on macOS when deploying your app, add the following tags +under the top-level `` tag in your app's `Info.plist` file. ```xml FLTEnableImpeller - + +``` + +### Linux + +Impeller is **available and enabled by default on Flutter 3.47**. In a future +release, the ability to opt-out of using Impeller will be removed. + +To disable Impeller on Linux when debugging, pass `--no-enable-impeller` to the +`flutter run` command. + +```console +flutter run --no-enable-impeller +``` + +To disable Impeller on Linux when deploying your app, add the following setup to +your project in `linux/runner/my_application.cc`. + +```c +fl_dart_project_set_enable_impeller(project, FALSE); +``` + +### Windows + +Impeller is **available and enabled by default on Flutter 3.47**. In a future +release, the ability to opt-out of using Impeller will be removed. + +To disable Impeller on Windows when debugging, pass `--no-enable-impeller` to the +`flutter run` command. + +```console +flutter run --no-enable-impeller +``` + +To disable Impeller on Windows when deploying your app, add the following setup to +your project in `windows\runner\main.cpp`. + +```c++ +project.set_impeller_switch(flutter::ImpellerSwitch::Disabled); ``` ### Bugs and issues From 77880e9e8151a72995af8f03b3fa7d5010796783 Mon Sep 17 00:00:00 2001 From: gaaclarke <30870216+gaaclarke@users.noreply.github.com> Date: Thu, 6 Aug 2026 10:33:46 -0700 Subject: [PATCH 2/5] Apply suggestions from code review Co-authored-by: Parker Lougheed --- sites/docs/src/content/perf/impeller.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sites/docs/src/content/perf/impeller.md b/sites/docs/src/content/perf/impeller.md index 293014f4c3..dc0c3e02b1 100644 --- a/sites/docs/src/content/perf/impeller.md +++ b/sites/docs/src/content/perf/impeller.md @@ -88,8 +88,8 @@ It might use Impeller in the future. ### macOS -Impeller is **available and enabled by default on Flutter 3.47**. In a future -release, the ability to opt-out of using Impeller will be removed. +Impeller is **available and enabled by default as of Flutter 3.47**. +In a future release, the ability to opt out of using Impeller will be removed. To disable Impeller on macOS when debugging, pass `--no-enable-impeller` to the `flutter run` command. @@ -108,8 +108,8 @@ under the top-level `` tag in your app's `Info.plist` file. ### Linux -Impeller is **available and enabled by default on Flutter 3.47**. In a future -release, the ability to opt-out of using Impeller will be removed. +Impeller is **available and enabled by default as of Flutter 3.47**. +In a future release, the ability to opt out of using Impeller will be removed. To disable Impeller on Linux when debugging, pass `--no-enable-impeller` to the `flutter run` command. @@ -127,8 +127,8 @@ fl_dart_project_set_enable_impeller(project, FALSE); ### Windows -Impeller is **available and enabled by default on Flutter 3.47**. In a future -release, the ability to opt-out of using Impeller will be removed. +Impeller is **available and enabled by default as of Flutter 3.47**. +In a future release, the ability to opt out of using Impeller will be removed. To disable Impeller on Windows when debugging, pass `--no-enable-impeller` to the `flutter run` command. From 8fff6472d46cd2e11a3a93de239d3273bcacc112 Mon Sep 17 00:00:00 2001 From: Aaron Clarke Date: Thu, 6 Aug 2026 10:38:13 -0700 Subject: [PATCH 3/5] adds explicit type --- sites/docs/src/content/perf/impeller.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/sites/docs/src/content/perf/impeller.md b/sites/docs/src/content/perf/impeller.md index dc0c3e02b1..1828097312 100644 --- a/sites/docs/src/content/perf/impeller.md +++ b/sites/docs/src/content/perf/impeller.md @@ -122,6 +122,7 @@ To disable Impeller on Linux when deploying your app, add the following setup to your project in `linux/runner/my_application.cc`. ```c +g_autoptr(FlDartProject) project = fl_dart_project_new(); fl_dart_project_set_enable_impeller(project, FALSE); ``` @@ -141,6 +142,7 @@ To disable Impeller on Windows when deploying your app, add the following setup your project in `windows\runner\main.cpp`. ```c++ +flutter::DartProject project(L"data"); project.set_impeller_switch(flutter::ImpellerSwitch::Disabled); ``` From c837c5cd527e6299ddd82c88482797100918797d Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Wed, 12 Aug 2026 15:11:24 -0500 Subject: [PATCH 4/5] Adjust language of code snippet --- sites/docs/src/content/perf/impeller.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/perf/impeller.md b/sites/docs/src/content/perf/impeller.md index 1a48d91757..1ee9c8f0ef 100644 --- a/sites/docs/src/content/perf/impeller.md +++ b/sites/docs/src/content/perf/impeller.md @@ -141,7 +141,7 @@ flutter run --no-enable-impeller To disable Impeller on Windows when deploying your app, add the following setup to your project in `windows\runner\main.cpp`. -```c++ +```cpp flutter::DartProject project(L"data"); project.set_impeller_switch(flutter::ImpellerSwitch::Disabled); ``` From 40cdf72ce341341e90be28d37fb6d86384cf76fd Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Wed, 12 Aug 2026 15:24:12 -0500 Subject: [PATCH 5/5] Address Gemini review comments --- sites/docs/src/content/perf/impeller.md | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/sites/docs/src/content/perf/impeller.md b/sites/docs/src/content/perf/impeller.md index 1ee9c8f0ef..7132a96055 100644 --- a/sites/docs/src/content/perf/impeller.md +++ b/sites/docs/src/content/perf/impeller.md @@ -91,15 +91,16 @@ It might use Impeller in the future. Impeller is **available and enabled by default as of Flutter 3.47**. In a future release, the ability to opt out of using Impeller will be removed. -To disable Impeller on macOS when debugging, pass `--no-enable-impeller` to the -`flutter run` command. +To disable Impeller on macOS when debugging, +pass `--no-enable-impeller` to the `flutter run` command: ```console flutter run --no-enable-impeller ``` -To disable Impeller on macOS when deploying your app, add the following tags -under the top-level `` tag in your app's `Info.plist` file. +To disable Impeller on macOS when deploying your app, +add the following tags under the top-level `` tag in +your app's `Info.plist` file: ```xml FLTEnableImpeller @@ -111,15 +112,15 @@ under the top-level `` tag in your app's `Info.plist` file. Impeller is **available and enabled by default as of Flutter 3.47**. In a future release, the ability to opt out of using Impeller will be removed. -To disable Impeller on Linux when debugging, pass `--no-enable-impeller` to the -`flutter run` command. +To disable Impeller on Linux when debugging, +pass `--no-enable-impeller` to the `flutter run` command: ```console flutter run --no-enable-impeller ``` -To disable Impeller on Linux when deploying your app, add the following setup to -your project in `linux/runner/my_application.cc`. +To disable Impeller on Linux when deploying your app, +add the following setup to your project in `linux/runner/my_application.cc`: ```c g_autoptr(FlDartProject) project = fl_dart_project_new(); @@ -131,15 +132,15 @@ fl_dart_project_set_enable_impeller(project, FALSE); Impeller is **available and enabled by default as of Flutter 3.47**. In a future release, the ability to opt out of using Impeller will be removed. -To disable Impeller on Windows when debugging, pass `--no-enable-impeller` to the -`flutter run` command. +To disable Impeller on Windows when debugging, +pass `--no-enable-impeller` to the `flutter run` command. ```console flutter run --no-enable-impeller ``` -To disable Impeller on Windows when deploying your app, add the following setup to -your project in `windows\runner\main.cpp`. +To disable Impeller on Windows when deploying your app, +add the following setup to your project in `windows\runner\main.cpp`: ```cpp flutter::DartProject project(L"data");