[sync] 2025/02/13 (#1544)

ref #374

- Flutter 3.29 正式发布

Author: AmosHuKe

.github/workflows/build.yml

@@ -25,10 +25,10 @@ jobs:
         include:
           - name: "Beta channel"
             branch: beta
-            experimental: true
+            experimental: false
           - name: "Stable channel"
             branch: stable
-            experimental: false
+            experimental: true
     continue-on-error: ${{ matrix.experimental }}
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
@@ -60,7 +60,7 @@ jobs:
           submodules: recursive
       - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
-          sdk: stable
+          sdk: beta
       - name: Fetch Dart dependencies
         run: dart pub get
       - name: Check if excerpts are up to date
@@ -77,8 +77,8 @@ jobs:
         with:
           submodules: recursive
       - name: Enable Corepack
-        run: corepack enable
-      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af
+        run: npm i -g corepack@latest && corepack enable
+      - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -88,7 +88,7 @@ jobs:
         run: pnpm install --frozen-lockfile
       - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
-          sdk: stable
+          sdk: beta
       - name: Fetch Dart dependencies
         run: dart pub get
       - name: Build site
@@ -111,7 +111,7 @@ jobs:
           submodules: recursive
       - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
-          sdk: stable
+          sdk: beta
       - name: Fetch Dart dependencies
         run: dart pub get
       - name: Validate the firebase.json file
@@ -133,7 +133,7 @@ jobs:
           fetch-depth: 0
       - name: Enable Corepack
         run: corepack enable
-      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af
+      - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -143,7 +143,7 @@ jobs:
         run: pnpm install --frozen-lockfile
       - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
-          sdk: stable
+          sdk: beta
       - name: Fetch Dart dependencies
         run: dart pub get
       - name: Build site

.github/workflows/stage.yml

@@ -27,7 +27,7 @@ jobs:
           fetch-depth: 0
       - name: Enable Corepack
         run: corepack enable
-      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af
+      - uses: actions/setup-node@1d0ff469b7ec7b3cb9d8673fde0c81c44821de2a
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'pnpm'
@@ -37,7 +37,7 @@ jobs:
         run: pnpm install --frozen-lockfile
       - uses: dart-lang/setup-dart@e630b99d28a3b71860378cafdc2a067c71107f94
         with:
-          sdk: stable
+          sdk: beta
       - name: Fetch Dart dependencies
         run: dart pub get
       - name: Build site

CONTRIBUTING.md

@@ -60,5 +60,5 @@ Happy Fluttering!
 [doc-PRs]: https://github.com/flutter/website/pulls
 [so]: https://stackoverflow.com/tags/flutter
 [mailinglist]: https://groups.google.com/d/forum/flutter-dev
-[chat]: https://github.com/flutter/flutter/blob/master/docs/contributing/Chat.md
+[chat]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
 [reddit]: https://www.reddit.com/r/FlutterDev

README.md

@@ -306,7 +306,7 @@ and we'll try our best to help you.
 You can also chat with us on the `#hackers-devrel` channel
 on the [Flutter contributors Discord][]!
 
-[Flutter contributors Discord]: https://github.com/flutter/flutter/blob/master/docs/contributing/Chat.md
+[Flutter contributors Discord]: https://github.com/flutter/flutter/blob/main/docs/contributing/Chat.md
 
 ### Refresh code excerpts
 

diagrams/resources/web-framework-diagram.drawio

@@ -12,19 +12,15 @@ class BasicHeroAnimation extends StatelessWidget {
   @override
   Widget build(BuildContext context) {
     return Scaffold(
-      appBar: AppBar(
-        title: const Text('Basic Hero Animation'),
-      ),
+      appBar: AppBar(title: const Text('Basic Hero Animation')),
       body: Center(
         child: InkWell(
           onTap: () {
             Navigator.of(context).push(
               MaterialPageRoute<void>(
                 builder: (context) {
                   return Scaffold(
-                    appBar: AppBar(
-                      title: const Text('Flippers Page'),
-                    ),
+                    appBar: AppBar(title: const Text('Flippers Page')),
                     body: Container(
                       padding: const EdgeInsets.all(8),
                       alignment: Alignment.topLeft,
@@ -34,9 +30,7 @@ class BasicHeroAnimation extends StatelessWidget {
                         tag: 'flippers',
                         child: SizedBox(
                           width: 100,
-                          child: Image.asset(
-                            'images/flippers-alpha.png',
-                          ),
+                          child: Image.asset('images/flippers-alpha.png'),
                         ),
                       ),
                     ),
@@ -48,9 +42,7 @@ class BasicHeroAnimation extends StatelessWidget {
           // Main route
           child: Hero(
             tag: 'flippers',
-            child: Image.asset(
-              'images/flippers-alpha.png',
-            ),
+            child: Image.asset('images/flippers-alpha.png'),
           ),
         ),
       ),
@@ -59,9 +51,5 @@ class BasicHeroAnimation extends StatelessWidget {
 }
 
 void main() {
-  runApp(
-    const MaterialApp(
-      home: BasicHeroAnimation(),
-    ),
-  );
+  runApp(const MaterialApp(home: BasicHeroAnimation()));
 }

examples/_animation/basic_hero_animation/lib/main.dart

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

examples/_animation/basic_hero_animation/pubspec.yaml

@@ -25,21 +25,15 @@ class Photo extends StatelessWidget {
       color: Theme.of(context).primaryColor.withValues(alpha: 0.25),
       child: InkWell(
         onTap: onTap,
-        child: Image.asset(
-          photo,
-          fit: BoxFit.contain,
-        ),
+        child: Image.asset(photo, fit: BoxFit.contain),
       ),
     );
   }
 }
 
 class RadialExpansion extends StatelessWidget {
-  const RadialExpansion({
-    super.key,
-    required this.maxRadius,
-    this.child,
-  }) : clipRectExtent = 2.0 * (maxRadius / math.sqrt2);
+  const RadialExpansion({super.key, required this.maxRadius, this.child})
+    : clipRectExtent = 2.0 * (maxRadius / math.sqrt2);
 
   final double maxRadius;
   final double clipRectExtent;
@@ -55,9 +49,7 @@ class RadialExpansion extends StatelessWidget {
         child: SizedBox(
           width: clipRectExtent,
           height: clipRectExtent,
-          child: ClipRect(
-            child: child,
-          ),
+          child: ClipRect(child: child),
         ),
       ),
     );
@@ -69,15 +61,21 @@ class RadialExpansionDemo extends StatelessWidget {
 
   static double kMinRadius = 32;
   static double kMaxRadius = 128;
-  static Interval opacityCurve =
-      const Interval(0.0, 0.75, curve: Curves.fastOutSlowIn);
+  static Interval opacityCurve = const Interval(
+    0.0,
+    0.75,
+    curve: Curves.fastOutSlowIn,
+  );
 
   static RectTween _createRectTween(Rect? begin, Rect? end) {
     return MaterialRectCenterArcTween(begin: begin, end: end);
   }
 
   static Widget _buildPage(
-      BuildContext context, String imageName, String description) {
+    BuildContext context,
+    String imageName,
+    String description,
+  ) {
     return Container(
       color: Theme.of(context).canvasColor,
       alignment: FractionalOffset.center,
@@ -102,7 +100,10 @@ class RadialExpansionDemo extends StatelessWidget {
   }
 
   Widget _buildHero(
-      BuildContext context, String imageName, String description) {
+    BuildContext context,
+    String imageName,
+    String description,
+  ) {
     return SizedBox(
       width: kMinRadius * 2,
       height: kMinRadius * 2,
@@ -141,9 +142,7 @@ class RadialExpansionDemo extends StatelessWidget {
     timeDilation = 20.0; // 1.0 is normal animation speed.
 
     return Scaffold(
-      appBar: AppBar(
-        title: const Text('Basic Radial Hero Animation Demo'),
-      ),
+      appBar: AppBar(title: const Text('Basic Radial Hero Animation Demo')),
       body: Container(
         padding: const EdgeInsets.all(32),
         alignment: FractionalOffset.bottomLeft,
@@ -161,9 +160,5 @@ class RadialExpansionDemo extends StatelessWidget {
 }
 
 void main() {
-  runApp(
-    const MaterialApp(
-      home: RadialExpansionDemo(),
-    ),
-  );
+  runApp(const MaterialApp(home: RadialExpansionDemo()));
 }

examples/_animation/basic_radial_hero_animation/lib/main.dart

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