This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
manual:Macro_Debugger [2019/06/18 01:29] peternlewis |
manual:Macro_Debugger [2021/10/15 04:50] (current) peternlewis |
||
---|---|---|---|
Line 3: | Line 3: | ||
Keyboard Maestro includes a built-in macro debugger which you can turn on by choosing the [[Menus#Start_Debugging|Status Menu ➤ Start Debugging menu]] or by using one of the [[action:Debugger_Start|Debugger actions]]. This will display the [[Windows#Macro_Debugger|Macro Debugger window]]. | Keyboard Maestro includes a built-in macro debugger which you can turn on by choosing the [[Menus#Start_Debugging|Status Menu ➤ Start Debugging menu]] or by using one of the [[action:Debugger_Start|Debugger actions]]. This will display the [[Windows#Macro_Debugger|Macro Debugger window]]. | ||
- | {{ macrodebugger.png?528x193 |Macro Debugger }} | + | {{ macrodebugger.png?nolink&683 |Macro Debugger}} |
Once debugging, you can control whether new macros start paused or start running. | Once debugging, you can control whether new macros start paused or start running. | ||
Line 9: | Line 9: | ||
The macro debugger shows all running macros, and what action they are currently executing (including showing nested actions). | The macro debugger shows all running macros, and what action they are currently executing (including showing nested actions). | ||
- | Using the associated buttons, you can: | + | Using the buttons on the left, you can: |
- | + | ||
- | {{:manual:km-7.3-debugger-controls-only-r1.png?nolink|}} | + | |
* **Continue** the macro – allowing it to run until completion, or until it hits a Debugger Breakpoint action. | * **Continue** the macro – allowing it to run until completion, or until it hits a Debugger Breakpoint action. | ||
Line 18: | Line 16: | ||
* **Step In To** the current action, stepping in to any included subaction. | * **Step In To** the current action, stepping in to any included subaction. | ||
* **Step Out Of** the current action and any other actions at the same level. | * **Step Out Of** the current action and any other actions at the same level. | ||
+ | |||
+ | The buttons on the right let you: | ||
+ | |||
+ | * **Edit** the current action in the editor. | ||
* **Cancel** the macro. | * **Cancel** the macro. | ||
+ | |||
+ | The button at the top right toggles displaying variables. The debugger will show the ten most recently modified (by this macro instance) variables and a summary of their values. If you want to show more information, you can use the [[action:Log|Log]] action to log details to the Engine.log file, or use the [[action:Display_Text|Display Text]] action to display information in a window. | ||
To debug a macro: | To debug a macro: | ||
Line 28: | Line 32: | ||
* Click again to advance to further steps/Action. | * Click again to advance to further steps/Action. | ||
- | All the debugger actions can also be done via [[/action/Debugger_Start|the Debugger actions]]. | + | All the debugger actions can also be done via [[action:Debugger_Start|the Debugger actions]]. |
Keep in mind that once a macro has started executing, the engine has taken a copy of the macro to execute, so any changes you make in the editor will not affect the execution of the macro (although any changes you make to a sub macro that has not yet started executing would apply). | Keep in mind that once a macro has started executing, the engine has taken a copy of the macro to execute, so any changes you make in the editor will not affect the execution of the macro (although any changes you make to a sub macro that has not yet started executing would apply). |