Error when launching via `dart pub global run flutterpi_tool ...`

[ardera]

$ flutter pub global activate flutterpi_tool
... works

$ dart pub global run flutterpi_tool build
FINE: Pub 3.5.0
  ERR : flutterpi_tool as globally activated requires the Flutter SDK, which is unsupported for global executables.
  FINE: Exception type: DataException
  FINE: package:pub/src/utils.dart 583:36                     dataError
      | package:pub/src/global_packages.dart 420:9            GlobalPackages.find.<fn>
      | dart:collection                                       _LinkedHashMapMixin.forEach
      | package:pub/src/global_packages.dart 404:29           GlobalPackages.find
      | package:pub/src/command/global_run.dart 76:[44](https://github.com/ardera/flutter-ci/actions/runs/10331155907/job/28601507719#step:14:46)         GlobalRunCommand.runProtected
      | package:pub/src/command.dart 197:21                   PubCommand.run.<fn>
      | dart:async                                            new Future.sync
      | package:pub/src/utils.dart 137:12                     captureErrors.wrappedCallback
      | package:stack_trace                                   Chain.capture
      | package:pub/src/utils.dart 154:11                     captureErrors
      | package:pub/src/command.dart 196:13                   PubCommand.run
      | package:args/command_runner.dart 212:27               CommandRunner.runCommand
      | package:dartdev/dartdev.dart 236:30                   DartdevRunner.runCommand
      | package:args/command_runner.dart 122:25               CommandRunner.run.<fn>
      | dart:async                                            new Future.sync
      | package:args/command_runner.dart 122:14               CommandRunner.run
      | package:dartdev/dartdev.dart [47](https://github.com/ardera/flutter-ci/actions/runs/10331155907/job/28601507719#step:14:49):29                    runDartdev
      | /b/s/w/ir/x/w/sdk/pkg/dartdev/bin/dartdev.dart 13:11  main
      | ===== asynchronous gap ===========================
      | dart:async                                            Future.catchError
      | package:pub/src/utils.dart 139:10                     captureErrors.wrappedCallback
      | package:stack_trace                                   Chain.capture
      | package:pub/src/utils.dart 1[54](https://github.com/ardera/flutter-ci/actions/runs/10331155907/job/28601507719#step:14:56):11                     captureErrors
      | package:pub/src/command.dart 196:13                   PubCommand.run
      | package:args/command_runner.dart 212:27               CommandRunner.runCommand
      | package:dartdev/dartdev.dart 236:30                   DartdevRunner.runCommand
      | package:args/command_runner.dart 122:25               CommandRunner.run.<fn>
      | dart:async                                            new Future.sync
      | package:args/command_runner.dart 122:14               CommandRunner.run
      | package:dartdev/dartdev.dart 47:29                    runDartdev
      | /b/s/w/ir/x/w/sdk/pkg/dartdev/bin/dartdev.dart 13:11  main
  ---- Log transcript ----
  FINE: Pub 3.5.0
  ERR : flutterpi_tool as globally activated requires the Flutter SDK, which is unsupported for global executables.
  FINE: Exception type: DataException
  FINE: package:pub/src/utils.dart [58](https://github.com/ardera/flutter-ci/actions/runs/10331155907/job/28601507719#step:14:60)3:36                     dataError
      | package:pub/src/global_packages.dart 420:9            GlobalPackages.find.<fn>
      | dart:collection                                       _LinkedHashMapMixin.forEach
      | package:pub/src/global_packages.dart 404:29           GlobalPackages.find
      | package:pub/src/command/global_run.dart 76:44         GlobalRunCommand.runProtected
      | package:pub/src/command.dart 197:21                   PubCommand.run.<fn>
      | dart:async                                            new Future.sync
      | package:pub/src/utils.dart 137:12                     captureErrors.wrappedCallback
      | package:stack_trace                                   Chain.capture
      | package:pub/src/utils.dart 154:11                     captureErrors
      | package:pub/src/command.dart 196:13                   PubCommand.run
      | package:args/command_runner.dart 212:27               CommandRunner.runCommand
      | package:dartdev/dartdev.dart 236:30                   DartdevRunner.runCommand
      | package:args/command_runner.dart 122:25               CommandRunner.run.<fn>
      | dart:async                                            new Future.sync
      | package:args/command_runner.dart 122:14               CommandRunner.run
      | package:dartdev/dartdev.dart 47:29                    runDartdev
      | /b/s/w/ir/x/w/sdk/pkg/dartdev/bin/dartdev.dart 13:11  main
      | ===== asynchronous gap ===========================
      | dart:async                                            Future.catchError
      | package:pub/src/utils.dart 139:10                     captureErrors.wrappedCallback
      | package:stack_trace                                   Chain.capture
      | package:pub/src/utils.dart 154:11                     captureErrors
      | package:pub/src/command.dart 196:13                   PubCommand.run
      | package:args/command_runner.dart 212:27               CommandRunner.runCommand
      | package:dartdev/dartdev.dart 236:30                   DartdevRunner.runCommand
      | package:args/command_runner.dart 122:25               CommandRunner.run.<fn>
      | dart:async                                            new Future.sync
      | package:args/command_runner.dart 122:14               CommandRunner.run
      | package:dartdev/dartdev.dart 47:29                    runDartdev
      | /b/s/w/ir/x/w/sdk/pkg/dartdev/bin/dartdev.dart 13:11  main
  ---- End log transcript ----
  IO  : Writing 12421 characters to text file /home/runner/.pub-cache/log/pub_log.txt.
  MSG : Logs written to /home/runner/.pub-cache/log/pub_log.txt.

When launching with dart pub global run ..., pub checks that the launched package does not have an SDK constraint on any SDK other than dart: https://github.com/dart-lang/pub/blob/ea4a1c854690d3abceb92c8cc2c6454470f9d5a7/lib/src/global_packages.dart#L403-L423 (pub for dart 3.5.0)

We have an additional constraint on Flutter here:

flutterpi_tool/pubspec.yaml

Line 8 in 5953bc4

flutter: ">=3.22.0"

The SDK constraint is not strictly necessary in the case of flutterpi_tool, we only technically need the flutter_tools dependency, but the flutter SDK constraint helps with version solving.

Recommended way to launch is to add the system bin dir to PATH and launch directly by just executing flutterpi_tool.