AutoHotKey の開発(デバッグ込)環境の構築手順 #VSCode

はじめに

この記事では、VSCode を用いて AutoHotkey の開発環境を整えた後、デバッグの仕方を軽く説明します。
AutoHotkey については、こちらの記事で紹介していますので、よければ見てみてください。

興味のない方は読み飛ばしていただいて大丈夫です!!

従来、デバッグする際は、この記事やこの記事に書いてあるようにDBGpというプロトコルを自分でエディタに組み込んでいました (しかし、対応しているエディタが少ないのが悩みどころ)。
また、上に挙げたような言語サポートも得ることができてませんでした。

しかし、2015 年にAutoHotkey、去年にVSCode-Autohotkey-Plusがリリースされたことにより、皆様も使い慣れているであろう VS Code を用いて AutoHotkey の開発ができるようになりました。

AutoHotkey をインストール
- 公式からCurrent Versionのインストーラをダウンロード後、インストールする。
- こちらのサイトの解説が丁寧。
VSCode を起動
以下の拡張機能をインストール
- AutoHotkey
- VSCode-Autohotkey-Plus

これでおしまいです。

ほとんど上記の拡張機能の Overview に書いてあることをなぞる形になります。

VScode を開き、新規の .ahkファイルを作成します。
すると、最初から以下が記述されたファイルが作成されます。
これらは消しても良いですが、あると便利です。

#SingleInstance, Force
SendMode Input
SetWorkingDir, %A_ScriptDir%

簡単に解説します。

#SingleInstance, Force
- 参考
- 実行中のスクリプトがもうひとつ起動されたとき、自動的に既存のプロセスを終了して新たに実行開始する
- これがないと、スクリプトを実行するたびに「既存のプロセスを終了して起動するか」聞かれることになる
SendMode Input
- 参考
- Send、SendRaw、Click コマンドおよび Mouse 系コマンドを処理する際に、システムに一連の操作イベントをまとめて送り込む
- 他のモードだと、大量の Send コマンド等が発生したときに速度が遅くなるらしい
SetWorkingDir, %A_ScriptDir%
- 参考
- スクリプトの作業ディレクトリを実行スクリプトが置いてあるディレクトリにする
- 作業ディレクトリは、相対パスを指定したときに基準となるディレクトリである
- 基本はプログラムが実行された場所が作業ディレクトリになる

他の言語と同じようにデバッグできます。

注意サブルーチン(::を含む命令)が途中に存在すると、その時点でデバッグが終わってしまう様子

<!+x::
StrRefMsg := RegExReplace(Clipboard, "([^\n]+)", "> $1")
Clipboard = %StrRefMsg%
Send, ^v
return

main.ahk

#Include, %A_WorkingDir%/func.ahk

;; CTRL + Xをクリックしたときに、>を挿入する
<!+x::
  AddBlockquotes()
  Send, ^v
return

func.ahk

AddBlockquotes()
{
  StrRefMsg := RegExReplace(Clipboard, "([^\n]+)", "> $1")
  Clipboard = %StrRefMsg%
}