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 Next revision Both sides next revision | ||
|
manual:Macro_Debugger [2016/12/27 18:03] JMichaelTX Add link to KM Forum post |
manual:Macro_Debugger [2019/06/18 01:29] peternlewis |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Macro Debugger ====== | ====== Macro Debugger ====== | ||
| - | Keyboard Maestro includes a built-in macro debugger which you can turn on by choosing [[Menus#Status_Menu_Start_Debugging|Start Debugging]] from the [[Menus#Status_Menu|Status Menu 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?528x193 |Macro Debugger }} | ||
| Line 13: | Line 13: | ||
| {{:manual:km-7.3-debugger-controls-only-r1.png?nolink|}} | {{: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. |
| - | * Pause the macro. | + | * **Pause** the macro. |
| - | * Step Over the current action, including any subactions. | + | * **Step Over** the current action, including any subactions. |
| - | * 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. |
| - | * Cancel the macro. | + | * **Cancel** the macro. |
| - | For detailed instructions, see [How to debug a macro](https://forum.keyboardmaestro.com/t/how-to-debug-a-macro/5825/2). | + | To debug a macro: |
| + | |||
| + | * Make sure the “Pause New Macros” is checked. | ||
| + | * Trigger your macro. | ||
| + | * Your macro will appear in the Debug window. | ||
| + | * Click on the icon/button with the down arrow to step into the macro to the first step. | ||
| + | * 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]]. | ||
| Line 26: | Line 32: | ||
| 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). | ||
| - | Also keep in mind that macros can often be time sensitive, so if you find your macro runs fine when stepped through in the debugger, but not when run normally, the issue is probably that the macro is executing actions like click actions before the system has caught up and the screen is stable. Add an appropriate Pause action if that is the case. | + | Also keep in mind that macros can often be time sensitive, so if you find your macro runs fine when stepped through in the debugger, but not when run normally, the issue is quite possibly that the macro is executing actions like click actions before the system has caught up and the screen is stable. Add an appropriate Pause action if that is the case. |
| If you close the debugger window, the paused macros will resume their normal operation. | If you close the debugger window, the paused macros will resume their normal operation. | ||
| - | |||
manual/Macro_Debugger.txt · Last modified: 2021/10/15 04:50 by peternlewis
Page Tools
