このページでは、アプリケーションがリンクするサードパーティCライブラリと、それらを生成するCompressorビルドシステムについて説明します。
元の日付に書かれ、現状の事実は2026-11-22に整合。
このドキュメントは、アプリケーションがリンクするサードパーティ静的ライブラリと、それらを生成するビルドシステムを、計画ではなく実装どおりに説明します。リワーク前の状態(2つの重複するスクリプト世代、コミットされたバイナリ、プラットフォームごとのディレクトリ)は末尾の付録に要約されています。
継続的な制約: このリワーク以前のCompressor/library内のものは、新しいシステムがすべての組み合わせをビルドし、アプリがビルドしてそのテストが新しい成果物に対して通るまで削除されません。剪定は最後に、項目ごとに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.sh <lib>… — 各ライブラリを確実にビルドする(依存が先)。マニフェストがマトリックス行と一致し、すべてのスライスが存在するときは高速なノーオペレーション。--all — マトリックスのすべてのライブラリ。--rebuild — 指定されたライブラリを強制再ビルドする。その依存は通常の鮮度チェックを保つため、1つのレシピの反復がそのチェーンを再ビルドしない。--verify — 成果物をマトリックス+マニフェストに対してチェックする。バージョンとソースハッシュ、スライスアーキテクチャ、ヘッダーの存在、各ライブラリの埋め込みバージョン文字列、加えてlib/verify/のライブラリごとのチェック。--platforms ios,simulator,macosx — ビルドするプラットフォームを制限する(デフォルト: 3つすべて)。ビルドは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ヒントは不要です。
レシピに触れるときに知る価値のある注記:
sqlite3.xcconfigから解析したオプションリストでスライスごとにコンパイルします。レシピはそのリストの唯一の消費者です(MADSqlite3ターゲットがかつて2番目で、それがBUGS.mdの危険H7でした)。オプションは.maddbキャッシュフォーマットを固定します(ページサイズ8192、DQS=0、FTS5、STAT4、……)。変更はフォーマット決定として扱ってください。mariadbclient静的ターゲットを、プラットフォームごとのopensslインストールに対してWITH_SSL=OPENSSLで、zlibインストールに対してWITH_EXTERNAL_ZLIB=ONでビルドし、caching_sha2_passwordとsha256_password認証プラグインを静的にコンパイルし、他のすべてのプラグインを無効にします(プラグイン.soは出荷されません)。DEFAULTインストールレイアウトはヘッダーをinclude/mariadbの下にネストしますが、レシピはそれらを平坦化してmysql.hが正規のincludeルートから解決されるようにし、そのクロスプリセットは1つの実行ベースcmakeプローブ(LibreSSLチェック)にOpenSSLの結果で答えます。lib/recipes/zint.shがcmakeでビルドします(ZINT_SHARED=OFF、ZINT_STATIC=ON、ZINT_FRONTEND=OFF、ZINT_USE_PNG=ON、レシピのlibpngとzlibにリンク)。出力はlibrary/zint.xcframeworkです。2.4.2時代の直接コンパイルとそのローカルパッチ(patches/zint-2.4.2-mad.patch)は退役しました。パッチがバックポートしたZBarcode_Encode_and_Bufferは2.16では上流APIで、ラッパーのBARCODE_*名はエイリアスとして生き残ります。typedef int BOOL;が各インストール後にsybdb.hからコメントアウトされます。Objective-CがすでにBOOLをtypedefしているからです——しかしライブラリ自体はtypedefを保たなければなりません。dblibのCソースがそれを使うからです。src/common、src/port、src/interfaces/libpq、src/bin/pg_config、src/include)を、プラットフォームごとのopensslインストールに対して(--with-ssl=opensslと明示的モジュールフラグoff)ビルドし、次にlibpq.a、libpgcommon.a、libpgport.aをpostgres.xcframework用の単一libpostgres.aにマージします。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コピーが正規です)。
すべての消費ターゲットは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参照)であり、ビルド配線ではありません。
新しいチェックアウトでの初回実行(または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レシピはバージョンごとの知識を運びます(パッチ、インストール済みヘッダー編集、プローブの答え、プラグイン型名、インストールレイアウト、クライアント専用サブツリーリスト)。バージョンが上がるとき、それらが見直すべき場所です。
# 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で追跡されています。
このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。