AutoHotkey Dev Tools

NOTE: This document has been translated by a translator.

First of all

This extension is incomplete and highly experimental.

If you encounter any problems, please report here.

Goal

"AutoHotkey Dev Tools" aims to become a powerful integrated development environment for AutoHotkey. (vscode-autohotkey-debug was part of this plan.)

However, since this is a personal project, development is progressing very slowly, and it will take over a decade to complete.

Although this project is incomplete, you can enable debugging features by separately installing vscode-autohotkey-debug v1.11.1.

Together with the syntax highlighting described later, it provides the minimum features required for a development environment.

News

This release, version 0.0.1, provides static syntax highlighting for the latest versions of each of the AutoHotkey versions: v1, v2, and v2.1-alpha.

Details are documented here, providing an unique feature: arguments such as command syntax and directive syntax can be accurately represented.

Additionally, you can switch the highlighted version using the #Requires directive while utilizing the same language ID.

Implemented

• Syntax Highlight

License

This extension is protected by license and cannot be included in other projects. However, for transparency, the source code is publicly available.

If you need to use the source code, etc. for any reason, please ensure it remains confined to local and private environments and is not shared with others.

The following are also prohibited:

• Including it in extension packs
• Calling this extension's features from external sources
• Promoting integration with other extensions (Excluding vscode-autohotkey-debug, which officially supports integration)

Installation

1. Install VSCode with version 1.90.2 or higher
2. Install "AutoHotkey Dev Tools". To learn how to install extensions, please see here

If you wish to use additional debugging features, please install version 1.11.1 of vscode-autohotkey-debug.

Features

Syntax Highlight

The following versions are supported.

If you want to learn about Language ID, please see here.

• v1.1.37.02

  • Language ID: autohotkeyl
  • Default File Extension: .ahkl

  Note that the last character of autohotkeyl is L, not 1 (one). The name originates from the fact that v1.1 was called AutoHotkeyL.

• v2.0.19

  • Language ID: autohotkey2
  • Default File Extension: .ahk2

• v2.1-alpha.18

  • Language ID: autohotkeynext
  • Default File Extension: .ahknext

• Version switching

  • Language ID: autohotkey
  • Default File Extension: .ahk

Noteworthy point, it accurately highlight arguments the command syntax, including subcommands. (However, this applies only when line breaks are not included due to specification limitations.)

For example, it covers all patterns, including arguments with special notation or keywords such as Send, and arguments that accept expression with subcommands such as Hotkey, If.

In versions v2 and later, the command syntax has been removed, but similar highlighting is supported as arguments for directive syntax and Script Compiler Directives.

Version switching

Note: The external extension vscode-autohotkey-debug does not support this feature.

Setting the language ID to autohotkey allows you to switch the highlighting version using #Requires. By default, it is highlighted as autohotkey2.

Currently, only simple version notation starting with the following is supported.

• #Requires AutoHotkey v1
• #Requires AutoHotkey v2.0
• #Requires AutoHotkey v2.1

Other

The following highlights are supported.

• Script Compiler Directives
• jsdoc tags