【入門編】MSYS2のPacmanで『ローカルパッケージ』を自作する：非公式ライブラリを公式管理下へ組み込むPKGBUILD運用術 – 実行環境・ランタイム・コンパイラ生産性向上バイブル

こんにちは！開発環境アーキテクトの先輩です。

Windows環境でC/C++のモダンな開発をしようと思ったとき、多くの人が最初に直面するのが「ライブラリ管理の壁」です。
「公式のリポジトリ（Pacman）には入っていないけれど、どうしても使いたいマイナーな外部ライブラリがある……。仕方ないから手動で`include`や`lib`をMakefileやCMakeに直書きするか」――ちょっと待ってください。そんな泥臭いやり方は、今日で終わりにしましょう。

今回は、MSYS2の真髄である「Pacmanエコシステム」の内部に、自分だけの自作ローカルパッケージを完璧に組み込む方法を伝授します。
これをマスターすれば、野良ライブラリであっても依存関係ごとPacmanの管理下に置くことができ、バージョンアップやクリーンアップが驚くほどシームレスになりますよ。

—

なぜ「手動管理」を捨ててPacmanにこだわるのか？

Windowsでのネイティブ開発において、MinGW-w64 / MSYS2の`pacman`は最強のパッケージマネージャーです。
しかし、世の中のすべてのオープンソースライブラリが公式リポジトリに登録されているわけではありません。

ここで、よくあるアンチパターンを見てみましょう。

• アンチパターン（手動配置）: ネットからソースコードやコンパイル済みバイナリを落とし込んできて、Cドライブの適当なフォルダ（`C:\mylibs`など）にバラ撒く。
• 末路: どのプロジェクトがどのバージョンのライブラリに依存しているか分からなくなる。環境を再構築するときに地獄を見る。アンインストールが手動なのでゴミが残る。

PacmanのPKGBUILDというレシピファイルを使ってローカルパッケージを作ると、これらの悩みがすべて氷解します。
ファイルはすべてMSYS2の仮想ルート（`/mingw64/`など）の美しくクリーンな管理下に配置され、`pacman -Q`で一元管理、`pacman -R`で一撃クリーンアップが可能になります。まさにプロの技です。

—

全体像：ローカルパッケージ運用へのロードマップ

私たちがこれから行う作業の全体像は以下の通りです。

1. ターゲットの選定: 今回は例として、架空の軽量ユーティリティライブラリ `libfoo` を想定します。
2. PKGBUILDの作成: ソースコードの取得元、ビルド手順、パッケージングの指示を記述する「レシピ」を書きます。
3. パッケージのビルド (`makepkg`): MSYS2のサンドボックス環境で安全にコンパイルし、`.pkg.tar.zst` という拡張子の公式フォーマットを生成します。
4. ローカルリポジトリの作成と登録: 自作パッケージを格納するローカルフォルダを作り、Pacmanに「ここも公式の仲間だよ」と教え込みます。
5. インストールと動作確認: いつもの `pacman -S` でインストールし、コードから呼び出してみます。

それでは、熱いコーヒーでも片手に、手を動かしていきましょう！

—

ステップ1：作業用ディレクトリとテスト用ライブラリの準備

まずはMSYS2のターミナル（通常は MSYS2 MinGW x64）を開きます。
パッケージビルド用の安全な作業スペースを作りましょう。

ホームディレクトリにビルド用の作業用フォルダを作成し、移動します
mkdir -p ~/local-pkgs/libfoo
cd ~/local-pkgs/libfoo

今回は解説のため、その場で簡単なC言語のライブラリ（`libfoo`）のソースコード（tarball）を模した構造を自分で作ってみましょう。
本来はGitHubのReleaseからダウンロードするtarballを想定してください。

テスト用のソースコードディレクトリを作成
mkdir -p libfoo-1.0.0/src libfoo-1.0.0/include

ヘッダファイル（include/foo.h）を作成
cat << 'EOF' > libfoo-1.0.0/include/foo.h
ifndef FOO_H
define FOO_H

ifdef __cplusplus
extern “C” {
endif

// 挨拶を返すだけのシンプルな関数
void foo_hello(void);

ifdef __cplusplus
}
endif

endif
EOF

実装ファイル（src/foo.c）を作成
cat << 'EOF' > libfoo-1.0.0/src/foo.c
include
include “foo.h”

void foo_hello(void) {
printf(“Hello from Local PKGBUILD managed libfoo!\n”);
}
EOF

簡単なビルドスクリプト（Makefile）を同封
cat << 'EOF' > libfoo-1.0.0/Makefile
CC ?= gcc
CFLAGS ?= -O2 -Wall

all: libfoo.a

libfoo.a: src/foo.o
ar rcs libfoo.a src/foo.o

src/foo.o: src/foo.c include/foo.h
$(CC) $(CFLAGS) -Iinclude -c src/foo.c -o src/foo.o

clean:
rm -f src/foo.o libfoo.a
EOF

このソースコードディレクトリをtar.gz形式に圧縮し、本番さながらの「外部ソース」に見立てます
tar -czf libfoo-1.0.0.tar.gz libfoo-1.0.0/

これで、手元に `libfoo-1.0.0.tar.gz` という「公式リポジトリにはない野良のソースアーカイブ」が用意できました。

—

ステップ2：魔法のレシピ「PKGBUILD」の執筆

次に、このアーカイブをどのようにコンパイルし、どこに配置するべきかを定義する `PKGBUILD` ファイルを書きます。
先ほど作成した作業ディレクトリ（`~/local-pkgs/libfoo`）の中に `PKGBUILD` という名前でファイルを作成してください。

PKGBUILDファイルをエディタで作成（nanoやvimなどお好みのものを）
nano PKGBUILD

以下のコードを貼り付けてください。プロのコメントを隅々まで読んで、各変数が何をしているのかを把握してください。

Maintainer: あなたの名前
パッケージの基本情報定義
pkgname=mingw-w64-x86_64-libfoo # MinGW-w64の命名規則（mingw-w64-–）に必ず従います
pkgver=1.0.0
pkgrel=1 # パッケージのビルドバージョン（修正があれば2, 3と上げます）
pkgdesc=”A custom local test library managed by pacman”
arch=(‘any’) # アーキテクチャ（MinGW環境ならanyまたはx86_64）
url=”https://example.com/libfoo”
license=(‘MIT’)
depends=(‘mingw-w64-x86_64-gcc’) # このパッケージが依存する他のpacmanパッケージ
source=(“libfoo-1.0.0.tar.gz”) # 取得するソース（今回はローカルにあるtar.gzを指定）
sha256sums=(‘SKIP’) # セキュリティハッシュ（ローカルテストのため今回はスキップ）

ビルド前の準備（tarballの展開など）
prepare() {
cd “$srcdir/libfoo-1.0.0”
# 必要であればここでパッチを当てたりします
}

コンパイル処理
build() {
cd “$srcdir/libfoo-1.0.0″
# 自作のMakefileを使ってビルドを実行
make CC=”${CC}” CFLAGS=”${CFLAGS}”
}

インストール処理（パッケージの仮想ルートへファイルを配置）
package() {
cd “$srcdir/libfoo-1.0.0”

# MinGW-w64の標準的なパス（インクルードは include/、ライブラリは lib/）へコピー
# $pkgdir はPacmanが用意する一時的なインストール先のルートディレクトリです
install -Dm644 include/foo.h “$pkgdir/mingw64/include/foo.h”
install -Dm644 libfoo.a “$pkgdir/mingw64/lib/libfoo.a”
}

アーキテクチャと言葉の解説

• 命名規則: MinGW-w64環境では、パッケージ名は `mingw-w64-x86_64-` から始めるのが鉄則です。こうすることで、MSYS2本来のツール群と混ざらず、MinGW側の64bit環境用ライブラリとして綺麗に識別されます。
• `$pkgdir` の役割: ここが肝心です。ビルドしたファイル群を直接システムの `/mingw64` にブチ込むのではなく、一度 `$pkgdir` という名の「安全な仮箱」の中に、実際のフォルダ構造（`$pkgdir/mingw64/include/…`）を模して配置します。Pacmanはこの仮箱の中身を読み取って、初めてシステム全体へ安全に展開するのです。

—

ステップ3：`makepkg` によるパッケージの生成

レシピが書けたら、いよいよコンパイルとパッケージングの魔術を発動させます。

パッケージビルドコマンドを実行
makepkg -s

• `-s` オプションは、`depends` に指定された依存パッケージが足りない場合に、自動でPacmanからインストールしてくれる親切設計です。

