[sync] 2025/04/04 (#1552)

Author: AmosHuKe

.github/workflows/build.yml

@@ -12,7 +12,7 @@ on:
 permissions: read-all
 
 env:
-  NODE_VERSION: 20
+  NODE_VERSION: 22
 
 jobs:
   test:
@@ -34,7 +34,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
         with:
           submodules: recursive
-      - uses: subosito/flutter-action@f2c4f6686ca8e8d6e6d0f28410eeef506ed66aff
+      - uses: subosito/flutter-action@e938fdf56512cc96ef2f93601a5a40bde3801046
         with:
           channel: ${{ matrix.branch }}
       - name: Fetch Dart dependencies
@@ -78,7 +78,7 @@ jobs:
           submodules: recursive
       - name: Enable Corepack
         run: npm i -g corepack@latest && corepack enable
-      - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a
+      - uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -133,7 +133,7 @@ jobs:
           fetch-depth: 0
       - name: Enable Corepack
         run: npm i -g corepack@latest && corepack enable
-      - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a
+      - uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'

.github/workflows/stage.yml

@@ -27,7 +27,7 @@ jobs:
           fetch-depth: 0
       - name: Enable Corepack
         run: npm i -g corepack@latest && corepack enable
-      - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a
+      - uses: actions/setup-node@cdca7365b2dadb8aad0a33bc7601856ffabcc48e
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'

README.md

@@ -2,7 +2,7 @@
 
 [Flutter logo]: https://github.com/dart-lang/site-shared/blob/main/src/_assets/image/flutter/icon/64.png?raw=1
 
-# [Flutter][] documentation website 
+# [Flutter][] documentation website
 
 The [documentation site][Flutter] for the [Flutter framework][],
 built with [Eleventy][] and hosted on [Firebase][].
@@ -32,41 +32,41 @@ built with [Eleventy][] and hosted on [Firebase][].
 
 ## Issues, bugs, and requests
 
-We welcome contributions and feedback on our website. 
+We welcome contributions and feedback on our website.
 Please file a request in our
-[issue tracker](https://github.com/flutter/website/issues/new/choose) 
-or create a [pull request](https://github.com/flutter/website/pulls). 
-For simple changes (such as tweaking some text), 
+[issue tracker](https://github.com/flutter/website/issues/new/choose)
+or create a [pull request](https://github.com/flutter/website/pulls).
+For simple changes (such as tweaking some text),
 it's easiest to make changes using the GitHub UI.
 
-If you have an issue with the 
-API docs on [api.flutter.dev](https://api.flutter.dev), 
-please file those issues on 
-the [`flutter/flutter`](https://github.com/flutter/flutter/issues) repo, 
-not on this (`flutter/website`) repo. 
-The API docs are embedded in Flutter's source code, 
+If you have an issue with the
+API docs on [api.flutter.dev](https://api.flutter.dev),
+please file those issues on
+the [`flutter/flutter`](https://github.com/flutter/flutter/issues) repo,
+not on this (`flutter/website`) repo.
+The API docs are embedded in Flutter's source code,
 so the engineering team handles those.
 
 
 ## Before you submit a PR
 
-We love it when the community gets involved in improving our docs! 
+We love it when the community gets involved in improving our docs!
 But here are a few notes to keep in mind before you submit a PR:
 
-- When triaging issues, 
-  we sometimes label an issue with the tag **PRs welcome**. 
+- When triaging issues,
+  we sometimes label an issue with the tag **PRs welcome**.
   But we welcome PRs on other issues as well—
   it doesn't have to be tagged with that label.
-- Please don't run our docs through Grammarly (or similar) 
+- Please don't run our docs through Grammarly (or similar)
   and submit those changes as a PR.
 - We follow the [Google Developer Documentation Style Guidelines][] —
-  for example, don't use "i.e." or "e.g.", 
+  for example, don't use "i.e." or "e.g.",
   avoid writing in first person,
   and avoid writing in future tense.
   You can start with the
-  [style guide highlights](https://developers.google.com/style/highlights) 
-  or the [word list](https://developers.google.com/style/word-list), 
-  or use the search bar that's at the top of every style guide page. 
+  [style guide highlights](https://developers.google.com/style/highlights)
+  or the [word list](https://developers.google.com/style/word-list),
+  or use the search bar at the top of every style guide page.
 
 > We truly thank you for your willingness and helpfulness
 > in keeping the website docs up to date!
@@ -83,12 +83,12 @@ you probably don't need to build this site.
 Often you can make changes using the GitHub UI.
 If needed, we can stage the changes automatically in your pull request.
 
-> [!IMPORTANT]  
+> [!IMPORTANT] 
 > If you are cloning this repository locally,
 > follow the below instruction on cloning with its submodule.
 
 If your change involves code samples, adds/removes pages, or affects navigation,
-do consider building and test your work before submitting.
+do consider building and testing your work before submitting.
 
 If you want or need to build the site, follow the steps below.
 
@@ -239,7 +239,7 @@ following the instructions in [Get the prerequisites](#get-the-prerequisites).
    ```console
    pnpm install
    ```
-   
+
    Rerun `pnpm install` whenever you incorporate the
    latest changes to the `main` branch or if you
    experience dependency or import errors when building the site.
@@ -318,7 +318,7 @@ in the corresponding `.dart` files.
 
 The `.dart` files are the source of truth for code snippets,
 and the preceding `<?code-excerpt>` instructions in Markdown files specify
-how the snippets are copied from the `.dart` files. 
+how the snippets are copied from the `.dart` files.
 
 To resolve this error and update the Markdown snippets to match,
 from the root of the `website` directory,
@@ -341,7 +341,7 @@ you can build a full version and upload it to Firebase.
   - Navigate to the [Firebase Console](https://console.firebase.google.com)
     and create your own Firebase project (for example, `flutter-dev-staging`).
 
-  - Head back to your local terminal and verify that you are logged in.
+  - Head back to your local terminal and verify that you're logged in.
 
     ```console
     firebase login

dash_site

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-REQUIRED_DART_VERSION="3.6"
+REQUIRED_DART_VERSION="3.7"
 REQUIRED_NODE_VERSION="22.11"
 REQUIRED_PNPM_VERSION="9.12"
 

eleventy.config.ts

@@ -76,6 +76,7 @@ export default function (eleventyConfig: UserConfig) {
   eleventyConfig.addPassthroughCopy('src/content/assets/js');
   // inject_dartpad 暂时放置在本地 tool/inject_dartpad/
   // eleventyConfig.addPassthroughCopy({'site-shared/pkgs/inject_dartpad/lib/inject_dartpad.js': 'assets/js/inject_dartpad.js'});
+  eleventyConfig.addPassthroughCopy({'tool/inject_dartpad/lib/inject_dartpad.js': 'assets/js/inject_dartpad.js'});
   eleventyConfig.addPassthroughCopy('src/content/assets/images', { expand: true });
   // docs.flutter.cn - translator
   eleventyConfig.addPassthroughCopy('src/content/assets/translator');

examples/_animation/basic_hero_animation/pubspec.yaml

@@ -5,7 +5,7 @@ description: >-
 
 resolution: workspace
 environment:
-  sdk: ^3.7.0-0
+  sdk: ^3.7.0
 
 dependencies:
   flutter:

examples/_animation/basic_radial_hero_animation/pubspec.yaml

@@ -6,7 +6,7 @@ description: >-
 
 resolution: workspace
 environment:
-  sdk: ^3.7.0-0
+  sdk: ^3.7.0
 
 dependencies:
   flutter:

examples/_animation/basic_staggered_animation/pubspec.yaml

@@ -4,7 +4,7 @@ description: An introductory example to staggered animations.
 
 resolution: workspace
 environment:
-  sdk: ^3.7.0-0
+  sdk: ^3.7.0
 
 dependencies:
   flutter:

examples/_animation/hero_animation/pubspec.yaml

@@ -4,7 +4,7 @@ description: Shows how to create a simple Hero transition.
 
 resolution: workspace
 environment:
-  sdk: ^3.7.0-0
+  sdk: ^3.7.0
 
 dependencies:
   flutter:

examples/_animation/radial_hero_animation/pubspec.yaml

@@ -6,7 +6,7 @@ description: >-
 
 resolution: workspace
 environment:
-  sdk: ^3.7.0-0
+  sdk: ^3.7.0
 
 dependencies:
   flutter: