【入門編】MinGW-w64でクロスコンパイルした実行ファイルが依存するシステムDLLを自動抽出するシェルスクリプト術 – 実行環境・ランタイム・コンパイラ生産性向上バイブル

こんにちは!開発現場を支えるインフラやツールの設計をしているシニアエンジニアです。

これから新しいプログラミング言語や開発環境に触れるとき、「なんだか環境構築だけで一日が終わってしまった…」なんて経験はありませんか?特に、Windows環境でCやC++といった低レイヤの言語を扱う際、最初に直面する巨大な壁が「MinGW-w64 / MSYS2」です。

今回は、これから低レイヤの世界へ飛び込むあなたに向けて、MSYS2の基本から、実務で絶対に直面する「DLL不足地獄」を美しく解決する自動化スクリプトまで、一気通貫で優しく丁寧に解説していきます。

これをマスターすれば、コンパイルしたプログラムを他のPCに持っていったら「`libgcc_s_seh-1.dll` が見つかりません」と怒られて絶望する、あの面倒な作業とは一生お別れできますよ。

—

1. MinGW-w64 / MSYS2 とは何か?(なぜ必要なのか)

Windows上でC/C++のプログラムを動かすとき、標準ではMicrosoft純正のVisual Studio(MSVC)が使われます。しかし、Linuxのオープンソース文化で作られたソースコードをそのままWindowsへ持ってきたとき、Linux標準のGCC(GNU Compiler Collection)やMake、Bashといったツール群がないとビルドできないケースが多々あります。

ここで登場するのが MSYS2 です。

  • MSYS2の役割: Windows上でLinuxライクなコマンドライン環境(BashやPacmanパッケージマネージャ)を提供してくれる「母艦」です。
  • MinGW-w64の役割: そのMSYS2環境の中で動作し、Windows上でネイティブに動く(EXEファイルを実行できる)「コンパイラ(翻訳機)」です。

つまり、「MSYS2という便利な道具箱」の中に、「MinGW-w64というWindows用コンパイラ」を入れておくことで、WindowsにいながらLinuxさながらの開発環境を手に入れられるというわけです。

—

2. 導入と基礎セットアップ

まずは、開発の土台となるMSYS2を導入しましょう。公式の手順をなぞるだけでなく、現場で躓きやすいポイントを押さえてセットアップします。

ステップ1: インストール

