[sync] 2025/10/09 (#1582)

Author: AmosHuKe

.devcontainer/devcontainer.json

@@ -8,12 +8,12 @@ body:
       value: |
         发现了内容错误？你或许可以尝试修复它！
 
-        1. 点击页面标题右侧的页面图标（BUG 图标左侧），跳转到对应的 GitHub 页面。
-        1. 点击源代码右上方的铅笔图标，进入修改。
-        1. 修复页面错误。
-        1. 点击 **Commit changes...**。
-        1. 写明提交信息和描述。
-        1. 点击 **Propose changes**。
+          1. 滚动页面到底部，点击页面底部的 **查看文档源码**，跳转到对应的 GitHub 页面。
+          1. 点击源代码右上方的铅笔图标，进入修改。
+          1. 修复页面错误。
+          1. 点击 **Commit changes...**。
+          1. 写明提交信息和描述。
+          1. 点击 **Propose changes**。
 
         如果你希望由维护者来修复问题，请填写完整该问题表单。
   - type: input

.github/ISSUE_TEMPLATE/1_page_issue.yml

@@ -32,8 +32,6 @@ jobs:
     continue-on-error: ${{ matrix.experimental }}
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
-        with:
-          submodules: recursive
       - uses: subosito/flutter-action@e938fdf56512cc96ef2f93601a5a40bde3801046
         with:
           channel: ${{ matrix.branch }}
@@ -56,8 +54,6 @@ jobs:
     if: github.repository == 'cfug/flutter.cn'
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
-        with:
-          submodules: recursive
       - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: beta
@@ -74,11 +70,9 @@ jobs:
       github.repository == 'cfug/flutter.cn'
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
-        with:
-          submodules: recursive
       - name: Enable Corepack
         run: npm i -g corepack@latest && corepack enable
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+      - uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -91,6 +85,8 @@ jobs:
           sdk: beta
       - name: Fetch Dart dependencies
         run: dart pub get
+      - name: Install firebase-tools
+        run: curl -sL https://firebase.tools | bash
       - name: Build site
         run: dart run flutter_site build
       - name: Translated (docs.flutter.cn)
@@ -107,8 +103,6 @@ jobs:
     if: github.repository == 'cfug/flutter.cn'
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
-        with:
-          submodules: recursive
       - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: beta
@@ -128,12 +122,11 @@ jobs:
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
         with:
-          submodules: recursive
           # docs.flutter.cn | https://github.com/cfug/flutter.cn/pull/1518
           fetch-depth: 0
       - name: Enable Corepack
         run: npm i -g corepack@latest && corepack enable
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+      - uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'

.github/workflows/build.yml

@@ -14,7 +14,7 @@ permissions:
   contents: write
 
 env:
-  NODE_VERSION: 20
+  NODE_VERSION: 22
 
 jobs:
   compile_host_redirect_js:
@@ -23,8 +23,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
-        with:
-          submodules: recursive
       - uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}

.github/workflows/compile_host_redirect_js.yml

@@ -9,7 +9,7 @@ on:
 permissions: read-all
 
 env:
-  NODE_VERSION: 20
+  NODE_VERSION: 22
 
 jobs:
   stage:
@@ -22,12 +22,11 @@ jobs:
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
         with:
-          submodules: recursive
           # docs.flutter.cn | https://github.com/cfug/flutter.cn/pull/1518
           fetch-depth: 0
       - name: Enable Corepack
         run: npm i -g corepack@latest && corepack enable
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+      - uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'

.github/workflows/stage.yml

@@ -22,5 +22,5 @@ package-lock.json
 pubspec.lock
 tmp/
 
-# Temporary as codelabs used to be a submodule
-examples/codelabs
+# Temporary as site-shared used to be a submodule.
+site-shared/

.gitignore

@@ -2,7 +2,7 @@
 # see: https://developers.google.com/idx/guides/customize-idx-env
 { pkgs, ... }: {
   # Which nixpkgs channel to use.
-  channel = "stable-24.11"; # or "unstable"
+  channel = "stable-25.05"; # or "unstable"
 
   # Use https://search.nixos.org/packages to find packages
   packages = [
@@ -38,7 +38,6 @@
     workspace = {
       # Runs when a workspace is first created
       onCreate = {
-        get-submodule = "git submodule update --init --recursive";
         pnpm-install = "pnpm install";
       };
       # Runs when the workspace is (re)started

.gitmodules

@@ -44,7 +44,7 @@ Other ways you can contribute:
 * [Request docs for docs.flutter.dev][doc-issues]
 * [Submit PRs to docs.flutter.dev][doc-PRs]
 * [Follow us on Twitter: @flutterdev](https://twitter.com/flutterdev/)
-* [Read the Flutter Publication on Medium](https://medium.com/flutter)
+* [Read the Flutter Publication on Medium](https://blog.flutter.dev)
 * [Sign up to Future UX Studies on Flutter](https://flutter.dev/research-signup)
 * [Join the subreddit to keep up with the latest in the Flutter
    community][reddit]

.idx/dev.nix

@@ -75,10 +75,6 @@ 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] 
-> 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 testing your work before submitting.
 
@@ -133,52 +129,28 @@ follow the update instructions for how you originally installed it.
 [Node.js download archive]: https://nodejs.org/en/download/
 [nvm]: https://github.com/nvm-sh/nvm
 
-### Clone this repo and its submodules
-
-> [!NOTE]
-> This repository has git _submodules_, which affects how you clone it.
-> The GitHub documentation has general help on
-> [forking][] and [cloning][] repos.
+### Clone this repo
 
 If you're not a member of the Flutter organization,
-we recommend you **create a fork** of this repo under your own account,
+we recommend you [create a fork][] of this repo under your own account,
 and then submit a PR from that fork.
 
 Once you have a fork (or you're a Flutter org member),
-_choose one_ of the following submodule-cloning techniques:
-
-1. Clone the repo and its submodule at the same time
-   using the `--recurse-submodules` option:
-
-   ```console
-   git clone --recurse-submodules https://github.com/flutter/website.git
-   ```
+clone the repository with `git clone`:
 
-2. If you've already cloned the repo without its submodule,
-   then run this command from the root of the repository:
-
-   ```console
-   git submodule update --init --recursive
-   ```
-
-> [!NOTE]
-> At any time during development
-> you can use the `git submodule` command to refresh submodules:
->
-> ```console
-> git pull && git submodule update --init --recursive
-> ```
+```bash
+git clone https://github.com/flutter/website.git
+```
 
-[cloning]: https://docs.github.com/repositories/creating-and-managing-repositories/cloning-a-repository
-[forking]: https://docs.github.com/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo
+[create a fork]: https://docs.github.com/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo
 
 ## Set up your local environment and serve changes
 
 Before you continue setting up the site infrastructure,
 verify the correct versions of Flutter and Node.js are set up and available by
 following the instructions in [Get the prerequisites](#get-the-prerequisites).
 
-1. _Optional:_ After cloning the repo and its submodules,
+1. _Optional:_ After cloning the repo,
    create a branch for your changes:
 
    ```console