MAD Designer iconMAD

静的ライブラリ: Compressorビルドシステム

このページでは、アプリケーションがリンクするサードパーティCライブラリと、それらを生成するCompressorビルドシステムについて説明します。

元の日付に書かれ、現状の事実は2026-11-22に整合。

このドキュメントは、アプリケーションがリンクするサードパーティ静的ライブラリと、それらを生成するビルドシステムを、計画ではなく実装どおりに説明します。リワーク前の状態(2つの重複するスクリプト世代、コミットされたバイナリ、プラットフォームごとのディレクトリ)は末尾の付録に要約されています。

継続的な制約: このリワーク以前のCompressor/library内のものは、新しいシステムがすべての組み合わせをビルドし、アプリがビルドしてそのテストが新しい成果物に対して通るまで削除されません。剪定は最後に、項目ごとに1コミットで行われます。


1. システムとは何か

1つの宣言的マトリックス、1つのドライバ、ライブラリごとに1つのレシピ、ビルドごとに1つのマニフェスト。

Compressor/
  matrix.conf                  # the single place version/source/platforms/deps live
  build.sh                     # the driver: ensure (default) / --all / --rebuild /
                               #   --verify / --platforms ios,simulator,macosx
  sqlite3.xcconfig             # the single place SQLite compile options live
  lib/common.sh                # download cache, per-arch compile helpers, lipo,
                               #   xcframework creation, manifest writer, lock
  lib/recipes/<lib>.sh         # one recipe per library (configure/cmake + install)
  lib/verify/<lib>.sh          # optional per-library artifact checks
  patches/                     # local modifications to upstream sources, captured
                               #   as diffs (none current; zint's 2.4.2 patch retired)
  media/<sha256>-<archive>     # content-addressed download cache (gitignored)
  src/  build/                 # extracted sources and build trees (gitignored)
  library/
    <lib>.xcframework/         # the single artifact Xcode links (gitignored)
    <lib>/include/             # the canonical header dir consumers name (gitignored)
    manifests/<lib>.json       # version, source hash, flags, slice SHAs (gitignored)

マトリックス(matrix.conf)

行指向でbashで解析可能:

lib        version  sha256  url   ios-archs  sim-archs  mac-archs  min-ios  min-mac  deps

sha256はダウンロードしたアーカイブのハッシュで、すべてのライブラリで固定されています。depsはドライバが先にビルドする他のマトリックス行を名指しします。ライブラリのビルドについて他のどこにも何もありません。ライブラリごとのフラグはレシピにあり、マニフェストにエコーされるため、「どのフラグがこれをビルドしたか?」はマニフェストだけで答えられます。

ドライバ(build.sh)

ビルドはbuild/.ensure.lock.dのロックで直列化されます(mkdirロックで、古い所有者の回復付き——flockはmacOSにありません)。ワークスペースビルド中に複数のXcodeターゲットが並列でensureフェーズを実行できるからです。

ダウンロードはコンテンツアドレスのmedia/キャッシュに着地するため、固定されたソースは一度だけダウンロードされ、使用のたびにハッシュで検証されます。最初のビルドはネットワークアクセスを必要とし、失敗メッセージがそう述べ、tarballを名指しします。

レシピ

各レシピは固定されたソースをbuild/<lib>/sourceに展開し、アーキごとにビルドし、プラットフォームごとにlipoし、finish_libraryを呼びます。それはxcframeworkを作成し、正規のincludeディレクトリをインストールし、マニフェストを書きます。xcframeworkスライス識別子ごとに1つのライブラリが-create-xcframeworkのハード制約なので、マルチコンポーネントライブラリはマージします。opensslはcrypto+sslをlibopenssl.aにマージし、freetdsはct+sybdb+tdsをlibfreetds.aにマージし、mariadbは単一のlibmariadbclient.aです(Connector/CのlibmariadbターゲットはUNIXで共有にハードコードされているため、レシピはmariadbclient静的ターゲットをビルドします)。スライスはライブラリのMach-Oロードコマンド(プラットフォームごとの-m*-version-minフラグ)から推測されるため、-platformヒントは不要です。

レシピに触れるときに知る価値のある注記:

マニフェスト(library/manifests/<lib>.json)

{
  "library": "openssl", "version": "3.5.0",
  "source": { "url": "…", "sha256": "…" },
  "toolchain": { "xcode": "…", "clang": "…" },
  "headers": "ios",
  "flags": "configure: no-shared no-asm no-async; opt: -O3",
  "built": "…",
  "slices": { "ios": { "archs": "…", "sha256": "…" }, … }
}

headersは正規のincludeディレクトリがどのプラットフォームの生成ヘッダーを取ったかを記録します(freetdsはプラットフォームごとにtds_sysdep_public.hを生成し、レガシーレイアウトが選んだようにiosコピーが正規です)。


2. Xcodeがライブラリを消費する方法

すべての消費ターゲットは1つ以上のxcframeworkをファイル参照でリンクし、ヘッダー検索パスに正規のCompressor/library/<lib>/includeを名指しし、ビルドフェーズの最初にEnsure Librariesシェルフェーズを実行します。

set -euo pipefail
"${SRCROOT}/../Compressor/build.sh" --platforms ios,simulator <lib>

フェーズはマニフェストが新鮮なときはミリ秒でノーオペレーションし、そうでなければ欠けているものだけをビルドします。ENABLE_USER_SCRIPT_SANDBOXING = NOがそれを持つすべてのターゲットで固定されています。プラットフォームはios,simulatorに固定されます。まだmacOS向けにビルドするターゲットがないからです——マトリックスのmacOSスライスはUIKit分離が着地したときの準備ができています(ROADMAP.md Track 2参照)。

