[sync] 2025/12/10 (#1591)

Author: AmosHuKe

.github/workflows/build.yml

@@ -28,7 +28,7 @@ jobs:
             experimental: true
     continue-on-error: ${{ matrix.experimental }}
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
       - uses: subosito/flutter-action@e938fdf56512cc96ef2f93601a5a40bde3801046
         with:
           channel: ${{ matrix.branch }}
@@ -50,7 +50,7 @@ jobs:
     runs-on: ubuntu-latest
     if: github.repository == 'cfug/flutter.cn'
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
       - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: beta
@@ -66,7 +66,7 @@ jobs:
     timeout-minutes: 30
     if: github.repository == 'cfug/flutter.cn'
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
       - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: beta
@@ -92,7 +92,7 @@ jobs:
     runs-on: ubuntu-latest
     if: github.repository == 'cfug/flutter.cn'
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
       - uses: dart-lang/setup-dart@e51d8e571e22473a2ddebf0ef8a2123f0ab2c02c
         with:
           sdk: beta
@@ -110,7 +110,7 @@ jobs:
       github.ref == 'refs/heads/main' &&
       github.repository == 'cfug/flutter.cn'
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
         with:
           # docs.flutter.cn | https://github.com/cfug/flutter.cn/pull/1518
           fetch-depth: 0

.github/workflows/compile_host_redirect_js.yml

@@ -22,7 +22,7 @@ jobs:
             github.repository == 'cfug/flutter.cn' }}
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: ${{ env.NODE_VERSION }}

.github/workflows/stage.yml

@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     if: ${{ github.event.pull_request.head.repo.full_name == 'cfug/flutter.cn' }}
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8
         with:
           # docs.flutter.cn | https://github.com/cfug/flutter.cn/pull/1518
           fetch-depth: 0

firebase.json

@@ -50,6 +50,7 @@
       { "source": "/development", "destination": "/", "type": 301 },
       { "source": "/development/:rest*", "destination": "/:rest*", "type": 301 },
       { "source": "/devtools/:rest*", "destination": "/tools/devtools/:rest*", "type": 301 },
+      { "source": "/download", "destination": "/install", "type": 301 },
       { "source": "/downloads/:resource*", "destination": "/resources/:resource*", "type": 301 },
       { "source": "/f/dart-devtools-survey-metadata.json", "destination": "https://storage.googleapis.com/flutter-uxr/surveys/devtools-survey-metadata.json", "type": 301 },
       { "source": "/f/flutter-survey-metadata.json", "destination": "https://storage.googleapis.com/flutter-uxr/surveys/flutter-survey-metadata.json", "type": 301 },
@@ -360,6 +361,7 @@
       { "source": "/go/dash-tooling-plugin-strategy", "destination": "https://docs.google.com/document/d/1Zc0AE8JTKfOSA-IFpEYcPFJ2eALbXE3AG4ZucWXeMig/", "type": 301 },
       { "source": "/go/data-sync", "destination": "https://docs.google.com/document/d/1yH96-p-SkMmt6hL5xHHDtMvCKRz2XGrMuw9ZY_nE954", "type": 301 },
       { "source": "/go/decouple-design", "destination": "https://docs.google.com/document/d/189AbzVGpxhQczTcdfJd13o_EL36t-M5jOEt1hgBIh7w/edit?usp=sharing", "type": 301 },
+      { "source": "/go/decoupling-design-from-text", "destination": "https://docs.google.com/document/d/1oFezK5leJzTWA5lsw3BQGx7gLbhpSL8dMleU3HD7bNY/edit?usp=sharing", "type": 301},
       { "source": "/go/dds-daemon", "destination": "https://docs.google.com/document/d/18IgFakijiv9CLFGT5BckbwZuf2pqhOUeN27mB9XqvpQ/edit?usp=sharing&resourcekey=0-rBHvH9gLXLjGPWt5WE-XFg", "type": 301 },
       { "source": "/go/decoupling-framework-tests", "destination": "https://docs.google.com/document/d/1UHxALQqCbmgjnM1RNV9xE2pK3IGyx-UktGX1D7hYCjs/edit?pli=1&tab=t.0", "type": 301 },
       { "source": "/go/deep-link-flag-migration", "destination": "https://docs.google.com/document/d/1TUhaEhNdi2BUgKWQFEbOzJgmUAlLJwIAhnFfZraKgQs/edit?usp=sharing", "type": 301 },
@@ -436,6 +438,7 @@
       { "source": "/go/flutter-drop-win7-2024", "destination": "https://docs.google.com/document/d/18gfRT8klo0zEvn6fIpders7ghoWIBKO22cNYS22WLhc/edit?resourcekey=0-SFkxdqfyM6KNNkG4zS6aaA", "type": 301 },
       { "source": "/go/flutter-engine-clocks", "destination": "https://docs.google.com/document/d/1Sx8QA1qXgJGw5r4ESviDnU2LSShNHiq_LjbRWPgSvXQ/edit?usp=sharing&resourcekey=0-BoBvLxgqf_nc_rwLc0zmTw", "type": 301 },
       { "source": "/go/flutter-engine-extensions", "destination": "https://docs.google.com/document/d/1xG7jR4FserdW7TdwnklF3_lXUGmt4myPQjDGF3LFtCQ/edit?resourcekey=0-Iug4D2mWuyQI6suvC_2itw#", "type": 301 },