数秒後、コンパイルが成功すると、同じディレクトリに以下のようなファイルが生成されます。
`mingw-w64-x86_64-libfoo-1.0.0-1-any.pkg.tar.zst`

これが、世界に一つだけの、あなた専用の公式フォーマットパッケージです！

—

ステップ4：ローカルリポジトリの構築と Pacman への登録

さて、パッケージ（`.pkg.tar.zst`）は出来上がりましたが、このままではPacmanはこのファイルの存在を知りません。
自作パッケージを格納する「ローカルリポジトリ」という名の専用フォルダーを作り、Pacmanのデータベースに登録しましょう。

1. ローカルリポジトリ用のディレクトリを作成
mkdir -p ~/myrepo

2. 先ほど作ったパッケージをそのディレクトリに移動（またはコピー）
cp mingw-w64-x86_64-libfoo-1.0.0-1-any.pkg.tar.zst ~/myrepo/

3. リポジトリデータベースの索引ファイル（DB）を生成する
cd ~/myrepo
repo-add myrepo.db.tar.zst mingw-w64-x86_64-libfoo-1.0.0-1-any.pkg.tar.zst

これで `myrepo` という名前のローカルリポジトリデータベースが完成しました。
次に、Pacmanに「このローカルリポジトリの場所」を教え込みます。Pacmanの設定ファイルを編集しましょう。

Pacmanの設定ファイルをエディタで開く
sudo nano /etc/pacman.conf

ファイルの一番最下行に、以下の記述を追加して保存します（パスにご自身のユーザー名や環境に合わせて置き換えてください）。

[myrepo]
SigLevel = Optional TrustAll
Server = file:///C:/msys64/home/あなたのユーザー名/myrepo

(※MSYS2のパス `/home/ユーザ名/…` は、Windowsから見ると `C:/msys64/home/ユーザ名/…` のように表現されます。環境に合わせてスラッシュの向きに注意して記述してください)

設定を保存したら、Pacmanのデータベースを強制同期させます。

リポジトリのデータベースを再読み込み
pacman -Sy

ここで、次のようにターミナルに表示されたら大成功です！
`:: myrepo は最新です` または `myrepo からデータベースをダウンロードしています…`

—

ステップ5：いよいよインストールと動作確認！

ここまで来れば、あとは普段のPacmanと全く同じです。
自作した非公式ライブラリを、堂々とコマンド一発でインストールしてみましょう。

自作ライブラリをインストール
pacman -S mingw-w64-x86_64-libfoo

「本当に綺麗にインストールできたの？」を確かめるために、簡単な動作確認用のCプログラム（`main.c`）を書いてコンパイルしてみましょう。

適当なテスト用フォルダへ移動
cd ~
mkdir test-app && cd test-app

main.cを作成
cat << 'EOF' > main.c
include

int main() {
// libfooの関数を呼び出す
foo_hello();
return 0;
}
EOF

コンパイル（Pacman管理下に置かれたヘッダとライブラリが自動でリンクされます）
gcc main.c -lfoo -o test_app

実行！
./test_app

実行結果：

Hello from Local PKGBUILD managed libfoo!

どうですか？見事に自作ライブラリがシステム全体から美しくリンクされ、寸分狂わず動作しましたね！

—

先輩エンジニアからの実践的アドバイス：アップデートの運用

「もし、今後 `libfoo` のバージョンが `1.0.1` に上がったらどうするの？」

答えは極めてシンプルです。
1. `PKGBUILD` の `pkgver=1.0.1` に書き換える。
2. 再び `makepkg -s` を実行する。
3. 新しいパッケージを `~/myrepo/` にコピーし、再度 `repo-add myrepo.db.tar.zst …` を叩く。
4. `pacman -Syu` を実行する。

これだけで、Pacmanは「おっ、ローカルリポジトリに新しいバージョンの `libfoo` があるな。アップデートしとくか！」と、公式ライブラリと同様にスマートに更新を行ってくれます。もう手動でファイルを上書きコピーして涙を流す必要はありません。

このPKGBUILD運用術をマスターすれば、業務で使う社内共通ライブラリや、ネットの片隅にあるマイナーなC/C++ライブラリの管理ストレスが劇的にゼロになります。
あなたの開発環境は、また一段と「プロフェッショナル」な領域へと進化しました。日々のコーディングを、もっと快適に、もっと楽しんでいきましょう！