Use the precompiled dartdoc with pana in the pub_worker. (dart-lang#9176)

Author: isoos

CHANGELOG.md

@@ -4,6 +4,7 @@ AppEngine version, listed here to ease deployment and troubleshooting.
 ## Next Release (replace with git tag when deployed)
  * Bump runtimeVersion to `2026.01.20`.
  * Upgraded pana to `0.23.8`.
+ * Note: workers use AOT compiled `dartdoc` and `pub_worker`.
 
 ## `20260115t114900-all`
  * Bump runtimeVersion to `2026.01.13`.

Dockerfile.worker

@@ -45,7 +45,10 @@ ENV FLUTTER_ROOT="/home/worker/flutter/stable"
 ENV PATH="/home/worker/bin:/home/worker/dart/stable/bin:${PATH}"
 
 # Setup dartdoc
-RUN tool/setup-dartdoc.sh /home/worker/bin/dartdoc 9.0.1
+ENV DARTDOC_DIR=/home/worker/dartdoc
+RUN tool/setup-dartdoc.sh "${DARTDOC_DIR}" 9.0.1
+ENV DARTDOC_BINARY="${DARTDOC_DIR}/build/dartdoc"
+ENV DARTDOC_RESOURCES_DIR="${DARTDOC_DIR}/lib/resources"
 
 # Install dependencies for pub_worker
 WORKDIR /home/worker/pub-dev/pkg/pub_worker

app/test/shared/versions_test.dart

@@ -159,9 +159,7 @@ and do not format to also bump the runtimeVersion.''',
     final content = await File('../Dockerfile.worker').readAsString();
     expect(
       content,
-      contains(
-        'RUN tool/setup-dartdoc.sh /home/worker/bin/dartdoc $dartdocVersion\n',
-      ),
+      contains('RUN tool/setup-dartdoc.sh "\${DARTDOC_DIR}" $dartdocVersion\n'),
     );
   });
 

pkg/pub_worker/bin/pub_worker_subprocess.dart

@@ -98,6 +98,12 @@ Future<void> main(List<String> args) async {
   final pkgDir = Directory(p.join(pkgDownloadDir.path, '$package-$version'));
   final detected = await _detectSdks(pkgDir.path);
 
+  final dartdocBinary = Platform.environment['DARTDOC_BINARY'];
+  final dartdocResourcesDir = Platform.environment['DARTDOC_RESOURCES_DIR'];
+  final dartdocCommand = (dartdocBinary != null && dartdocResourcesDir != null)
+      ? <String>[dartdocBinary, '--resources-dir', dartdocResourcesDir]
+      : null;
+
   final toolEnv = await ToolEnvironment.create(
     dartSdkConfig: SdkConfig(
       rootPath: detected.dartSdkPath,
@@ -108,6 +114,7 @@ Future<void> main(List<String> args) async {
       configHomePath: _configHomePath('flutter', detected.configKind),
     ),
     pubCacheDir: pubCache,
+    dartdocCommand: dartdocCommand,
     dartdocVersion: _dartdocVersion,
   );
 

tool/setup-dartdoc.sh

@@ -5,7 +5,7 @@
 
 set -e
 
-TARGET_PATH=$1
+TARGET_DIR=$1
 DARTDOC_VERSION=$2
 
 # Create a temporary directory
@@ -20,5 +20,7 @@ trap 'rm -rf "$WORK_DIR"' EXIT
 dart pub unpack "dartdoc:${DARTDOC_VERSION}" --output=${WORK_DIR}
 
 # Compile executable
-cd "${WORK_DIR}/dartdoc-${DARTDOC_VERSION}"
-dart compile exe -o "${TARGET_PATH}" bin/dartdoc.dart
+mv "${WORK_DIR}/dartdoc-${DARTDOC_VERSION}" "${TARGET_DIR}"
+cd "${TARGET_DIR}"
+mkdir build
+dart compile exe -o build/dartdoc bin/dartdoc.dart