Add documentation for using 'dart-define' with Dart apps

I had trouble using dart-define after following https://dartcode.org/docs/using-dart-define-in-flutter/, not thinking about the fact that my app was a Dart app, not a Flutter app. I got it working in the end with a launch config like this:

{
  "name": "Dart",
  "request": "launch",
  "type": "dart",
  "program": "bin/dart_program.dart",
  "toolArgs": ["-Dkey=blah"]
}

The differences that matter (as I understand) are -D instead of dart-define and using “toolArgs” rather than “args”. I think I understand why in both cases but I found that info with a fair bit of digging. I think it would be helpful to add some documentation for Dart apps like there is for Flutter.

Thanks!

[DanTup]

Thanks - I’ll add a Dart page about this, and link the two together. I think probably toolArgs is the right thing for both now, but I’ll verify that before updating. Thanks!

[nickmeinhold]

Whoops, just checked and regular old dart run --help gives the “Define an environment declaration.” information… I could have sworn I looked in the help 🤦 well I learned about -v anyway so that’s awesome! 🙂