[sync] 2026/06/22 (#1625)

Author: AmosHuKe

.github/workflows/codeql-analysis.yml

@@ -29,11 +29,11 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@7211b7c8077ea37d8641b6271f6a365a22a5fbfa
+      uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e
       with:
         languages: ${{ matrix.language }}
         # If you wish to specify custom queries, you can do so here or in a config file.
@@ -44,7 +44,7 @@ jobs:
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
     - name: Autobuild
-      uses: github/codeql-action/autobuild@7211b7c8077ea37d8641b6271f6a365a22a5fbfa
+      uses: github/codeql-action/autobuild@8aad20d150bbac5944a9f9d289da16a4b0d87c1e
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -58,4 +58,4 @@ jobs:
     #   make release
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@7211b7c8077ea37d8641b6271f6a365a22a5fbfa
+      uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e

…b/workflows/compile_host_redirect_js.yml …b/workflows/compile-host-redirect-js.yml.github/workflows/compile_host_redirect_js.yml renamed to .github/workflows/compile-host-redirect-js.yml .github/workflows/compile_host_redirect_js.yml renamed to .github/workflows/compile-host-redirect-js.yml

@@ -23,7 +23,7 @@ jobs:
       github.repository == 'cfug/flutter.cn'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
       - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e
         with:
           node-version: ${{ env.NODE_VERSION }}

.github/workflows/dart.yml

@@ -52,7 +52,7 @@ jobs:
             experimental: true
     continue-on-error: ${{ matrix.experimental }}
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
       - uses: subosito/flutter-action@e938fdf56512cc96ef2f93601a5a40bde3801046
         with:
           channel: ${{ matrix.branch }}

.github/workflows/stage.yml .github/workflows/docs-stage.yml.github/workflows/stage.yml renamed to .github/workflows/docs-stage.yml

@@ -4,6 +4,17 @@ on:
   pull_request:
     branches:
       - main
+    paths:
+      - 'sites/docs/**'
+      - 'examples/**'
+      - 'packages/excerpter/**'
+      - 'firebase.json'
+      - 'tool/dash_site/**'
+      - 'tool/config/linkcheck-skip-list.txt'
+      - 'pubspec.yaml'
+      - 'pubspec.lock'
+      - 'analysis_options.yaml'
+      - '.github/workflows/docs.yml'
 
 # Declare default permissions as read only.
 permissions: read-all
@@ -18,7 +29,7 @@ jobs:
     if: |
       github.event.pull_request.head.repo.full_name == 'cfug/flutter.cn'
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
         with:
           # docs.flutter.cn | https://github.com/cfug/flutter.cn/pull/1518
           fetch-depth: 0

.github/workflows/translator_bot.yml .github/workflows/docs-translator-bot.yml.github/workflows/translator_bot.yml renamed to .github/workflows/docs-translator-bot.yml

@@ -1,4 +1,4 @@
-name: translator_bot
+name: translator_bot (docs)
 
 on:
   issue_comment:

.github/workflows/docs.yml

@@ -1,6 +1,7 @@
 name: Docs site
 
 on:
+  workflow_dispatch:
   push:
     branches:
       - main
@@ -45,7 +46,7 @@ jobs:
     if: github.repository == 'cfug/flutter.cn'
     timeout-minutes: 20
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
       - uses: dart-lang/setup-dart@65eb853c7ba17dde3be364c3d2858773e7144260
         with:
           sdk: beta
@@ -60,7 +61,7 @@ jobs:
     if: github.repository == 'cfug/flutter.cn'
     timeout-minutes: 30
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
       - uses: dart-lang/setup-dart@65eb853c7ba17dde3be364c3d2858773e7144260
         with:
           sdk: beta
@@ -87,7 +88,7 @@ jobs:
     if: github.repository == 'cfug/flutter.cn'
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
       - uses: dart-lang/setup-dart@65eb853c7ba17dde3be364c3d2858773e7144260
         with:
           sdk: beta
@@ -105,7 +106,7 @@ jobs:
       github.ref == 'refs/heads/main' &&
       github.repository == 'cfug/flutter.cn'
     steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
         with:
           # docs.flutter.cn | https://github.com/cfug/flutter.cn/pull/1518
           fetch-depth: 0
@@ -123,7 +124,7 @@ jobs:
         run: bash tool/translator/build.sh
         shell: bash
       - name: Deploy to production
-        run: bash tool/translator/deploy-cn.sh
+        run: bash tool/deploy/deploy-cn-docs.sh
         shell: bash
         env:
           DEPLOY_USER: ${{ secrets.DOCS_REPO_DEPLOY_USER }}

.github/workflows/www.yml

@@ -0,0 +1,97 @@
+name: Marketing site
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths:
+      - 'sites/www/**'
+      - 'tool/dash_site/**'
+      - 'tool/config/linkcheck-skip-list.txt'
+      - 'pubspec.yaml'
+      - 'pubspec.lock'
+      - 'analysis_options.yaml'
+      - '.github/workflows/www.yml'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'sites/www/**'
+      - 'tool/dash_site/**'
+      - 'tool/config/linkcheck-skip-list.txt'
+      - 'pubspec.yaml'
+      - 'pubspec.lock'
+      - 'analysis_options.yaml'
+      - '.github/workflows/www.yml'
+  # schedule:
+  #   - cron: '0 0 * * 0'
+
+permissions: read-all
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  linkcheck:
+    name: Build and check links
+    runs-on: ubuntu-latest
+    if: github.repository == 'cfug/flutter.cn'
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
+      - uses: dart-lang/setup-dart@65eb853c7ba17dde3be364c3d2858773e7144260
+        with:
+          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 dash_site --site=www build
+      - name: Check for broken Markdown link references
+        run: dart run dash_site --site=www check-link-references
+      - name: Check for broken internal links
+        run: dart run dash_site --site=www check-links
+
+  firebase-validate:
+    name: Validate Firebase configuration
+    runs-on: ubuntu-latest
+    if: github.repository == 'cfug/flutter.cn'
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
+      - uses: dart-lang/setup-dart@65eb853c7ba17dde3be364c3d2858773e7144260
+        with:
+          sdk: beta
+      - name: Fetch Dart dependencies
+        run: dart pub get
+      - name: Validate the firebase.json file
+        run: dart run dash_site --site=www verify-firebase-json
+
+  deploy:
+    name: Deploy to production
+    needs: [linkcheck, firebase-validate]
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'push' &&
+      github.ref == 'refs/heads/main' &&
+      github.repository == 'cfug/flutter.cn'
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
+        with:
+          fetch-depth: 0
+      - uses: dart-lang/setup-dart@65eb853c7ba17dde3be364c3d2858773e7144260
+        with:
+          sdk: beta
+      - name: Fetch Dart dependencies
+        run: dart pub get
+      - name: Build site
+        run: dart run dash_site --site=www build --release
+      - name: Deploy to production
+        run: bash tool/deploy/deploy-cn-www.sh
+        shell: bash
+        env:
+          DEPLOY_USER: ${{ secrets.DOCS_REPO_DEPLOY_USER }}
+          DEPLOY_TOKEN: ${{ secrets.DOCS_REPO_DEPLOY_TOKEN }}

AGENTS.md

@@ -7,14 +7,20 @@ content and code in this repository.
 ## Project overview
 
 This repository contains the source code and content for
-the Flutter framework's documentation website.
-It is hosted at `docs.flutter.dev` and shouldn't be confused with
-the marketing site at `flutter.dev` or the API docs at `api.flutter.dev`.
+the Flutter framework's documentation and marketing websites:
 
-The website is statically built and implemented with
+- `docs.flutter.dev`:
+  The Flutter framework's documentation website.
+- `flutter.dev`:
+  Flutter's homepage and marketing website.
+
+The API docs at `api.flutter.dev` are embedded in the Flutter SDK source
+and are maintained in the <https://github.com/flutter/flutter> repository.
+
+The websites are statically built and implemented with
 Dart and the [Jaspr](https://jaspr.site) web framework.
-For loading content, data, and some of its assets,
-it uses [Jaspr Content](https://docs.jaspr.site/content).
+For loading content, data, and some assets,
+they use [Jaspr Content](https://docs.jaspr.site/content).
 
 ### Directory structure
 
@@ -30,29 +36,40 @@ it uses [Jaspr Content](https://docs.jaspr.site/content).
       for the sidenav, glossary, and various indices.
     - `sites/docs/src/_includes/`:
       Liquid partial files written in Markdown.
+  - `sites/www/`:
+    The implementation of flutter.dev,
+    written in Dart using Jaspr and Jaspr Content.
+    - `sites/www/content/`:
+      Markdown-based marketing pages and structured content.
+    - `sites/www/lib/`:
+      Dart source code for the site.
+    - `sites/www/firebase.json`:
+      Firebase Hosting configuration for flutter.dev.
 - `examples/`:
   A pub workspace containing Dart and Flutter code examples,
-  referenced by code excerpts in the Markdown files.
+  referenced by code excerpts in the docs Markdown files.
 - `tool/dash_site/`:
   CLI tool for site development and maintenance.
 
 ## Common commands
 
-While working on the site,
+While working on these sites,
 you might need to run these commands:
 
 ```bash
 # Install or update Dart dependencies:
 dart pub get
 
 # Serve a dev server of the site locally:
-dart run dash_site serve
+dart run dash_site --site=docs serve
+dart run dash_site --site=www serve
 
 # Build a production version of the site:
-dart run dash_site build
+dart run dash_site --site=docs build
+dart run dash_site --site=www build
 
-# Sync code excerpts to Markdown files:
-dart run dash_site refresh-excerpts
+# Sync docs code excerpts to Markdown files:
+dart run dash_site --site=docs refresh-excerpts
 
 # Learn what other commands are available:
 dart run dash_site --help

README.md

@@ -148,9 +148,8 @@ following the instructions in [Get the prerequisites](#get-the-prerequisites).
    This command generates and serves the site on a
    local port that's printed to your terminal.
 
-5. View your changes in the browser by navigating to <http://localhost:8080>.
-
-   Note the port might be different if `8080` is taken.
+5. View your changes in the browser by navigating to
+   the local URL printed to your terminal.
 
 6. Make your changes to the local repo.
 

examples/cookbook/plugins/google_mobile_ads/pubspec.yaml

@@ -9,7 +9,7 @@ dependencies:
   flutter:
     sdk: flutter
 
-  google_mobile_ads: ^8.0.0
+  google_mobile_ads: ^9.0.0
 
 flutter:
   uses-material-design: true