diff --git a/sites/docs/src/content/perf/impeller.md b/sites/docs/src/content/perf/impeller.md index 5393e15b33..7132a96055 100644 --- a/sites/docs/src/content/perf/impeller.md +++ b/sites/docs/src/content/perf/impeller.md @@ -88,24 +88,63 @@ 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 as of 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 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: + +```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 +g_autoptr(FlDartProject) project = fl_dart_project_new(); +fl_dart_project_set_enable_impeller(project, FALSE); +``` + +### Windows + +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. + +```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`: + +```cpp +flutter::DartProject project(L"data"); +project.set_impeller_switch(flutter::ImpellerSwitch::Disabled); ``` ### Bugs and issues