User Tools
manual:Macro_Debugger
Differences
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). | ||
manual/Macro_Debugger.1560835749.txt.gz · Last modified: 2019/06/18 01:29 by peternlewis
Page Tools