+      { "source": "/go/flutter-file-system", "destination": "https://docs.google.com/document/d/150KFR6WRSqpxbUcvQriBgrv6P5DMcq6dORikf_cOgZo/edit?usp=sharing", "type": 301 },
       { "source": "/go/flutter-for-embedded-linux", "destination": "https://docs.google.com/document/d/1n4NXCk0QlGz16gUCtywR79H0Z1fzPqB2iNL8oxuexuk/edit?usp=sharing", "type": 301 },
       { "source": "/go/flutter-gradle-plugin-apply", "destination": "/release/breaking-changes/flutter-gradle-plugin-apply", "type": 301 },
       { "source": "/go/flutter-iap-migrate-pblv2", "destination": "https://docs.google.com/document/d/1XM16UsLE_aPWoZnheE9waO06mhxLkkWjpPf9jtI1AdY/edit", "type": 301 },

site/lib/_sass/_site.scss

@@ -14,6 +14,7 @@
 @use 'components/alert';
 @use 'components/banner';
 @use 'components/books';
+@use 'components/breadcrumbs';
 @use 'components/button';
 @use 'components/card';
 @use 'components/code';
@@ -29,14 +30,17 @@
 @use 'components/misc';
 @use 'components/next-prev-nav';
 @use 'components/os-selector';
+@use 'components/pagenav';
+@use 'components/platform-cards';
 @use 'components/pill';
 @use 'components/quiz';
 @use 'components/sidebar';
 @use 'components/side-menu';
 @use 'components/site-switcher';
+@use 'components/summary-card';
+@use 'components/stepper';
 @use 'components/tabs';
 @use 'components/theming';
-@use 'components/toc';
 @use 'components/tooltip';
 @use 'components/trailing';
 

site/lib/_sass/base/_base.scss

@@ -8,8 +8,10 @@ body {
   color: var(--site-base-fgColor);
 
   // The top TOC is not shown on narrow screens.
-  @media (min-width: 1200px) {
-    --site-subheader-height: 0rem;
+  &:not(:has(#site-subheader.show-always)) {
+    @media (min-width: 1200px) {
+      --site-subheader-height: 0rem;
+    }
   }
 
   // If the TOC is disabled, reduce the subheader height to
@@ -46,8 +48,13 @@ h2 {
 }
 
 dd {
-  margin-bottom: .75rem;
+  margin-block-end: .75rem;
   margin-left: 1rem;
+
+  >p:only-child {
+    margin-block-start: 1rem;
+    margin-block-end: 1rem;
+  }
 }
 
 img {
@@ -153,43 +160,6 @@ main figure {
     font-style: italic;
     text-align: center;
   }
-
-  &.code-and-image {
-    gap: 0.25rem;
-    justify-content: space-between;
-    flex-direction: row;
-    flex-wrap: wrap;
-
-    >div {
-      width: 100%;
-
-      &:last-child {
-        text-align: center;
-      }
-    }
-
-    @media(min-width: 769px) {
-      >div {
-        &:first-child {
-          flex: 0 0 58%;
-          max-width: 58%;
-        }
-
-        &:last-child {
-          flex: 0 0 40%;
-          max-width: 40%;
-        }
-      }
-
-      figcaption {
-        text-align: left;
-      }
-
-      img {
-        max-width: 100%;
-      }
-    }
-  }
 }
 
 .text-icon {
@@ -353,14 +323,19 @@ ol.steps {
       margin-block-end: 0.75rem;
     }
 
+    >h3:first-child,
+    >p:first-child {
+      height: $step-indicator-height;
+      margin-block-end: 0.5rem;
+      font-weight: 500;
+    }
+
     >h3:first-child {
       display: flex;
       align-items: center;
-      height: $step-indicator-height;
       font-size: 1.125rem;
       font-weight: 500;
       color: var(--site-base-fgColor-lighter);
-      margin-block-end: 0.5rem;
     }
 
     padding-block-end: 0.75rem;
@@ -429,6 +404,7 @@ p+dl {
 }
 
 .figure-caption {
+  margin-top: 0.25rem;
   font-size: .875rem;
   font-style: italic;
   color: var(--site-base-fgColor-lighter);

site/lib/_sass/components/_breadcrumbs.scss

@@ -0,0 +1,47 @@
+nav.breadcrumbs {
+  align-items: center;
+
+  ol.breadcrumb-list {
+    margin: 0;
+    padding: 0;
+    border-radius: var(--site-radius);
+    font-size: 0.925rem;
+
+    align-items: center;
+    list-style: none;
+
+    font-family: var(--site-ui-fontFamily);
+
+    display: flex;
+    flex-wrap: wrap;
+    flex-direction: row;
+
+    li.breadcrumb-item {
+      display: flex;
+      flex-direction: row;
+      align-items: center;
+      padding: 0;
+
+      & a {
+        padding: 0.125rem;
+        border-radius: 0.125rem;
+      }
+
+      &.active a {
+        color: var(--site-base-fgColor-lighter);
+        cursor: default;
+        text-decoration: none;
+      }
+
+      &:before {
+        display: none;
+      }
+    }
+
+    .material-symbols {
+      user-select: none;
+      font-size: 1.25rem;
+      color: var(--site-base-fgColor-lighter);
+    }
+  }
+}

site/lib/_sass/components/_button.scss

@@ -94,3 +94,22 @@ button {
     }
   }
 }
+
+.segmented-button {
+  display: inline-flex;
+
+  a,
+  button {
+    &:not(:last-child) {
+      border-top-right-radius: 0;
+      border-bottom-right-radius: 0;
+
+      border-right: 1px solid var(--site-outline-variant);
+    }
+
+    &:not(:first-child) {
+      border-top-left-radius: 0;
+      border-bottom-left-radius: 0;
+    }
+  }
+}