Update site tooling and examples for Dart 3.1.0 (#5104)

Closes #5105

Author: parlough

Dockerfile

@@ -33,22 +33,22 @@ ENV PATH=$DART_SDK/bin:$PATH
 RUN set -eu; \
     case "$(dpkg --print-architecture)_${DART_CHANNEL}" in \
       amd64_stable) \
-        DART_SHA256="cccd5300faa5a9abce12a5f77586e26350028cea82bb4ff8eeb55641b58a2e1d"; \
+        DART_SHA256="7ce5c1560b1d8ea5ee0e6d44f1c3e7b804ddc5377b38d72fe4d43009a6c67e84"; \
         SDK_ARCH="x64";; \
       arm64_stable) \
-        DART_SHA256="2c8eeaf0d3da60c4e14beec45ce3b39aca754f71b9fa3fb0c635ee28d6f44708"; \
+        DART_SHA256="fd4fcc05f1d1c82fd618b83c7d877968460c5bd425774d89add438be12a20795"; \
         SDK_ARCH="arm64";; \
       amd64_beta) \
-        DART_SHA256="e3bdf39358dda7f0fd02b25d4d4539536fff53b4ab257da31a5fbbe42edc28c9"; \
+        DART_SHA256="7ce5c1560b1d8ea5ee0e6d44f1c3e7b804ddc5377b38d72fe4d43009a6c67e84"; \
         SDK_ARCH="x64";; \
       arm64_beta) \
-        DART_SHA256="7e7c2d1d4c8c8a6a47d916f422ddad2d5497307a147fa860b7b063ffdd162939"; \
+        DART_SHA256="fd4fcc05f1d1c82fd618b83c7d877968460c5bd425774d89add438be12a20795"; \
         SDK_ARCH="arm64";; \
       amd64_dev) \
-        DART_SHA256="53368087f4c191d8b55338d13c32a70bf6cbfb0a99b6b4d86e53cb366bfce446"; \
+        DART_SHA256="7d56e46c81b06d35d52070f25bd7f5845659ac9a0e9fd679c8b1a31da0fc284e"; \
         SDK_ARCH="x64";; \
       arm64_dev) \
-        DART_SHA256="474a251dfa7f6ba41f68d889b774569c4d2da5b4262f0c48fa53424e5b42f200"; \
+        DART_SHA256="307d5368a0d4c6e2376a7cc04f48a7d6e4773792fe4a47e97cdb48c06cd3e71b"; \
         SDK_ARCH="arm64";; \
     esac; \
     SDK="dartsdk-linux-${SDK_ARCH}-release.zip"; \

Makefile

@@ -15,7 +15,7 @@ BUILD_CONFIGS ?= _config.yml
 BUILD_NAME ?= dart_dev_build
 BUILD_TAG ?= dart-dev
 BUILD_TARGET ?= build
-DART_CHANNEL ?= stable
+DART_CHANNEL ?= beta
 DART_VERSION ?= latest
 FIREBASE_PROJECT ?= default
 FIREBASE_CHANNEL ?= dart
@@ -158,4 +158,4 @@ test-builds:
 # Test stable run with volume
 TEST_CHANNEL =? stable
 test-run:
-	docker run --rm -it -v ${PWD}:/app ${BUILD_TAG}:${TEST_CHANNEL} bash
+	docker run --rm -it -v ${PWD}:/app ${BUILD_TAG}:${TEST_CHANNEL} bash

examples/analysis/pubspec.yaml

@@ -2,7 +2,7 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
   examples_util: {path: ../util}

examples/analysis_alt/pubspec.yaml

@@ -2,7 +2,7 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   lints: ^2.1.0

examples/async_await/pubspec.yaml

@@ -2,11 +2,11 @@ name: async_await
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
   examples_util: {path: ../util}
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/build_runner_usage/pubspec.yaml

@@ -2,10 +2,10 @@ name: build_runner_usage
 description: dart.dev build_runner example code.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   args: ^2.4.0
-  build_runner: ^2.4.1
-  build_test: ^2.1.7
+  build_runner: ^2.4.6
+  build_test: ^2.2.0
   lints: ^2.1.0

examples/concurrency/pubspec.yaml

@@ -4,8 +4,8 @@ version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/create_libraries/pubspec.yaml

@@ -3,8 +3,8 @@ description: dart.dev example code.
 version: 1.0.0
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/extension_methods/pubspec.yaml

@@ -3,8 +3,8 @@ description: dart.dev example code.
 version: 1.0.0
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/fetch_data/pubspec.yaml

@@ -3,10 +3,10 @@ description: Fetch data example
 version: 0.0.1
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
-  http: ^0.13.5
+  http: ^1.1.0
 
 dev_dependencies:
   lints: ^2.1.0

examples/futures/pubspec.yaml

@@ -4,11 +4,11 @@ version: 0.0.1
 publish_to: none
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
   examples_util: {path: ../util}
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/html/pubspec.yaml

@@ -3,12 +3,9 @@ description: dart.dev example code.
 version: 0.0.1
 
 environment:
-  sdk: ^3.0.0
-
-dependencies:
-  html: any
+  sdk: ^3.1.0
 
 dev_dependencies:
-  test: ^1.24.2
   lints: ^2.1.0
+  test: ^1.24.6
   examples_util: {path: ../util}

examples/iterables/pubspec.yaml

@@ -2,9 +2,9 @@ name: iterables_examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   examples_util: {path: ../util}
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/language/pubspec.yaml

@@ -2,11 +2,11 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
   examples_util: { path: ../util }
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/misc/pubspec.yaml

@@ -2,13 +2,13 @@ name: examples
 description: dart.dev example code.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
-  args: ^2.3.0
-  characters: ^1.2.1
+  args: ^2.4.2
+  characters: ^1.3.0
   examples_util: { path: ../util }
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/non_promotion/pubspec.yaml

@@ -3,7 +3,7 @@ description: dart.dev non-promotion examples.
 version: 0.0.1
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   lints: ^2.1.0

examples/null_safety_codelab/pubspec.yaml

@@ -2,9 +2,9 @@ name: null_safety_codelab_examples
 description: dart.dev example code for null safety codelab
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dev_dependencies:
   examples_util: {path: ../util}
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/type_system/pubspec.yaml

@@ -2,11 +2,11 @@ name: type_system_examples
 description: dart.dev type system examples.
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
   examples_util: {path: ../util}
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6

examples/util/pubspec.yaml

@@ -3,10 +3,10 @@ description: dart.dev example utilities.
 version: 0.0.2
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 dependencies:
-  test: ^1.24.2
+  test: ^1.24.6
 
 dev_dependencies:
   lints: ^2.1.0

examples/vector_victor/pubspec.yaml

@@ -4,14 +4,14 @@ version: 1.0.0
 # homepage: https://www.example.com
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 # dependencies:
 #   path: ^1.8.0
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6
 
 dependencies:
   vector_math: ^2.1.4

pubspec.yaml

@@ -4,10 +4,10 @@ publish_to: none
 homepage: https://dart.dev
 
 environment:
-  sdk: ^3.0.1
+  sdk: ^3.1.0
 
 dev_dependencies:
-  build_runner: ^2.4.4
+  build_runner: ^2.4.6
   code_excerpt_updater:
     path: site-shared/packages/code_excerpt_updater
   code_excerpter:

src/_data/linter_rules.json

