English is not my main language so any corrections will be appreciated. I'm not an expert, so all these steps will be exactly what I did to compile ahk_h. (some steps might not be needed).
IMPORTANT
As said at the start EVERYTHING here was made thanks to Joe Glines's webinars, please if this guide was helpful for you go to this video like and subscribe because this guide is made by watching that video, if you liked the guide you liked the video: https://www.youtube.com/watch?v=ao5FdsqWTVQ and also part 2: https://www.youtube.com/watch?v=tiL_bIebTx4 and of course thanks to HotKeyIt for all you do for ahk's community.
Requirements:
Ahk_h's source: https://github.com/HotKeyIt/ahkdll
Visual Studio 2017 Community Edition: https://visualstudio.microsoft.com/es/thank-you-downloading-visual-studio/?sku=Community&rel=15
1. Installing Visual Studio 2017 Community Edition
After downloading it, open it.
When you open it you will see a menu that has a lot of checkboxes like this one: (I can't see the menu you will see because I have VS already installed, please if anyone can send me an image of the menu you see after opening the exe it will be really helpful)
Spoiler
Make sure you check the following:
Spoiler
1. Compiling ahk_h's source code1.1. Opening source code in Visual Studio
Double click AutoHotkey.sln (file downloaded from github), wait until it finishes loading. You will receive a message like this one:
Spoiler
Select latest Windows SDK Version (prob first option) and remember the version (write it somewhere, we will use 10.0.17763.0 for this tutorial) and Upgrade to v141 on Platform Toolset (like on the image).Click OK, wait until it finishes, might take minutes to finish.
1.2. Setting Autohotkey as StartUp project
Right click Autohotkey and click on "Set as StartUp project":
Spoiler
1.3. Adding SDK include directoryRight click Autohotkey and go to properties:
Spoiler
Select Platform and Configuration:
Spoiler
Click on VC++ Directories:
Spoiler
Remember I said that you have to write SDK version somewhere? We need it now, on Include Directories (on the right side) add the following:'C:\Program Files (x86)\Windows Kits\10\Include\HERE GOES THE VERSION\shared';
Spoiler
And click OK.You will have to repeats this step with each of the following:
Configuration: Release, ReleaseDll, ReleaseDllMini and Self-Contained.
And for each configuration you have to do the same steps for x32 and x64 Platform (I think you can choose "All Platforms" for this step, but not sure).
1.4. Adding $(LibraryPath); to Library Directories
Right click Autohotkey and go to properties:
Spoiler
On Library Directories (on the right side) add the following BEFORE DOING CHECK IF IT'S NOT ALREADY THERE:$(LibraryPath);
Spoiler
Click OKYou will have to repeats this step with each of the following:
Configuration: Release, ReleaseDll, ReleaseDllMini and Self-Contained.
And for each configuration you have to do the same steps for x32 and x64 Platform (I think you can choose "All Platforms" for this step, but not sure).
1.5. Compiling the source
Click on Build -> Batch Build...
Spoiler
Check the following (for both x32 and x64):Release:
Spoiler
ReleaseDll:
Spoiler
ReleaseDllMini:
Spoiler
Self-Contained:
Spoiler
Click on Build.Wait until it finishes.
You have compiled ahk_h's source now.
1.6. Cleaning up and packing
Execute CleanUpAndPack.exe (file downloaded from github inside ahk_h's source)
Then go to bin and you will see 2 folders:
Spoiler
You will see both contain 2 dlls (mini and normal one) an exe and a bin file. These are the files needed to compile your scripts.2. Changing default password
2.1. Getting all g_default_pwd's references
On the left side click on the arrow next to "Autohotkey" then on the arrow next to "Source Files" and double click "util.cpp"
Spoiler
Press ctrl+f, set the search to current document and write "g_default_pwd" and press the arrow.
Spoiler
Select g_default_pwd, right click and select "Find All References"
Spoiler
Important: If you don't want to change ahk_h's default password length you can skip steps 2.2, 2.3 and 2.42.2. First reference (globaldata.cpp)
Click the 1st reference:
Spoiler
Here you have to add/remove TCHAR g_default_pwd NUMBER = 0; depending on your password's length:Example 1 (default password, length = 10)
Spoiler
Example 2 (custom password, length = 3)
Spoiler
Example 3 (custom password, length = 15)
Spoiler
You have to add/remove &g_default_pwd NUMBER, depending on your password's length:Example 1 (default password, length = 10)
Spoiler
Example 2 (custom password, length = 3)
Spoiler
Example 3 (custom password, length = 15)
Spoiler
2.3. Second reference (globaldata.h)Click the 2nd reference:
Spoiler
Here you have to add/remove extern TCHAR g_default_pwd NUMBER; depending on your password's length:Example 1 (default password, length = 10)
Spoiler
Example 2 (custom password, length = 3)
Spoiler
Example 3 (custom password, length = 15)
Spoiler
2.4. Third reference (script.cpp)Click the 3nd reference:
Spoiler
Here you have to update the for with the new length for (int i = 0; i < NUMBER; i++) depending on your password's length:Example 1 (default password, length = 10)
Spoiler
Example 2 (custom password, length = 3)
Spoiler
Example 3 (custom password, length = 15)
Spoiler
2.5. Sixth and last reference (util.cpp)Click the 6th reference:
Spoiler
Change Code: Select all
pw[i] = pwd == g_default_pwd ? (TCHAR) _T("A\0\0\0\0u\0\0\0\0t\0\0\0\0o\0\0\0\0H\0\0\0\0o\0\0\0\0t\0\0\0\0k\0\0\0\0e\0\0\0\0y\0\0\0\0")[i*5] : (TCHAR)*pwd[i];
This line contains 2 important parts (read both of them and then you will understand how it works):
1_ "A\0\0\0\0u\0\0\0\0t\0\0\0\0o\0\0\0\0H\0\0\0\0o\0\0\0\0t\0\0\0\0k\0\0\0\0e\0\0\0\0y\0\0\0\0"
Spoiler
2_ [i*5]
Spoiler
Example 1: (password = "AutoHotkey", [i*2])
Spoiler
Example 2: (password = "abc", [i*1])
Spoiler
Example 3: (password = "abc", [i*2])
Spoiler
Example 4: (password = "Hotkey", [i*5])
Spoiler
Remember that you have to respect the length you specified before.To-do: Add how to make a dynamic password.
Troubleshooting:
1. "Missing dlls" and "couldn't link..." errors
Check if you followed the steps correctly (specially 1.4). If you did then it might be because you updated Visual Studio and "$(LibraryPath)" changed to Spectre dlls but you didn't download Spectre libs.
There are 2 ways to fix it: Download Spectre library using Visual Studio Installer or inside Visual Studio do right click on "Autohotkey"->"Properties"->"C/C++"->"Code Generation" and search for "Spectre Mitigation" on the panel in the right side, change its value to "Disabled".
IMPORTANT
As said at the start EVERYTHING here was made thanks to Joe Glines's webinars, please if this guide was helpful for you go to this video like and subscribe because this guide is made by watching that video, if you liked the guide you liked the video: https://www.youtube.com/watch?v=ao5FdsqWTVQ and also part 2: https://www.youtube.com/watch?v=tiL_bIebTx4 and of course thanks to HotKeyIt for all you do for ahk's community.
Updates:
1. I forgot to thank HotKeyIt for making everything possible.
2. Added a Troubleshoot section
3. Updated step 2
4. Deleted Troubleshoot section as it was not needed anymore, added how to change password.
5. Fixed a typo in step 2.5
6. Added Troubleshoot section again
