Skip to content

Updates impeller page to mention desktop compatibility. - #13635

Draft
gaaclarke wants to merge 1 commit into
flutter:mainfrom
gaaclarke:desktop-impeller
Draft

Updates impeller page to mention desktop compatibility.#13635
gaaclarke wants to merge 1 commit into
flutter:mainfrom
gaaclarke:desktop-impeller

Conversation

@gaaclarke

Copy link
Copy Markdown
Member

Do not land until 3.47 ships

Description of what this PR is changing or adding, and why:

This updates the impeller guidance to cover desktop compatibility.

Issues fixed by this PR (if any):

fixes flutter/flutter#190159

PRs or commits this PR depends on (if any):

Presubmit checklist

  • If you are unwilling, or unable, to sign the CLA, even for a tiny, one-word PR, please file an issue instead of a PR.
  • If this PR is not meant to land until a future stable release, mark it as draft with an explanation.
  • This PR follows the Google Developer Documentation Style Guidelines—for example, it doesn't use i.e. or e.g., and it avoids I and we (first-person pronouns).
  • This PR uses semantic line breaks
    of 80 characters or fewer.

@gaaclarke
gaaclarke requested a review from loic-sharma July 28, 2026 20:46
@flutter-website-bot

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit 1cc6f91):

https://flutter-docs-prod--docs-pr13635-desktop-impeller-9zql91kq.web.app

@flutter-website-bot

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit 1cc6f91):

https://flutter-dev-230821--www-pr13635-desktop-impeller-a3rfzx9l.web.app

@loic-sharma loic-sharma left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@parlough parlough left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for these updates @gaaclarke! Generally looks good to me, but can you add some additional context to the opt out instructions?

Comment on lines +91 to +92
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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Opt out" doesn't need a hyphen when it's used as a verb:

Suggested change
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.

Comment on lines +111 to +112
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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Comment on lines +130 to +131
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.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Comment on lines +121 to +126
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);
```

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you add extra context on where in the file? Either by explaining it with prose or adding some of the surrounding code to the code block.

@loic-sharma loic-sharma Jul 31, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe:

  g_autoptr(FlDartProject) project = fl_dart_project_new();
  fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments);
+ fl_dart_project_set_enable_impeller(project, FALSE);

Comment on lines +140 to 145
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);
```

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you add extra context on where in the file? Either by explaining it with prose or adding some of the surrounding code to the code block.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe:

  flutter::DartProject project(L"data");

  std::vector<std::string> command_line_arguments =
      GetCommandLineArguments();

  project.set_dart_entrypoint_arguments(std::move(command_line_arguments));
+ project.set_impeller_switch(flutter::ImpellerSwitch::Disabled);

To disable Impeller on Windows when deploying your app, add the following setup to
your project in `windows\runner\main.cpp`.

```c++

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
```c++
```cpp

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update impeller page for desktop information

4 participants