From 2ecc1b2c7c3c36563ea6e65b5ed1e02c59f1e245 Mon Sep 17 00:00:00 2001 From: Lewin Pauli Date: Fri, 13 Nov 2026 22:28:33 +0100 Subject: [PATCH 1/2] fix(cli): use the precompiled DDC SDK from kernel/ddc/canary on Flutter 3.50 --- packages/jaspr/CHANGELOG.md | 1 + .../lib/src/commands/dev_command.dart | 6 +- .../jaspr_cli/lib/src/dev/flutter_runner.dart | 19 +++++ .../test/src/commands/serve_command_test.dart | 71 +++++++++++++++++++ 4 files changed, 95 insertions(+), 2 deletions(-) diff --git a/packages/jaspr/CHANGELOG.md b/packages/jaspr/CHANGELOG.md index a8c461ca3..34681e4cf 100644 --- a/packages/jaspr/CHANGELOG.md +++ b/packages/jaspr/CHANGELOG.md @@ -14,6 +14,7 @@ - Fixed HTML duplication after hot-reload in client mode. - Fixed hot-reload losing changes when a new build starts before the previous reload has finished. - Fixed `jaspr serve` blocking all following reloads when a connected browser stops responding (e.g. a phone with the screen turned off). +- Fixed `jaspr serve` with Flutter embedding or plugins failing on Flutter 3.50, which moved the precompiled DDC SDK to `kernel/ddc/canary`. - Fixed styles hot-reload recompiling all dependencies on every change on Windows. - Fixed key shortcuts in `jaspr serve` not working on Windows. diff --git a/packages/jaspr_cli/lib/src/commands/dev_command.dart b/packages/jaspr_cli/lib/src/commands/dev_command.dart index fa04b5f3d..48fa9e4a4 100644 --- a/packages/jaspr_cli/lib/src/commands/dev_command.dart +++ b/packages/jaspr_cli/lib/src/commands/dev_command.dart @@ -619,8 +619,10 @@ abstract class DevCommand extends BaseCommand with ProxyHelper { List additionalFlutterBuildArgs() { final sdkKernelPath = p.url.join('kernel', 'ddc_outline.dill'); final librariesPath = p.join(FlutterRunner.webSdkDir, 'libraries.json'); - final ddcSdkPrefix = usesDdcLibraryBundles ? 'ddcLibraryBundle-canvaskit' : 'amd-canvaskit'; - final sdkJsPath = p.join(FlutterRunner.webSdkDir, 'kernel', ddcSdkPrefix); + final sdkJsPath = FlutterRunner.precompiledDdcSdkDir( + FlutterRunner.webSdkDir, + ddcLibraryBundle: usesDdcLibraryBundles, + ); return [ '--define=build_web_compilers:entrypoint=use-ui-libraries=true', '--define=build_web_compilers:entrypoint_marker=use-ui-libraries=true', diff --git a/packages/jaspr_cli/lib/src/dev/flutter_runner.dart b/packages/jaspr_cli/lib/src/dev/flutter_runner.dart index 6aaa21bf6..b1ae7f624 100644 --- a/packages/jaspr_cli/lib/src/dev/flutter_runner.dart +++ b/packages/jaspr_cli/lib/src/dev/flutter_runner.dart @@ -187,4 +187,23 @@ class FlutterRunner { } return webSdkPath; })(); + + /// The folder in [webSdkDir] with the precompiled DDC SDK (`dart_sdk.js`) + /// for the DDC library bundle or the AMD module format. + /// + /// Flutter 3.50 moved it from `kernel/ddcLibraryBundle-canvaskit` and + /// `kernel/amd-canvaskit` to `kernel/ddc/canary` and `kernel/ddc/stable`, and + /// no longer ships an AMD build. `build_web_compilers` compiles DDC library + /// bundles with `--canary`, which matches `kernel/ddc/canary`. Older Flutter + /// versions keep using their folders. + static String precompiledDdcSdkDir(String webSdkDir, {required bool ddcLibraryBundle}) { + if (ddcLibraryBundle) { + final canaryDir = p.join(webSdkDir, 'kernel', 'ddc', 'canary'); + if (Directory(canaryDir).existsSync()) { + return canaryDir; + } + return p.join(webSdkDir, 'kernel', 'ddcLibraryBundle-canvaskit'); + } + return p.join(webSdkDir, 'kernel', 'amd-canvaskit'); + } } diff --git a/packages/jaspr_cli/test/src/commands/serve_command_test.dart b/packages/jaspr_cli/test/src/commands/serve_command_test.dart index 48a4f8229..0c305b26f 100644 --- a/packages/jaspr_cli/test/src/commands/serve_command_test.dart +++ b/packages/jaspr_cli/test/src/commands/serve_command_test.dart @@ -739,6 +739,77 @@ void main() { }); }); + // https://github.com/schultek/jaspr/issues/999 + test('uses the precompiled DDC SDK from kernel/ddc/canary on Flutter 3.50 and later', () async { + await io.runZoned(() async { + io.setupFakeProject('myapp', mode: 'server', flutterEmbedding: true); + io.stubDartSDK(); + io.stubFlutterSDK(); + // Flutter 3.50 ships the precompiled SDKs in kernel/ddc/{stable,canary} + // instead of kernel/{ddcLibraryBundle,amd}-canvaskit. + io.fs.file('/fake/flutter/bin/cache/flutter_web_sdk/kernel/ddc/canary/dart_sdk.js').createSync(recursive: true); + io.fs.file('/fake/flutter/bin/cache/flutter_web_sdk/kernel/ddc/stable/dart_sdk.js').createSync(recursive: true); + + final buildDaemon = io.setupFakeBuildDaemon( + verifyArgs: [ + for (final arg in buildRunnerFlutterArgs) + arg.replaceFirst('kernel/ddcLibraryBundle-canvaskit', 'kernel/ddc/canary'), + ], + ); + final server = io.stubFakeServer(); + + FakeProcess? flutterProcess; + when( + () => io.process.start( + 'flutter', + [ + 'run', + '--device-id=web-server', + '-t', + '.dart_tool/jaspr/flutter_target.dart', + '--web-port=$flutterProxyPort', + ], + workingDirectory: '/root/myapp', + runInShell: true, + ), + ).thenAnswer((_) async => flutterProcess = FakeProcess()); + + final serveResult = runner.run(['serve', '--verbose']); + + await expectLater( + io.stdout.queue, + emitsInOrderWithTimeout([ + 'Starting myapp in server rendering mode.', + '[BUILDER] Starting web compilers...', + '[BUILDER] Connecting to the build daemon...', + '[BUILDER] Starting initial build...', + ]), + ); + + await io.runInitialBuild(buildDaemon); + + expect(io.stdout.queue, emits('[BUILDER] Done building web assets.')); + + await io.connectToProxy(); + + expect(flutterProcess, isNotNull); + + await io.expectServerStarted(server); + + server.exit(0); + + expect( + io.stdout.queue, + emitsInOrderWithTimeout([ + 'Stopping web compilers...', + 'Stopping flutter run...', + ]), + ); + + expect(await serveResult, equals(0)); + }); + }); + test('serves project with automatic port fallback when default port is in use', () async { await io.runZoned(() async { io.setupFakeProject('myapp', mode: 'client'); From 019dba127db67db7a8100fea6ed4ffb34fb652b9 Mon Sep 17 00:00:00 2001 From: Lewin Pauli Date: Tue, 17 Nov 2026 14:24:45 +0100 Subject: [PATCH 2/2] fix(cli): use kernel/ddc/stable for the build command on Flutter 3.50, move the changelog entry to 0.24.0-beta.2 --- packages/jaspr/CHANGELOG.md | 5 +- .../lib/src/commands/build_command.dart | 2 +- .../jaspr_cli/lib/src/dev/flutter_runner.dart | 19 ++++---- .../test/src/commands/build_command_test.dart | 47 +++++++++++++++++++ 4 files changed, 62 insertions(+), 11 deletions(-) diff --git a/packages/jaspr/CHANGELOG.md b/packages/jaspr/CHANGELOG.md index 34681e4cf..ff7e0d6ac 100644 --- a/packages/jaspr/CHANGELOG.md +++ b/packages/jaspr/CHANGELOG.md @@ -1,3 +1,7 @@ +## Unreleased 0.24.0-beta.2 + +- Fixed `jaspr serve` with Flutter embedding or plugins failing on Flutter 3.50, which moved the precompiled DDC SDK to `kernel/ddc/canary` and `kernel/ddc/stable`. + ## 0.24.0-beta.1 ### New Features and Improvements @@ -14,7 +18,6 @@ - Fixed HTML duplication after hot-reload in client mode. - Fixed hot-reload losing changes when a new build starts before the previous reload has finished. - Fixed `jaspr serve` blocking all following reloads when a connected browser stops responding (e.g. a phone with the screen turned off). -- Fixed `jaspr serve` with Flutter embedding or plugins failing on Flutter 3.50, which moved the precompiled DDC SDK to `kernel/ddc/canary`. - Fixed styles hot-reload recompiling all dependencies on every change on Windows. - Fixed key shortcuts in `jaspr serve` not working on Windows. diff --git a/packages/jaspr_cli/lib/src/commands/build_command.dart b/packages/jaspr_cli/lib/src/commands/build_command.dart index 1ff5fd057..00b74582a 100644 --- a/packages/jaspr_cli/lib/src/commands/build_command.dart +++ b/packages/jaspr_cli/lib/src/commands/build_command.dart @@ -492,7 +492,7 @@ class BuildCommand extends BaseCommand with ProxyHelper { List additionalFlutterBuildArgs() { final librariesPath = p.join(FlutterRunner.webSdkDir, 'libraries.json'); - final sdkJsPath = p.join(FlutterRunner.webSdkDir, 'kernel', 'amd-canvaskit'); + final sdkJsPath = FlutterRunner.precompiledDdcSdkDir(FlutterRunner.webSdkDir, ddcLibraryBundle: false); return [ '--define=build_web_compilers:entrypoint=use-ui-libraries=true', '--define=build_web_compilers:entrypoint_marker=use-ui-libraries=true', diff --git a/packages/jaspr_cli/lib/src/dev/flutter_runner.dart b/packages/jaspr_cli/lib/src/dev/flutter_runner.dart index b1ae7f624..f7f7c3483 100644 --- a/packages/jaspr_cli/lib/src/dev/flutter_runner.dart +++ b/packages/jaspr_cli/lib/src/dev/flutter_runner.dart @@ -194,16 +194,17 @@ class FlutterRunner { /// Flutter 3.50 moved it from `kernel/ddcLibraryBundle-canvaskit` and /// `kernel/amd-canvaskit` to `kernel/ddc/canary` and `kernel/ddc/stable`, and /// no longer ships an AMD build. `build_web_compilers` compiles DDC library - /// bundles with `--canary`, which matches `kernel/ddc/canary`. Older Flutter - /// versions keep using their folders. + /// bundles with `--canary`, which matches `kernel/ddc/canary`. Otherwise it + /// compiles without `--canary`, which matches `kernel/ddc/stable`. Older + /// Flutter versions keep using their folders. static String precompiledDdcSdkDir(String webSdkDir, {required bool ddcLibraryBundle}) { - if (ddcLibraryBundle) { - final canaryDir = p.join(webSdkDir, 'kernel', 'ddc', 'canary'); - if (Directory(canaryDir).existsSync()) { - return canaryDir; - } - return p.join(webSdkDir, 'kernel', 'ddcLibraryBundle-canvaskit'); + final (ddcDir, legacyDir) = ddcLibraryBundle + ? ('canary', 'ddcLibraryBundle-canvaskit') + : ('stable', 'amd-canvaskit'); + final dir = p.join(webSdkDir, 'kernel', 'ddc', ddcDir); + if (Directory(dir).existsSync()) { + return dir; } - return p.join(webSdkDir, 'kernel', 'amd-canvaskit'); + return p.join(webSdkDir, 'kernel', legacyDir); } } diff --git a/packages/jaspr_cli/test/src/commands/build_command_test.dart b/packages/jaspr_cli/test/src/commands/build_command_test.dart index eff21905f..acaa51519 100644 --- a/packages/jaspr_cli/test/src/commands/build_command_test.dart +++ b/packages/jaspr_cli/test/src/commands/build_command_test.dart @@ -349,6 +349,53 @@ void main() { }); }); + // https://github.com/schultek/jaspr/issues/999 + test('uses the precompiled DDC SDK from kernel/ddc/stable on Flutter 3.50 and later', () async { + await io.runZoned(() async { + io.setupFakeProject('myapp', mode: 'client', flutterEmbedding: true); + io.stubDartSDK(); + io.stubFlutterSDK(); + // Flutter 3.50 ships the precompiled SDKs in kernel/ddc/{stable,canary} + // instead of kernel/{amd,ddcLibraryBundle}-canvaskit. + io.fs.file('/fake/flutter/bin/cache/flutter_web_sdk/kernel/ddc/canary/dart_sdk.js').createSync(recursive: true); + io.fs.file('/fake/flutter/bin/cache/flutter_web_sdk/kernel/ddc/stable/dart_sdk.js').createSync(recursive: true); + + final buildDaemon = io.setupFakeBuildDaemon( + verifyArgs: [ + for (final arg in buildRunnerFlutterBuildArgs) + arg.replaceFirst('kernel/amd-canvaskit', 'kernel/ddc/stable'), + ], + ); + + final buildResult = runner.run(['build', '--verbose']); + + await expectLater(io.stdout.queue, emits('Building myapp in client rendering mode.')); + + when( + () => io.process.start( + 'flutter', + [ + 'build', + 'web', + '-t', + '.dart_tool/jaspr/flutter_target.dart', + '--no-wasm-dry-run', + '--no-tree-shake-icons', + '--output=build/flutter', + ], + workingDirectory: '/root/myapp', + runInShell: true, + ), + ).thenAnswer((_) async => FakeProcess.sync()); + + await io.runReleaseBuild(buildDaemon); + + await expectLater(io.stdout.queue, emitsThrough(contains('Completed building'))); + + expect(await buildResult, equals(0)); + }); + }); + test('builds project with flutter embedding', () async { await io.runZoned(() async { io.setupFakeProject('myapp', mode: 'client', flutterEmbedding: true);