Devtools

.github/workflows/build_devtool.yml

@@ -28,7 +28,7 @@ jobs:
           run: tool/gh_actions/devtool/run_devtool_test.sh
 
         - name: Build Static Web
-          run: tool/gh_actions/devtool/build_web.sh
+          run: tool/gh_actions/devtool/install_devtools.sh
 
         - name: Create artifact branch and commit
           run: |

.github/workflows/general.yml

@@ -117,5 +117,5 @@ jobs:
         run: tool/gh_actions/devtool/run_devtool_test.sh
 
       - name: Build Static Web
-        run: tool/gh_actions/devtool/build_web.sh
+        run: tool/gh_actions/devtool/install_devtools.sh
 

devtools_options.yaml

@@ -0,0 +1,4 @@
+description: This file stores settings for Dart & Flutter DevTools.
+documentation: https://docs.flutter.dev/tools/devtools/extensions#configure-extension-enablement-states
+extensions:
+  - rohd: true

doc/tutorials/chapter_6/answers/exercise_2_n_bit_subtractor.dart

@@ -7,7 +7,6 @@ import '../../chapter_3/answers/helper.dart';
 import '../../chapter_5/answers/full_subtractor.dart';
 
 class FullSubtractorComb extends FullSubtractor {
-  @override
   FullSubtractorComb(super.a, super.b, super.borrowIn) {
     // Declare input and output
     final a = input('a');

rohd_devtools_extension/.vscode/launch.json

@@ -30,5 +30,16 @@
                 "--dart-define=use_simulated_environment=true"
             ],
         },
+        {
+            "name": "Run: Web Standalone (port 9099)",
+            "request": "launch",
+            "type": "dart",
+            "program": "lib/main_standalone.dart",
+            "deviceId": "web-server",
+            "args": [
+                "--web-port=9099",
+                "--web-hostname=0.0.0.0"
+            ]
+        }
     ]
 }

rohd_devtools_extension/.vscode/tasks.json

@@ -0,0 +1,137 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Run: Web Standalone (Debug, port 9099)",
+      "type": "shell",
+      "command": "flutter run -d web-server --web-port=9099 --web-hostname=0.0.0.0 lib/main_standalone.dart",
+      "isBackground": true,
+      "problemMatcher": {
+        "pattern": {
+          "regexp": "^$"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^Launching",
+          "endsPattern": "is being served at"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "focus": true
+      },
+      "detail": "Runs standalone web app in debug mode on port 9099"
+    },
+    {
+      "label": "Run: Web Standalone (Release, port 9099)",
+      "type": "shell",
+      "command": "flutter run --release -d web-server --web-port=9099 --web-hostname=0.0.0.0 lib/main_standalone.dart",
+      "isBackground": true,
+      "problemMatcher": {
+        "pattern": {
+          "regexp": "^$"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^Launching",
+          "endsPattern": "is being served at"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "focus": true
+      },
+      "detail": "Runs standalone web app in release mode on port 9099"
+    },
+    {
+      "label": "Run: Linux Standalone (Debug)",
+      "type": "shell",
+      "command": "flutter run -d linux lib/main_standalone.dart",
+      "isBackground": true,
+      "problemMatcher": {
+        "pattern": {
+          "regexp": "^$"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^Launching",
+          "endsPattern": "^Application finished"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "focus": true
+      },
+      "detail": "Runs standalone Linux app in debug mode"
+    },
+    {
+      "label": "Run: Linux Standalone (Debug, software rendering)",
+      "type": "shell",
+      "command": "flutter run -d linux --enable-software-rendering lib/main_standalone.dart",
+      "isBackground": true,
+      "problemMatcher": {
+        "pattern": {
+          "regexp": "^$"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^Launching",
+          "endsPattern": "^Application finished"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "focus": true
+      },
+      "detail": "Runs standalone Linux app in debug mode with software rendering"
+    },
+    {
+      "label": "Run: Linux Standalone (Release)",
+      "type": "shell",
+      "command": "flutter run --release -d linux lib/main_standalone.dart",
+      "isBackground": true,
+      "problemMatcher": {
+        "pattern": {
+          "regexp": "^$"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^Launching",
+          "endsPattern": "^Application finished"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "focus": true
+      },
+      "detail": "Runs standalone Linux app in release mode"
+    },
+    {
+      "label": "Run: Linux Standalone (Release, software rendering)",
+      "type": "shell",
+      "command": "flutter run --release -d linux --enable-software-rendering lib/main_standalone.dart",
+      "isBackground": true,
+      "problemMatcher": {
+        "pattern": {
+          "regexp": "^$"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": "^Launching",
+          "endsPattern": "^Application finished"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "focus": true
+      },
+      "detail": "Runs standalone Linux app in release mode with software rendering"
+    }
+  ]
+}

rohd_devtools_extension/Makefile

@@ -0,0 +1,23 @@
+# Minimal build entrypoints for the upstream standalone extension package.
+
+ROOT := $(shell pwd)
+
+.PHONY: all linux clean-linux help
+
+all: linux
+
+linux:
+	@flutter pub get
+	@flutter build linux --target=lib/main_standalone.dart
+
+clean-linux:
+	-rm -rf $(ROOT)/build/linux
+	-rm -rf $(ROOT)/linux/flutter/ephemeral
+
+help:
+	@echo "ROHD DevTools Extension"
+	@echo ""
+	@echo "Targets:"
+	@echo "  all         - Build the Linux standalone app (default)"
+	@echo "  linux       - Run flutter pub get and build Linux standalone"
+	@echo "  clean-linux - Remove Linux build outputs"

rohd_devtools_extension/assets/help/details_help.md

@@ -0,0 +1,28 @@
+# ℹ️ Module Details — Help
+
+<!-- tooltip -->
+
+Signal Details
+  Click module     Select module to view signals
+  Signal list      Shows ports and internal signals
+
+Signal Values
+  Value column     Current signal value (hex/binary)
+  Width column     Bit width of each signal
+
+<!-- details -->
+
+## Signal Details
+
+| Action | Description |
+| --- | --- |
+| Click module (tree) | Select module and populate signal list |
+| Signal list | Shows input ports, output ports, and internal signals |
+| Value column | Displays the current value of each signal |
+| Width column | Shows the bit width of each signal |
+
+## Export
+
+| Action | Description |
+| --- | --- |
+| 📷 Camera | Export signal table as PNG image |

rohd_devtools_extension/assets/help/devtools_help.md

@@ -0,0 +1,34 @@
+# 🛠 ROHD DevTools — Help
+
+<!-- tooltip -->
+
+Module Tree (left panel)
+  Click node       Select module
+  Click ▸ / ▾      Expand / collapse
+  🔃  Refresh      Reload hierarchy from VM
+  Type in search   Filter modules by name
+
+Details (right panel)
+  Signal list      Shows ports and internal signals
+  Search           Filter signals by name
+  Filter           Toggle input / output visibility
+
+<!-- details -->
+
+## Module Tree (left panel)
+
+| Key | Description |
+| --- | --- |
+| Click module | Select module and show signals |
+| Click ▸ / ▾ | Expand or collapse sub-modules |
+| 🔃  Refresh | Reload hierarchy from the VM |
+| Type in search | Filter modules by name |
+
+## Signal Details (right panel)
+
+| Key | Description |
+| --- | --- |
+| Signal list | Shows input ports, output ports, and internal signals |
+| Search | Filter signals by name |
+| Filter icon | Toggle input / output signal visibility |
+| 📷  Export | Export signal details as PNG |