Windows10にaglioをインストールしたかっただけなのに

Windows10環境でaglioを使ってAPI BlueprintをHTMLにしたかったけれど、エラーが出てだいぶハマった結果なんとか使えるようになったので共有。

ハマったパターン

Node.js(v14.16.1)をインストーラーでインストール
おもむろにaglioをグローバルインストール

npm install -g aglio

結果

悲しみのException

gyp ERR! UNCAUGHT EXCEPTION

やったこと

• Node.jsのアンインストール

  • スタートメニューからアンインストーラーを実行

• nodistのインストール

  • https://github.com/nullivex/nodist/releases

• バージョンを指定してインストール
  ※ 8以降でもいけるかも。最新だとエラーが発生した。

nodist + 8.17.0
nodist npm 6.13.4

• Visual Studio Build Tools 2019 のインストール
  • https://visualstudio.microsoft.com/ja/thank-you-downloading-visual-studio/?sku=BuildTools

おもむろに

npm install -g aglio

成功

結局？？

Node.jsのバージョンが新しすぎた
Visual Studio Build Tools が古すぎた

ということっぽい

(追記)

PowerShellでnodistを動かす時に「このシステムではスクリプトの実行が無効になっているため、～」というメッセージが出て動かなかったことがありました。
下記の記事が参考になりました。
ありがとうございます。