Troubleshooting

Troubleshooting

.NET Desktop Runtime message

If Windows shows "You must install .NET Desktop Runtime to run this application", there are two common causes:

1. The runtime-required build is being used without Microsoft .NET 8 Desktop Runtime installed.
2. A build artifact such as obj...\apphost.exe was started instead of the published HakamiqChdTool.exe.

Fix

Use one of these options:

• Download the self-contained ZIP.
• Or install Microsoft .NET 8 Desktop Runtime.
• Always run HakamiqChdTool.exe from the extracted release folder.
• Do not run anything from obj or bin folders.

Correct executable

Run HakamiqChdTool.exe from the extracted release folder.

Do not run apphost.exe from obj</code> or bin</code>.

Those folders are for development/build output and are not end-user release folders.

Which ZIP should I use?

Use HakamiqChdTool-v1.1.1-win-x64-self-contained.zip if you want the easiest setup.

Use HakamiqChdTool-v1.1.1-win-x64-runtime-required.zip only if Microsoft .NET 8 Desktop Runtime is already installed.

Verify file integrity

Runtime Required SHA256:

8c867ad9b1e691d0ec6730d473bfe4adeb01bcd6b379e6d6e8ac28425e308b21

Self-contained SHA256:

fed2cc54c98021845e15563075dde06e551584e008a9beea5f7ca7df6cc0ffba