ターゲット リンク Ensureフェーズ
MADSqlite3 sqlite3.xcframework sqlite3
MAD libarchive.xcframework、bzip2.xcframework、zlib.xcframework libarchive
MADMySQL mariadb.xcframework、openssl.xcframework、zlib.xcframework mariadb
MADPostgres postgres.xcframework、openssl.xcframework postgres
MADTds freetds.xcframework、openssl.xcframework freetds
MADTdsClient Compressorから何もなし(tdsシンボルはMADTds経由) —
MADBarcodes libpng.xcframework、zlib.xcframework、zint.xcframework zint
MAD Designerアプリ openssl.xcframework openssl

覚えておく価値のあるヘッダーの事実: 静的ライブラリxcframeworkはヘッダーを確実に公開しません。そのためすべての消費者が正規のincludeディレクトリを明示的に名指しします(ヘッダーはアーカイブの完全性のためにxcframeworkにもバンドルされます)。zint.h、sqlite3.h、libpq-fe.h(そのコンパニオンヘッダー付き)はPublicフレームワークヘッダーで、そのファイル参照は正規のincludeディレクトリを指します。public MADヘッダーが<MADBarcodes/zint.h>をインポートし、MADSqlite3がsqlite3.hをエクスポートし、MADPostgresがlibpq-fe.hをエクスポートするからです。

MAD ViewerターゲットのレガシーLIBRARY_SEARCH_PATHSリストとScrimpter(ワークスペース外)は意図的に触れられません。ビューアのリンク失敗は製品決定(BUGS.md参照)であり、ビルド配線ではありません。


3. 初回実行、日々の作業、およびバージョンアップ

新しいチェックアウトでの初回実行(またはCompressor/library/を消した後): 最初のXcodeビルドの前か最中に、ライブラリを一度ビルドします。

Compressor/build.sh --all --platforms ios,simulator

ダウンロードにネットワークアクセスが必要で、初回ビルドは30〜90分、そのほとんどが大きなソースtarballです。その後、Xcodeのensureフェーズはノーオペレーションになり、通常のビルドが進みます。

成果物の検証:

Compressor/build.sh --verify --all --platforms ios,simulator

ライブラリのバージョンアップ: そのmatrix.conf行(バージョン、URL、新しいアーカイブのsha256)を編集し、次にCompressor/build.sh --rebuild <lib>を実行し、消費フレームワークのテストスイートと--verifyを実行します。1コミットに1ライブラリ。新しいバージョンがcmakeの実行プローブを追加する場合、mariadbプリセットは大声で失敗してそれを名指しします——推測せず明示的に答えてください。

zint/freetds/mariadb/postgresレシピはバージョンごとの知識を運びます(パッチ、インストール済みヘッダー編集、プローブの答え、プラグイン型名、インストールレイアウト、クライアント専用サブツリーリスト)。バージョンが上がるとき、それらが見直すべき場所です。


4. 検証コマンド

# slice inventory
for f in Compressor/library/*.xcframework/*/lib*.a; do lipo -archs "$f"; done

# version strings (each library embeds its matrix version)
strings Compressor/library/openssl.xcframework/*/libopenssl.a | grep -m1 "OpenSSL 3.5.0"

# sqlite correctness, against the BUILT framework (the H7 gate)
nm MADSqlite3.framework/MADSqlite3 | grep -c sqlite3Fts5Init     # present
strings MADSqlite3.framework/MADSqlite3 | grep -x 'DEFAULT_PAGE_SIZE=8192\|DQS=0'

# wiring cleanliness -- expect "" bases plus the MAD Viewer legacy list only
grep -rn 'LIBRARY_SEARCH_PATHS' --include='*.pbxproj' .

# the fresh-clone simulation (proves portability + on-demand building)
git archive HEAD | tar -x -C /tmp/fresh
cd /tmp/fresh
Compressor/build.sh --all --platforms ios,simulator     # bootstrap path (a)
xcodebuild build -workspace Reports.xcworkspace -scheme "MAD Designer" -destination …
Compressor/build.sh --verify --all --platforms ios,simulator
# path (b): wipe library/ xcframeworks and build in Xcode only -- the ensure
# phases rebuild everything

付録: リワーク前の状態(参照用)

2026-10-04以前、ライブラリは2つの重複するツーリング世代でビルドされていました。ライブラリごとのCompressor/build_*.shスクリプトと1,293行のcompressor.shドライバ(実行不能: 未定義変数がset -e下で404ダウンロードを引き起こし、宣言されたバージョンは何年も古かった)です。そして結果はコミットされていました。Compressor/library/の下に99の.aファイル(約350 MB)、すべてのヘッダー、9.2 MBのsqlite3.cアマルガメーション、加えてMADBarcodes内の53のベンダーZintソースファイル。Xcodeはそれらをファイル参照とSDK条件付き検索パスだけで消費していたため、macOSは決して配線できませんでした(PBXFileReference.pathはSDK条件付きではない——BUGS.mdのエントリはxcframework再配線で閉じられます)。古いスクリプトとコミットされたツリーは、新しいシステムがすべての組み合わせをビルドし、アプリがビルドしてそのテストが新しい成果物に対して通った後にのみ、剪定フェーズで削除されます。

マトリックスが始まったベースラインバージョンとその目標更新はTASKS.md §6で追跡されています。

このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。