Upgrade analysis SDKs, dartdoc and pana.

Author: isoos

CHANGELOG.md

@@ -2,8 +2,12 @@ Important changes to data models, configuration, and migrations between each
 AppEngine version, listed here to ease deployment and troubleshooting.
 
 ## Next Release (replace with git tag when deployed)
- * Bump runtimeVersion to `2024.11.26`.
- * `dartdoc 8.3.0` is used for packages depending on `package:macros`. 
+ * Bump runtimeVersion to `2024.12.01`.
+ * Upgraded stable Dart analysis SDK to `3.6.0-334.4.beta`
+ * Upgraded stable Flutter analysis SDK to `3.27.0-0.2.pre`.
+ * Upgraded dartdoc to `8.3.0`.
+ * Upgraded pana to `0.22.16`.
+ * Upgraded dependencies.
 
 ## `20241121t150900-all`
  * Bump runtimeVersion to `2024.11.21`.

Dockerfile.worker

@@ -23,10 +23,10 @@ RUN mkdir -p /home/worker/config/dart-stable
 RUN mkdir -p /home/worker/config/flutter-stable
 
 # Setup Dart SDK into /home/worker/dart/{stable,preview}/
-RUN XDG_CONFIG_HOME=/home/worker/config/dart-stable tool/setup-dart.sh /home/worker/dart/stable 3.5.4
+RUN XDG_CONFIG_HOME=/home/worker/config/dart-stable tool/setup-dart.sh /home/worker/dart/stable 3.6.0-334.4.beta beta
 
 # Setup Flutter SDK into /home/worker/flutter/{stable,preview}/
-RUN XDG_CONFIG_HOME=/home/worker/config/flutter-stable tool/setup-flutter.sh /home/worker/flutter/stable 3.24.5
+RUN XDG_CONFIG_HOME=/home/worker/config/flutter-stable tool/setup-flutter.sh /home/worker/flutter/stable 3.27.0-0.2.pre beta
 
 # Setup webp
 RUN tool/setup-webp.sh /home/worker/bin

app/lib/shared/versions.dart

@@ -24,7 +24,7 @@ final RegExp runtimeVersionPattern = RegExp(r'^\d{4}\.\d{2}\.\d{2}$');
 /// when the version switch happens.
 const _acceptedRuntimeVersions = <String>[
   // The current [runtimeVersion].
-  '2024.11.26',
+  '2024.12.01',
   // Fallback runtime versions.
   '2024.11.21',
   '2024.11.18',
@@ -62,8 +62,8 @@ bool shouldGCVersion(String version) =>
 
 // keep in-sync with SDK version in .mono_repo.yml and Dockerfile
 final String runtimeSdkVersion = '3.5.0';
-final String toolStableDartSdkVersion = '3.5.4';
-final String toolStableFlutterSdkVersion = '3.24.5';
+final String toolStableDartSdkVersion = '3.6.0-334.4.beta';
+final String toolStableFlutterSdkVersion = '3.27.0-0.2.pre';
 
 final semanticToolStableDartSdkVersion =
     Version.parse(toolStableDartSdkVersion);
@@ -74,4 +74,4 @@ final semanticToolStableFlutterSdkVersion =
 final String panaVersion = pana.packageVersion;
 
 // keep in-sync with pkg/pub-worker/lib/src/bin/pana_wrapper.dart
-final String dartdocVersion = '8.1.0';
+final String dartdocVersion = '8.3.0';

app/pubspec.yaml

@@ -47,7 +47,7 @@ dependencies:
   watcher: ^1.0.0
   yaml: ^3.1.0
   # pana version to be pinned
-  pana: '0.22.15'
+  pana: '0.22.16'
   # 3rd-party packages with pinned versions
   mailer: '6.2.0'
   ulid: '2.0.1'

pkg/pub_worker/lib/src/bin/pana_wrapper.dart

@@ -34,7 +34,7 @@ const _totalTimeout = Duration(minutes: 50);
 
 /// The dartdoc version to use.
 /// keep in-sync with app/lib/shared/versions.dart
-const _dartdocVersion = '8.1.0';
+const _dartdocVersion = '8.3.0';
 
 /// Program to be used as subprocess for running pana, ensuring that we capture
 /// all the output, and only run analysis in a subprocess that can timeout and
@@ -99,8 +99,10 @@ Future<void> main(List<String> args) async {
   final pkgDir = Directory(p.join(pkgDownloadDir.path, '$package-$version'));
   final detected = await _detectSdks(pkgDir.path);
 
+  // Fallback for CI tests.
+  // TODO: remove after runtime SDK is migrated to 3.6 SDK
   final dartdocVersion =
-      (await _overrideDartdocVersion(pkgDir.path)) ?? _dartdocVersion;
+      Platform.version.startsWith('3.5.') ? '8.1.0' : _dartdocVersion;
 
   final toolEnv = await ToolEnvironment.create(
     dartSdkConfig: SdkConfig(
@@ -194,21 +196,6 @@ String? _configHomePath(String sdk, String kind) {
   return path;
 }
 
-/// Detects the package dependencies and overrides the dartdoc version to
-/// 8.3.0 if macros is being used.
-///
-/// TODO: remove this after the 3.6 SDK is released.
-Future<String?> _overrideDartdocVersion(String pkgDir) async {
-  final pubspecFile = File(p.join(pkgDir, 'pubspec.yaml'));
-  final pubspec = Pubspec.parseYaml(await pubspecFile.readAsString());
-  final minMacrosVersion = pubspec.getDependencyContraintRangeMin('macros');
-  if (minMacrosVersion != null &&
-      minMacrosVersion.compareTo(Version.parse('0.1.3-main.0')) >= 0) {
-    return '8.3.0';
-  }
-  return null;
-}
-
 Future<({String configKind, String? dartSdkPath, String? flutterSdkPath})>
     _detectSdks(String pkgDir) async {
   // Load the pubspec so we detect which SDK to use for analysis

pkg/pub_worker/pubspec.yaml

@@ -10,7 +10,7 @@ dependencies:
   appengine: ^0.13.6
   json_annotation: ^4.3.0
   jsontool: ^2.0.0
-  pana: ^0.22.15
+  pana: ^0.22.16
   path: ^1.8.0
   lints: ^5.0.0 # required for pana
   meta: ^1.7.0