Add VS Code run-and-debug configurations for the Android emulator

F5 now builds, installs and attaches the debugger on the emulator, with the
emulator booted automatically first, so there is no manual setup step between
opening the project and stepping through code.

tool/start_emulator.ps1 backs the preLaunchTask and is idempotent: it returns in
about three seconds when a device is already attached, so re-launching the
debugger cannot stack emulator instances. It fails with a useful message when
the AVD is missing rather than hanging until a timeout.

Five configurations rather than one, because they answer different questions.
The profile-mode entry matters most for what comes next: debug builds run the
Dart VM unoptimised, so the radar animation always looks worse than it is, and
milestone 3's acceptance criterion is about whether it runs smoothly. The
Windows entry trades the map away for a launch that takes seconds, which is
worth it for pure UI work.

Verified on this machine: the script cold-boots the AVD and waits for
sys.boot_completed, and a second run exits immediately.

Also removes the broken pixel_7_-_api_35 AVD, which could not boot because its
system image was never installed. That returned 4.8 GB, taking free disk from
3.5 GB to 10.7 GB.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Nuvolari/.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "dart-code.flutter",
+    "dart-code.dart-code",
+    "ms-vscode.powershell"
+  ]
+}

Nuvolari/.vscode/launch.json

@@ -0,0 +1,75 @@
+{
+  // Debug configurations for the Run and Debug panel (F5).
+  //
+  // Open the "Nuvolari" folder as the VS Code workspace root — these paths are
+  // relative to it, not to the repository root.
+  //
+  // Every configuration boots the Android emulator first via a preLaunchTask,
+  // so F5 works from a cold machine with no manual step. The task returns
+  // immediately if a device is already attached.
+  "version": "0.2.0",
+  "configurations": [
+    {
+      // The everyday one: demo mode, no env.json needed, hot reload on save.
+      "name": "Nuvolari — debug (emulatore)",
+      "type": "dart",
+      "request": "launch",
+      "program": "${workspaceFolder}/app/lib/main.dart",
+      "cwd": "${workspaceFolder}/app",
+      "deviceId": "emulator-5554",
+      "flutterMode": "debug",
+      "preLaunchTask": "Avvia emulatore Android"
+    },
+    {
+      // Debug builds run the Dart VM unoptimised, so animation always looks
+      // worse than it is. Judge the radar timeline here, never in debug.
+      "name": "Nuvolari — profile (misura le prestazioni)",
+      "type": "dart",
+      "request": "launch",
+      "program": "${workspaceFolder}/app/lib/main.dart",
+      "cwd": "${workspaceFolder}/app",
+      "deviceId": "emulator-5554",
+      "flutterMode": "profile",
+      "preLaunchTask": "Avvia emulatore Android"
+    },
+    {
+      // Same as the first, but with real endpoints and keys. Requires env.json,
+      // which is git-ignored — copy env.example.json and fill it in.
+      "name": "Nuvolari — debug con env.json",
+      "type": "dart",
+      "request": "launch",
+      "program": "${workspaceFolder}/app/lib/main.dart",
+      "cwd": "${workspaceFolder}/app",
+      "deviceId": "emulator-5554",
+      "flutterMode": "debug",
+      "toolArgs": ["--dart-define-from-file=${workspaceFolder}/env.json"],
+      "preLaunchTask": "Avvia emulatore Android"
+    },
+    {
+      // Runs on the workstation instead of a device: no emulator, no Android
+      // build, seconds to start. Good for UI work; the native map will not
+      // render here, so it is useless for anything map-related.
+      "name": "Nuvolari — debug su Windows (senza mappa)",
+      "type": "dart",
+      "request": "launch",
+      "program": "${workspaceFolder}/app/lib/main.dart",
+      "cwd": "${workspaceFolder}/app",
+      "deviceId": "windows",
+      "flutterMode": "debug"
+    },
+    {
+      "name": "Test — tutti",
+      "type": "dart",
+      "request": "launch",
+      "program": "${workspaceFolder}/app/test",
+      "cwd": "${workspaceFolder}/app"
+    },
+    {
+      "name": "Test — file corrente",
+      "type": "dart",
+      "request": "launch",
+      "program": "${file}",
+      "cwd": "${workspaceFolder}/app"
+    }
+  ]
+}

Nuvolari/.vscode/settings.json

@@ -0,0 +1,31 @@
+{
+  // Forward slashes on purpose: VS Code accepts them on Windows and they avoid
+  // the JSON backslash-escaping trap.
+  "dart.flutterSdkPath": "C:/src/flutter",
+
+  // Format and fix imports on save; `dart format` is enforced by tool/verify.ps1
+  // anyway, so catching it here avoids a failed verification later.
+  "[dart]": {
+    "editor.formatOnSave": true,
+    "editor.rulers": [80],
+    "editor.selectionHighlight": false,
+    "editor.tabCompletion": "onlySnippets",
+    "editor.wordBasedSuggestions": "off"
+  },
+
+  // Generated from lib/l10n/*.arb during pub get, and git-ignored.
+  "dart.analysisExcludedFolders": ["app/build", "app/.dart_tool"],
+
+  "files.exclude": {
+    "**/.dart_tool": true,
+    "**/build": true,
+    "**/.gradle": true
+  },
+
+  // Radar frames are binary and numerous; keeping them out of search results
+  // makes finding code faster.
+  "search.exclude": {
+    "**/app/assets/mock/frames": true,
+    "**/app/lib/l10n/app_localizations*.dart": true
+  }
+}

Nuvolari/.vscode/tasks.json

@@ -0,0 +1,62 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      // preLaunchTask for the emulator debug configurations. Idempotent: it
+      // exits at once when a device is already attached, so pressing F5 twice
+      // does not start two emulators.
+      "label": "Avvia emulatore Android",
+      "type": "shell",
+      "command": "powershell",
+      "args": [
+        "-NoProfile",
+        "-ExecutionPolicy", "Bypass",
+        "-File", "${workspaceFolder}/tool/start_emulator.ps1"
+      ],
+      "problemMatcher": [],
+      "presentation": {
+        "reveal": "silent",
+        "panel": "shared",
+        "clear": true
+      }
+    },
+    {
+      "label": "Verifica (format, analyze, test, build)",
+      "type": "shell",
+      "command": "powershell",
+      "args": [
+        "-NoProfile",
+        "-ExecutionPolicy", "Bypass",
+        "-File", "${workspaceFolder}/tool/verify.ps1"
+      ],
+      "group": { "kind": "build", "isDefault": true },
+      "problemMatcher": ["$dart-build_runner"]
+    },
+    {
+      "label": "Verifica rapida (senza build)",
+      "type": "shell",
+      "command": "powershell",
+      "args": [
+        "-NoProfile",
+        "-ExecutionPolicy", "Bypass",
+        "-File", "${workspaceFolder}/tool/verify.ps1",
+        "-SkipBuild"
+      ],
+      "problemMatcher": []
+    },
+    {
+      "label": "Rigenera i frame radar dimostrativi",
+      "type": "shell",
+      "command": "python",
+      "args": ["${workspaceFolder}/tool/generate_mock_frames.py"],
+      "problemMatcher": []
+    },
+    {
+      "label": "Spegni emulatore",
+      "type": "shell",
+      "command": "adb",
+      "args": ["emu", "kill"],
+      "problemMatcher": []
+    }
+  ]
+}