@@ -365,7 +365,7 @@
     "sets": [],
     "fixStatus": "needsEvaluation",
     "details": "**DON'T** assign a variable to itself. Usually this is a mistake.\n\n**BAD:**\n```dart\nclass C {\n  int x;\n\n  C(int x) {\n    x = x;\n  }\n}\n```\n\n**GOOD:**\n```dart\nclass C {\n  int x;\n\n  C(int x) : x = x;\n}\n```\n\n**GOOD:**\n```dart\nclass C {\n  int x;\n\n  C(int x) {\n    this.x = x;\n  }\n}\n```\n\n**BAD:**\n```dart\nclass C {\n  int _x = 5;\n\n  int get x => _x;\n\n  set x(int x) {\n    _x = x;\n    _customUpdateLogic();\n  }\n\n  void _customUpdateLogic() {\n    print('updated');\n  }\n\n  void example() {\n    x = x;\n  }\n}\n```\n\n**GOOD:**\n```dart\nclass C {\n  int _x = 5;\n\n  int get x => _x;\n\n  set x(int x) {\n    _x = x;\n    _customUpdateLogic();\n  }\n\n  void _customUpdateLogic() {\n    print('updated');\n  }\n\n  void example() {\n    _customUpdateLogic();\n  }\n}\n```\n\n**BAD:**\n```dart\nclass C {\n  int x = 5;\n\n  void update(C other) {\n    this.x = this.x;\n  }\n}\n```\n\n**GOOD:**\n```dart\nclass C {\n  int x = 5;\n\n  void update(C other) {\n    this.x = other.x;\n  }\n}\n```\n\n",
-    "sinceDartSdk": "3.1.0-wip"
+    "sinceDartSdk": "3.1.0"
   },
   {
     "name": "no_wildcard_variable_uses",
@@ -376,7 +376,7 @@
     "sets": [],
     "fixStatus": "needsEvaluation",
     "details": "**DON'T** use wildcard parameters or variables.\n\nWildcard parameters and local variables\n(e.g. underscore-only names like `_`, `__`, `___`, etc.) will\nbecome non-binding in a future version of the Dart language.\nAny existing code that uses wildcard parameters or variables will\nbreak. In anticipation of this change, and to make adoption easier,\nthis lint disallows wildcard and variable parameter uses.\n\n\n**BAD:**\n```dart\nvar _ = 1;\nprint(_); // LINT\n```\n\n```dart\nvoid f(int __) {\n  print(__); // LINT multiple underscores too\n}\n```\n\n**GOOD:**\n```dart\nfor (var _ in [1, 2, 3]) count++;\n```\n\n```dart\nvar [a, _, b, _] = [1, 2, 3, 4];\n```\n",
-    "sinceDartSdk": "3.1.0-wip"
+    "sinceDartSdk": "3.1.0"
   },
   {
     "name": "prefer_relative_imports",
@@ -2828,4 +2828,4 @@
     "details": "**DON'T** assign to void.\n\n**BAD:**\n```dart\nclass A<T> {\n  T value;\n  void test(T arg) { }\n}\n\nvoid main() {\n  A<void> a = A<void>();\n  a.value = 1; // LINT\n  a.test(1); // LINT\n}\n```\n",
     "sinceDartSdk": "2.0.0"
   }
-]
+]

src/_data/pkg-vers.json

@@ -3,6 +3,6 @@
     "doc-path": "install",
     "channel": "stable",
     "prev-vers": "2.19.6",
-    "vers": "3.0.7"
+    "vers": "3.1.0"
   }
 }

src/_tutorials/libraries/shared-pkgs.md

@@ -86,14 +86,14 @@ version: 1.0.0
 # homepage: https://www.example.com
 
 environment:
-  sdk: ^3.0.0
+  sdk: ^3.1.0
 
 # dependencies:
 #   path: ^1.8.0
 
 dev_dependencies:
   lints: ^2.1.0
-  test: ^1.24.2
+  test: ^1.24.6
 ```
 
 ## Name the package dependencies

src/tools/build_runner.md

@@ -38,8 +38,8 @@ to your app's pubspec:
 ```yaml
 dev_dependencies:
   # ···
-  build_runner: ^2.4.1
-  build_test: ^2.1.7
+  build_runner: ^2.4.6
+  build_test: ^2.2.0
 ```
 
 Depending on **build_test** is optional; do it if you'll be testing your code.