1. [MSYS2公式サイト](https://www.msys2.org/)からインストーラ(`msys2-x86_64-.exe`)をダウンロードし、実行します。
2. インストール先はデフォルトの `C:\msys64` を推奨します(パスにスペースが含まれない場所が安全です)。

ステップ2: 初期パッケージの更新(最重要)

インストールが完了すると「MSYS2 MSYS」という専用のターミナルが起動します。最初に必ず以下のコマンドを実行し、パッケージデータベースと基本システムを最新化します。

パッケージデータベースとコアシステムの同期・更新を行います
pacman -Syu

※途中で「ターミナルウィンドウを閉じろ」という指示が出たら、指示に従ってウィンドウを閉じ、再度「MSYS2 MSYS」を起動してもう一度上記コマンドを実行してください。

ステップ3: MinGW-w64 ツールチェーンのインストール

システムが最新化されたら、いよいよC/C++のコンパイラやビルドツールをインストールします。以下のコマンドをターミナルに入力してください。

64ビットWindows向けのGCCコンパイラ、Make、GDB(デバッガ)をまとめてインストール
pacman -S –needed base-devel mingw-w64-ucrt-x86_64-toolchain

途中、インストールするパッケージの確認が表示されるので、基本はそのまま「Enter」キーを押して進めればOKです(すべてデフォルトで問題ありません)。

—

3. 動作確認:Hello World から始まる第一歩

正しくインストールされたか確認するため、簡単なC言語のプログラムを作ってみましょう。

MSYS2のターミナルではなく、通常のWindowsのコマンドプロンプトやPowerShellからMinGWを使えるようにするため、環境変数(PATH)を通しておきます。
Windowsのシステム環境変数に `C:\msys64\ucrt64\bin` を追加してください。

その後、適当な作業用フォルダ(例: `C:\projects`)を開き、`main.c` を作成します。

include

int main(void) {
printf(“MinGW-w64 環境構築完了!\n”);
return 0;
}

コンパイルしてみましょう。

ucrt64環境のgccを使ってビルドし、app.exeという名前で出力する
gcc main.c -o app.exe

実行
./app.exe

コンソールに `MinGW-w64 環境構築完了!` と表示されれば、あなたのPCで無事にプログラムが動くようになりました!

—

4. 【本題】配布用DLLを自動抽出するシェルスクリプト術

さて、ここからが本記事のハイライトです。
先ほど作った `app.exe` を、別のWindowsパソコン(開発環境が入っていないクリーンなPC)にコピーして実行してみてください。

おそらく、「`libgcc_s_seh-1.dll` が見つからないため、コードの実行を続行できません…」というエラーダイアログが表示されるはずです。

なぜこのエラーが起きるのか?

GCCでビルドした実行ファイルは、サイズを小さく保つためや標準関数(例外処理や内部ランタイムなど)を共有するために、動的リンクライブラリ(DLL)を外部参照します。
手動でそれらのDLLを探して実行ファイルと同じフォルダに同梱するのは、依存関係が複雑なため非常に手間がかかります。

これを一撃で解決する魔法のシェルスクリプトをあなたに授けましょう。

汎用・依存DLL自動収集スクリプト (`deploy.sh`)

プロジェクトのルートフォルダに `deploy.sh` というファイルを作成し、以下のコードを記述してください。

!/bin/bash

エラーが発生した時点でスクリプトを即座に終了する(安全対策)
set -e

引数のチェック(対象のEXEファイルを指定しているか)
if [ -z “$1” ]; then
echo “使用方法: $0 <実行ファイル名.exe>”
exit 1
fi

TARGET_EXE=”$1″
DIST_DIR=”./dist”

1. 配布用ディレクトリの作成
echo “==> 配布用フォルダ [ ${DIST_DIR} ] を準備しています…”
mkdir -p “${DIST_DIR}”

2. メインの実行ファイルを配布フォルダにコピー
echo “==> 実行ファイル [ ${TARGET_EXE} ] をコピー中…”
cp “${TARGET_EXE}” “${DIST_DIR}/”

3. lddコマンドとawkを駆使して、依存しているDLLのパスを自動列挙し、コピーする
echo “==> 依存するシステムDLLを解析・抽出しています…”
ldd “${TARGET_EXE}” | grep -owE ‘/ucrt64/bin/.\.dll’ | while read -r dll_path; do
if [ -f “$dll_path” ]; then
echo ” -> コピー中: $(basename “$dll_path”)”
cp “$dll_path” “${DIST_DIR}/”
fi
done

echo “==================================================”
echo ” 完了しました! ‘${DIST_DIR}’ フォルダをそのままzip等に固めて配布可能です。”
echo “==================================================”

スクリプトの解説

1. `ldd “${TARGET_EXE}”`: Linuxでおなじみの `ldd` コマンドですが、MSYS2環境ではWindowsのPE形式(EXE/DLL)の依存関係を完璧に解析してくれます。これにより、このEXEがどのDLLを求めているかが一発でわかります。
2. `grep -owE ‘/ucrt64/bin/.\.dll’`: 出力結果から、UCRT64環境配下にある必要なDLLの絶対パスだけを正規表現でスマートに抽出します。
3. `cp` による自動同梱: 抽出したパスからファイル名を抜き出し、自動的に `dist/` フォルダへコピーします。

使い方

MSYS2のターミナルを開き、スクリプトに実行権限を与えて実行します。

スクリプトを実行可能にする
chmod +x deploy.sh

先ほどのアプリを対象に実行
./deploy.sh app.exe

たったこれだけで、`dist/` フォルダの中に `app.exe` と、動作に必要なすべてのDLL(`libgcc_s_seh-1.dll` や `libc++.dll` など)が綺麗に集約されます!この `dist` フォルダを丸ごとzipに圧縮すれば、他のどのWindows環境でもエラーなく動く完全なパッケージの完成です。

—

おわりに

いかがでしたでしょうか?
MinGW-w64 / MSYS2の環境構築から、実務で確実に頭を悩ませる「DLL依存問題」のシェルスクリプトによる自動解決までを解説しました。

開発における「めんどくさい手作業」は、こうした小さな自動化スクリプトで徹底的に排除していくこと。それが、あなたのコードを書くスピードと品質を劇的に引き上げる秘訣です。

これをマスターしたあなたなら、もう環境差異に怯える必要はありません。快適な低レイヤ・C/C++ライフを存分に楽しんでください!

タイトルとURLをコピーしました