Skip to content

[web][breaking] Change --web-renderer default from auto to canvaskit #149826

Closed
#149773
Closed
[web][breaking] Change --web-renderer default from auto to canvaskit#149826
#149773
Assignees
mdebbar
Labels
P1High-priority issues at the top of the work listc: API breakBackwards-incompatible API changese: web_canvaskitCanvasKit (a.k.a. Skia-on-WebGL) rendering backend for Webe: web_htmlHTML rendering backend for Webplatform-webWeb applications specificallyteam-webOwned by Web platform teamtoolAffects the "flutter" command-line tool. See also t: labels.triaged-webTriaged by Web platform team

Description

@mdebbar
mdebbar
opened on Jun 6, 2024

Summary

The --web-renderer CLI argument's default value is changing from auto to canvaskit.

Background

The CanvasKit renderer has come a long way since the early days of Flutter Web. Many bugs have been fixed, and the size has been reasonably decreased. We now consider the CanvasKit renderer mature enough to be the default renderer for Flutter Web.

Migration guide

We recommend using the canvaskit renderer, and that's why we are making it the default. But if you have a need for the auto renderer, then you need to explicitly pass it as a CLI argument (please give us feedback on why you need auto or html renderers here).

Command before migration:

flutter run -d chrome

Command after migration:

flutter run -d chrome --web-renderer=auto

Activity

  1. mdebbar
    added
    toolAffects the "flutter" command-line tool. See also t: labels.
    c: API breakBackwards-incompatible API changes
    platform-webWeb applications specifically
    e: web_htmlHTML rendering backend for Web
    e: web_canvaskitCanvasKit (a.k.a. Skia-on-WebGL) rendering backend for Web
    P1High-priority issues at the top of the work list
    team-webOwned by Web platform team
    triaged-webTriaged by Web platform team
    on Jun 6, 2024
  2. mdebbar
    self-assigned this
    on Jun 6, 2024
  3. mdebbar
    changed the title [-][web] Change `--web-renderer` default from `auto` to `canvaskit`[/-] [+][web][breaking] Change `--web-renderer` default from `auto` to `canvaskit`[/+] on Jun 6, 2024
  4. sfshaza2
    added a commit that references this issue on Jun 6, 2024

    [web] Change `--web-renderer` default from `auto` to `canvaskit` (#10714

    e82c589

  5. RoarGronmo commented on Jun 6, 2024

    @RoarGronmo
    RoarGronmo
    on Jun 6, 2024

    From which version will it apply ?

  6. RoarGronmo commented on Jun 6, 2024

    @RoarGronmo
    RoarGronmo
    on Jun 6, 2024

    Will you update the documentation here also ?

  7. mdebbar commented on Jun 7, 2024

    @mdebbar
    mdebbar
    on Jun 7, 2024
    ContributorAuthor

    From which version will it apply ?

    The change hasn't landed yet, so I can't tell for sure.

    Will you update the documentation here also ?

    Yes, that documentation is changing here: flutter/website#10722

  8. auto-submit
    closed this as completedin #149773on Jun 10, 2024
  9. auto-submit
    added a commit that references this issue on Jun 10, 2024

    [web] Change `--web-renderer` default from `auto` to `canvaskit` (#14…

    ee10d2f

  10. kevmoo commented on Jun 20, 2024

    @kevmoo
    kevmoo
    on Jun 20, 2024
    Contributor

    Announcement email: https://groups.google.com/g/flutter-announce/c/78pys2K3VGE

  11. github-actions commented on Jul 5, 2024

    @github-actions
    github-actionsbot
    on Jul 5, 2024 – with GitHub Actions

    This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.

  12. github-actions
    locked as resolved and limited conversation to collaborators on Jul 5, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

P1High-priority issues at the top of the work listc: API breakBackwards-incompatible API changese: web_canvaskitCanvasKit (a.k.a. Skia-on-WebGL) rendering backend for Webe: web_htmlHTML rendering backend for Webplatform-webWeb applications specificallyteam-webOwned by Web platform teamtoolAffects the "flutter" command-line tool. See also t: labels.triaged-webTriaged by Web platform team

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions