MAD Designer iconMAD

LinuxでのMADエンジンのコンパイル — 技術評価

このページはLinuxビルドを記録します。Dockerイメージ、固定されたツールチェーン、12のヘッドレスフレームワーク、およびそれらが実行するスイートです。日常的なコマンドはLinux/README.mdにあります。

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

2026-10-04、masterのc807eeb4dに対して書かれました。このドキュメントが依拠する依存監査(§4)とエコシステム調査(§5-6)はどちらも同じ日に作成されました。監査はすべてのフレームワークのソースディレクトリをgrepし、調査は一次資料(リリースノート、パッケージリポジトリ、プロジェクトのメーリングリスト)から行いました。証拠が薄い場合はそう述べています。このドキュメントは、プラットフォームマトリックスをスケッチしたMAD_FUTURE.md §5.1の技術的コンパニオンです。これがその深掘りです。


1. 問いへの答え

これはLinuxでコンパイルできるか? はい、条件付きで——両方の意味で。

2つのアスタリスク: GNUstepのFoundationは存在するが未検証であり、このコードが最も強く依存するAPI(NSPredicate/NSExpression、キー付きアーカイブ、NSURLSession)についてそうです。そしてLinuxに現実的なUIKitは存在しません——これは問題ありません。監査はコードがすでにUIKitを名指しされたファイルに閉じ込めており、レンダリング計画がとにかくUIKitから離れるからです。


2. 2製品の問い: 書き換えるか、コンパイルして呼ぶか

ユーザーが提起した選択: すべてをPythonで書き換えて2つの製品を維持するか、一度コンパイルしてPythonがエンジンを呼ぶか。監査がそれを決着させます。

エンジンは大きい。 ヘッドレスフレームワーク集合——MADFoundation(65 h+mファイル)、MADCocoaExtensions(44)、MADDataStructures(36)、MADFileManager(30)、MADAPI(33)、MAD(403)、MADSqlite3(64)、MADMySQL(41)、MADTds(3)、MADTdsClient(8)——は約727ファイルです。Pythonの書き換えは量だけでなく、テストで固定された苦労して得た振る舞いを重複させます。SQLジェネレータ、MADDataTableFastの取り込みパス(200,000行を1.16秒、ベンチマーク済み)、ドライバの型マッピング(SQL Serverのモダンな日付/時刻処理はライブテストが2回捕捉したからこそ存在します)、nullセンチネルファミリ、ストアリーダー。その2つの実装はドリフトし、スイートは1つだけを固定します。それは「2つの製品」ではなく、1つの製品と1つの負債です。

統合面はすでに存在する。 CLIが契約です。mad inspect → メタデータ、mad query → SQL、mad refresh → 行、mad export → フォーマット、終了コードが悪いドキュメント(2)と到達不能なサーバー(3)と失敗したクエリ(4)を区別します。Pythonサービスは--format json付きのサブプロセスとしてそれを呼び、レポートを得ます。サブプロセスのオーバーヘッドはリフレッシュのタイムスケールでは無関係です(サンプルは0.02〜1.2秒でリフレッシュし、プロセス起動は約10 ms)。インプロセス埋め込みが重要だと測定されたことがあれば、同じソースがctypes/CFFI用の小さなC ABIライブラリをビルドできます——しかしそれは任意であり、前提条件ではありません。

Pythonを好むと述べられた理由——ドライバ接続——について。 Pythonのコネクタエコシステムが広いことは事実で、1回のpip installでこのプロジェクトにドライバがないデータベースに到達できます。しかし今日存在するソースについては、接続はすでに言語中立です。MADドライバはfreetdsとMariaDB Connector/Cに載っており——PythonやCプログラムがリンクするのと同じCライブラリ——両方ともLinuxでネイティブにビルドされます(§7)。エンジンをコンパイルすれば、その接続はそのままLinuxに移ります。Pythonが本当に優位なのは新しいソース種別(Postgres、BigQuery、REST)であり、そこでの正しい答えはプロジェクトがすでに約束する拡張シームです。スキーマと行を返すMADDatabaseサブクラス。HTTPを話すドライバはObjective-CでもPythonでも同じように振る舞います。Pythonが買うのはより多くの既製コネクタであり、より簡単なコアではありません。

正直なトレードオフを率直に言うと: これは2つの実装(Python + Objective-C)を恒久的なドリフトリスク付きで維持することと、ニッチなツールチェーン(clang + libobjc2 + GNUstep)上の1つの実装をエコシステムリスク付きで維持することの選択です。このドキュメントは後者を推奨し、再検討する測定可能なトリガーを持ちます。§9がチェックポイントを名指しします。推奨を拘束力あるものにする唯一のものはJSONエクスポートの形です——Python契約はそのスキーマの良さと同じであり、それを定義することが§10の決定1です。

そして書き換えが実際に起こるなら、正しい言語はLinux上のSwift——Pythonではなく——です。ポータブルSQLiteストア(Phase Cの作業)はすでに言語中立の契約だからです。どちらの側がストアを書いても、もう一方が読みます。


3. コンパイルしなければならないもの、してはならないもの

フレームワーク ヘッドレスで必要 理由/不要な理由
MADFoundation はい ベース: オペレーション、URLファクトリ、キーチェーン(除外可能)、ロギング
MADCocoaExtensions はい どこでも使われるヘルパー(11のUIKitファイルだが、除外可能なもの)
MADDataStructures はい Appleインポート0。C++ファイル3(libc++が必要)
MADFileManager はい Appleインポート0。クラウドコーディネータは除外(iCloudはPhase Dで削除される)
MADAPI はい 接続レイヤー。3つのUIKitファイルはビューコントローラで、ヘッドレスではない
MAD はい 難しいもの: 403のうち29 UIKit、34 CoreData、15 CoreGraphics
MADSqlite3 はい Appleインポート0。MADArrayCaching(.madacストア)は100%クリーン
MADMySQL はい Appleインポート0
MADTds / MADTdsClient はい Appleインポート0
MADExplorer いいえ ファイルエクスプローラUI(32ファイル中19がUIKitをインポート)
MADBarcodes はい エンコード+PNGコアはポータブル(zint + libpng)。MADBarcodeViewとMADBarcodeCacheだけがApple側に残る
MADFeedback いいえ 未使用でメンテナンスされていない
Scrimpter いいえ Appleインポート0だが未使用
MADDesigner(アプリ) いいえ 302のUIKitファイル。UIはAppleプラットフォームに残る

依存の向き: すべてがMADFoundationの上にあり、ドライバはMADのMADDatabaseをサブクラス化し、MADのConstructorファイルはドライバをインポートします——既知の循環です(ROADMAP.md §3.4)。ドライバレジストリ(ROADMAP.md §5.1)はLinuxにとって二重に重要です。その循環を断ち切り、Linuxビルドがドライバをハードインポートの山ではなくプラグインとしてリンクできるようにするものです。


4. 測定された監査

フレームワークのソースディレクトリごとに、各Appleフレームワークをインポートするファイル(複数のUIKitヘッダーをインポートするファイルは1回と数える):

フレームワーク 合計 UIKit CoreData CoreGraphics Security os/log CoreFoundation dispatch
MADFoundation 65 4 0 0 1 9 3 1
MADCocoaExtensions 44 11 0 3 0 1 0 0
MADDataStructures 36 0 0 0 0 0 0 0
MADFileManager 30 0 0 0 0 2 0 5
MADAPI 33 3 0 0 0 4 0 2
MAD 403 29 34 15 1 15 ~19 3
MADSqlite3 64 0 0 0 0 4 3 5
MADMySQL 41 0 0 0 0 2 0 1
MADTds 3 0 0 0 0 1 0 0
MADTdsClient 8 0 0 0 0 0 0 3

柱の外側のロングテール、それぞれに処置:

項目 サイト 処置
os_log(すべてがmadlog.hに集約、2つのコピー) 9+15+4+2+…ファイルがシムをインポート syslog/printfに対する約20行のヘッダーを1つ書き換える。他の呼び出しサイトは変わらない
asl.h(非推奨のApple System Log) MADocument.m:107、RptqDocumentElement+Extras.m:60 madlogシムに差し替える
copyfile.h MADArchiveManager.m:14、madtar.m:18 POSIXのrename/link
mach/machine/vm_param.h(ページサイズ) MADocument.m:108 getpagesize()
CFNetwork/CFHost逆引きDNS BDHost.m(1ファイル) getaddrinfo
NSMetadataQueryクラウドコーディネータ MADFileManager(3ファイル) 除外——iCloudはPhase Dで削除される
Security.framework / SecItem MADKeyChain.m、MADOperationKeyChainGet.m + テスト 除外——リフレッシュパスはオペレーション依存から認証情報を取り、キーチェーンは決して使わない。CLIはすでに--credentialsで代替する
MADApplication.mのAppKitガード 1ファイル TARGET_OS_LINUX分岐を追加
MADURLFactory.m:32のUIScreenスケール 1行 2.0を返す
MADOperation.m:549-563のUIApplicationバックグラウンドタスク 1つのガードされた機能 #ifで外す
CoreFoundation(CFNumber/CFData/CFString、トールフリーブリッジング) MAD、MADFoundation、MADSqlite3にまたがる約25サイト GNUstepの同等物/機械的書き換え。CoreBase(GNUstepのCFクローン)は未成熟で、頼らないこと
UIKit値トランスフォーマ(MADColorTransformer、MADLocaleTransformer、MADPngImageTransformer) 3ファイル、現在CLIのターゲット境界を越えて引きずられている Phase Dで消える——ストア移行がトランスフォーマブルをポータブルなスカラーに変換する

SystemConfiguration: 出現ゼロ。CommonCrypto: フレームワークにゼロ(アプリのみ、レシート検証)。@import: ゼロ——すべて#importで、GNUstepが求めるものです。


5. 3つの柱

5.1 Core Data — 進行中の移行がレバー

34のMADファイルがCore Dataをインポートし、MADocumentはUIManagedDocumentで、ストアはコンパイルされたMAD.momdで、MADAtomicStoreが下にあります。それらのどれもLinuxには存在せず、存在する必要もありません——プロジェクトがすでにそれを置き換えているからです。MAD_STORE_MIGRATION.md Phase Cは2026-10-03に着地し、RptqStoreContext.hは「ここにあるものはCore Dataをインポートしない」と宣言しています。Phase DはUIManagedDocument、値トランスフォーマ、.xcdatamodel、iCloud機構を削除します——それは同時に§4のいくつかの項目(値トランスフォーマ、クラウドコーディネータ、CLIが現在アプリバンドルからコピーするMAD.momd)を殺します。

Phase CとDを完了することがLinuxへの単一の最も高いレバレッジのステップであり、それはLinux固有の作業ではなく、プロジェクトがポータビリティのためにすでに所有する作業です。移行計画からの1つの注記: iCloud時代の古いドキュメントはユーザーがiOS Filesアプリを通じて取得し、オープン時に変換されます(MADStoreConverter)。iCloud機構はそれらを取得するのに不要なので、Phase Dの削除は何も取り残しません。

5.2 UIKit / CoreGraphics — 29ファイル、ほとんどは些細

29のMAD UIKitファイルの内訳:

種類 数 処置
CGGeometry構造体(CGRect/CGSize/CGPoint) 15ファイル プレーンな構造体——定義を複製。描画ゼロ
フォーマッタのUIEdgeInsets 約3ファイル 構造体演算に置き換え
モデル/レイアウトコードのUIFont/UIColor/UIImage いくつか メトリクスと保存スタイルの軽量同等物
UIActivityItemProvider / 共有シート 2ファイル ヘッドレスではない——除外
UIScreen/UIApplication 2ファイル ワンライナー、§4
MADPrintPageRenderer + UIGraphics PDFコンテキスト エクスポートシーム 本当の作業——下記参照
MADocumentのUIManagedDocumentベース ドキュメントクラス Phase Dで消える

注目すべき良いニュース: MADReportFormatter.mのUIKit使用は実質的に痕跡的で(1つのUIEdgeInsetsMake、1つの未使用UIPrintInteractionControllerインポート)、MADArrayCaching——.madacレンダリングページストア——はすでに100% UIKit/CoreDataフリーです。それは今日どのObjC Foundationでもコンパイルされます。

レンダラーの決定。 CoreGraphics PDFコンテキストにLinuxの同等物はありません。最もコストの低い段階分け: データパス動詞を先にグリーンにし、次にexport --format json / --format csv(純粋なFoundation——Python呼び出し元がとにかく望むフォーマット)、次にHTML/SVGページ(ネイティブ依存なし)、最後にPDF。同じMADPrintPageRenderer描画ループの背後にcairoやlibharuのライターを置くか、Linuxがデータとページを提供する間PDFレンダリングをmacOSワーカーに残します。CLIがすでにPDFにバイトパッチする--deterministicフラグは、クロスプラットフォームレンダラーテストの種です。

5.3 GNUstep上のFoundation — 存在し、部分的に検証され、周辺でリスク

調査が一次資料から検証したこと:

存在証明: SOGoはObjective-Cのグループウェアサーバーで、Debian sidでgnustep-base-runtime (>= 1.31.1)にハード依存して出荷されています——GNUstep Foundationが本番デーモンとして大規模に動作しています。Darlingはlibobjc2を駆動します。Linux上の非GUI ObjCツールは普通であり、異国ではありません。


6. ツールチェーンとエコシステム


7. Cライブラリ — 簡単な部分、1つのライセンスブロッカー付き

すべてのベンダーライブラリは上流のautoconf/cmakeビルドを持つポータブルなCです。

ライブラリ バージョン ライセンス Linuxビルド
sqlite3 3.53.3 パブリックドメイン ネイティブ。フォーマット固定フラグはすでにCompressor/sqlite3.xcconfigにある
zlib 1.3.2 Zlib ネイティブ
openssl 3.5.9 Apache-2.0 ネイティブ
bzip2 1.0.8 BSD系 ネイティブ
libpng 1.6.59 PNG Reference v2 ネイティブ
libarchive 3.8.9 BSD-2 ネイティブ
freetds 1.4.27 LGPL-2.0+ ネイティブ(レシピに修正すべきBSD sed -i ''の些細な点あり)
mysqlclient 8.4.10 GPL-2.0 + FOSS例外 ネイティブ——しかしGPLはプロプライエタリバイナリの出荷ブロッカー。MariaDB Connector/C(LGPL-2.1)がLICENSE_COMPLIANCE_PLAN.mdですでに名指しされた代替
zint 2.16.0 BSD-3 ネイティブ。MADBarcodesのPNGコアがリンクするバーコードバックエンド(上記libpngと)

加えてツリー内C(miniz、madmath、madpng、madtar、madlib——すべてポータブル、すべて寛容なライセンス)。Apple固有なのはCompressorのパッケージングレイヤーだけです(xcrun、-isysroot、lipo、xcodebuild -create-xcframework)。Linuxドライバはそれをすべて落とし、同じ上流ビルドをネイティブに実行し、プレーンなar + includeインストールで終えます。iOS固有の複雑さ(mysqlclientの2段階ホストツールビルド、freetdsのプラットフォームごとの生成ヘッダー)はネイティブビルドで消えます。監査からの1つのフラグ: Karl Kraft MySQLコネクタは無ライセンスです——MariaDB移行で置き換え、出荷しないでください。


8. ビルドとテストの計画

8.1 デプロイパス: クロスコンパイルではなくコンテナ

これは実際にどのようにビルドされ出荷されるのか?


9. 工数とフェーズ

取るべき順序のバケット:

フェーズ 作業 性格
A ストア移行のPhase C + Dを完了する すでに所有するポータビリティ作業。Core Data、iCloud、値トランスフォーマ、.momdを除去——単一の最大のLinuxレバー
B ツールチェーンスパイク: clang + libobjc2 + GNUstep BaseをソースビルドするDockerfile。MADFoundationサブセットをコンパイル 環境を証明し、ビルド/CIイメージになる。数日
C §4のシムリスト 有界で列挙可能——madlog、asl、copyfile、vm_param、CFHost、MADApplication、UIScreen、バックグラウンドタスク、約25のCFサイト、除外
D チェックポイント: Linuxでデータパス動詞がグリーン——両サンプルに対するinspect、schema、query、refresh、フィクスチャのバイト比較 Cの後でこれがグリーンでなければ、GNUstep Foundationのテールは見積もりより大きく、その瞬間に書き換えの問いを再検討します——それ以前ではない
E エクスポート: JSON/CSV(Python契約)、次にHTML/SVGページ、次にPDFの決定(cairo/libharu対macOS側レンダリング) まず純粋なFoundation。レンダラーは最後
F Compressor Linuxドライバ(ネイティブビルド、マトリックス列、MariaDBスワップ、freetds sed修正)+ CMake磨き + CI行 + デプロイ可能イメージ 機械的、ライセンスでゲート

順序の根拠: Aは所有作業、Bは安価で全体をデリスクし、Cは列挙可能、Dが正直なgo/no-goです。EとFの何も問いに答えるためには必要なく、出荷するためだけに必要です。

Phase Aステータス(2026-10-06)。 Core DataはMADフレームワークから外れました。MADocumentはUIDocumentで、レガシーコンバータとコンパイル済みモデルはMADLegacyStoreConversionの背後でアプリケーションターゲットにあり、変換されたドキュメントはCore Dataファイルを剪定し、フレームワーク/MADDesignerの掃除が残りのインポート、型、死んだコードを除去しました。値トランスフォーマ、エクスプローラのクラウドペイン、iCloudエンタイトルメントはユーザーの決定で保持されます——アプリ側なので、ヘッドレスビルドをブロックしません。ファイルマネージャのクラウドコードは未使用のままそこに残ります(ユーザーによれば、ヘッドレスモードには不要)。Bの前に残るのは、ツールチェーンスパイクが必要と証明する§4のファイルレベル除外だけです。

Phase Bステータス(2026-10-06)。 ツールチェーンスパイクはlinux-portブランチでグリーンで、2026-10-16にmasterへマージされました(524e0d86e)。Linux/は1つのDockerイメージをビルドします——Ubuntu 24.04とディストロのclang 18(§6の「ソースから」要件はGNUstepがlibobjc2に対してビルドされることであり、LLVMのことではない)、加えてソースビルドのlibobjc2 2.3、libdispatch 6.1.3、gnustep-make 2.9.3、gnustep-base 1.31.1をLinux/toolchain.confに固定——MADFoundationの27実装ファイルのうち23とmadlib.cをGNUstepに対してコンパイルし、その中で15のテスト実行ファイル(14のポーティング済みスイートとツールチェーンプローブ)を実行します。すべて通り、5つの記録されたニーズと10のプローブレポート項目があります。./Linux/build.shがエントリポイントです。iOSスイートはグリーン(118テスト)を保ち、作業が必要とした6つの小さなプラットフォームガードがAppleで振る舞い中立であることの証明となりました。

プローブは§5.3のリスクリストのほとんどを、エンジンが実際に使うFoundationについて退役させます。ARCと弱参照ゼロ化、ブロック、例外、@synchronized、KVO(手動と依存キー)、NSOperationステートマシンKVO、NSPredicate predicateWithFormat:@"error != nil"(MADの正確な述語)、プレーンな実行ファイル下でのメインキュー排出を含むdispatch、JSON、日付、plist、ソート記述子、ストリーム、許容パス上のキー付きアーカイブがすべて通ります。2つのギャップが記録され、隠されません。GNUstepのアーカイバはセキュアコーディングをサポートせず(requiringSecureCoding:YESはnilを返す。許容パスはラウンドトリップする)、GNUstepのNSOperationQueueはすべての通知でisReady観測を削除しますが、MADOperationのステートマシンはエンキューごとにisReadyを複数回通知していました——2回目の削除がraiseし、MADOperationはLinuxでエンキューできませんでした。それは解決済みです(2026-10-06、linux-port、現在master)。MADOperationは-willEnqueueから状態前進を明示的に駆動し、isReady/isExecuting/isFinishedのKVOを実際の値変更時のみ送るため、キューはAppleと同じく1つの通知を見ます。Linuxテストは両プラットフォームでそれを明白にアサートし、ニーズは3に減りました。機構はLinux/README.mdに、除外ファイルとより小さなシム(NSOperation.name、qualityOfService、NSDataWritingFileProtection*、QOS_CLASS_DEFAULT、アプリグループコンテナ)とともに書かれています。Phase Aが予期したファイルレベル除外は、まさに§4の4ファイル(BDHost、MADApplication、MADKeyChain、MADURLFactory)であることが判明しました。プレリュードが覆い隠していた自己完結ヘッダーの掃除は完了しました(2026-10-06)。Linuxビルドのすべてのヘッダーとソースが使うものをインポートし、Linux/Compat/MADCompat.hは1つの実際のプラットフォームギャップ、NSOperationのnameプロパティまで縮みました。

Phase Cステータス(2026-10-06)。 §4のシムリストはクリアされ、ビルドはもはやスパイクではありません。§3の表の12のヘッドレスフレームワークすべてがイメージ内でコンパイル・リンクします——MADFoundation 27中26、MADDataStructures 17、MADFileManager 11中10、MADCocoaExtensions 17中7、MADAPI 11中8、MADSqlite3 26、MADTds 1、MADTdsClient 5中4、MADMySQL 19中18、MAD 181中150——そしてそれらのスイートがctest下で実行されます。114の実行ファイル(1098テスト)、すべてグリーン、6つの記録されたニーズがあり、それぞれApple専用機構(Core Data、コンパイル済みモデル、MADocument、コンバータ)でLinux/README.mdに名指しされています。2026-10-10にマージされたカバレッジマスター(約100のXcodeテストファイル)は完全にポーティングされ——55の新しい実行ファイル、スイートごとに——マージは2つのApple側不具合を発見し、どちらも修正されてBUGS.mdにあります。フレームワークターゲットがプリプロセッサ定義から$(inherited)を落としていた(すべてのフレームワークDebugビルドでDEBUGが死んでいた)、そしてMADのドキュメントフィクスチャが実行間で1つのストアを共有していた。ライブラリレイヤー(Linux/libraries.conf、Linux/lib/libraries.sh)がsqlite3、openssl、freetds、zlib、bzip2、libarchive、libpng、zint、mysqlclientをネイティブにイメージへビルドします(§7のCライブラリ。何も出荷されません)。ロングテール項目は§4が予測したとおりに進みました——asl.h/vm_param.hインポートは痕跡的で、copyfile(3)はPOSIXになり、CFHostはgetaddrinfoになり、CFサイトはCFNumberGetValueシムになりました——UIKit/CoreGraphicsテールは理由付きでファイルごとに除外され、ポーティングされません(§5.2の処置。MADocument(UIDocument)とMADReportFormatterはPhase Dを待ち、それはプラットフォームと同じくらいCLIの問題です)。MADのスイートはさらに3つの差異を発見し、すべて修正またはシムされLinux/README.mdに書かれています。ランタイムのBOOLエンコーディング(Apple以外では'C')、class_getProperty()のスーパークラスウォーク欠如(どちらもRptqObjectで修正)、スタブ+propertyListWithStream:(シム)。テストカバレッジのポーティングはさらに3つを追加し、同様に修正またはシムされました。NSOperation.asynchronous/-isConcurrent(Compatカテゴリ——なければ終了する非同期オペレーションが-deallocからraiseした)、-coordinateAccessWithIntents:(GNUstep実装がフォールトする。Compatカテゴリがキューでアクセサを呼ぶ)、MADURLFactoryからのスキームなしURL(今は+fileURLWithPath:で、5つのコーディネータテストをアンパークした)。最も長く固定されたままだった差異——GNUstepの-localizedCaseInsensitiveCompare:は大文字小文字を区別するため、MADSqlite3の登録済み照合順序がAppleと異なる順序でテキストを並べた——は今修正されています(2026-10-25)。照合順序、メモリ内ソートセレクタ、フォーマッタのコンパレータはすべて1つのファーストパーティ定義順(NSString+Comparison.h)を通り、ピンは両プラットフォームで同一に成り立つ定義順テストになりました。ライブのMADTdsClientLiveTestsスイートはイメージ内からSQL Serverコンテナに対してグリーンで実行され(29/29)、ドライバパスがコンパイルされるだけでなくLinuxで行使されます。Phase D——CLIとデータパス動詞——が次のステップでありgo/no-goです。

Phase Dステータス(2026-10-16)。 チェックポイントは達成されました。madはCLI/Source(iOS-Simulatorツールがビルドされるのと同じソース)からイメージ内でビルドされ、12のフレームワークをリンクし、そこでデータパスを実行します。inspectはレガシーv0サンプルとポータブルv1フィクスチャの両方を報告します。schemaとqueryはMacのツールと同じ答えを生成します(schemaはバイト同一)。refreshはSqlite3サンプルで行キャッシュを埋め、フィールド名で比較するとMacのキャッシュとバイト同一です(76行、21列)。そしてイメージ内からライブサーバーに対して、mad refreshはMySQL 8.4から50行(employees、プリペアドステートメントフェッチ)を、SQL Server 2022から20行(AdventureWorksLT2022、freetds経由)を取得しました。ライブスイートも一致します——同じイメージでMADMySQLLiveTests 44/44とMADTdsClientLiveTests 29/29——ctest実行は117の実行ファイル、1153テスト、6ニーズ、すべてグリーンです。

そこへ到達するために2つのことが解決され、どちらもLinux/README.mdに記録されています。

  1. ドキュメントの問い(§5.1、§9 Phase D)。 MADocumentはUIDocumentなので、そのまま持ってこられません。ユーザーの選択(2026-10-16)はヘッドレスドキュメントパスであり、CompatのUIDocumentシムでもMADocumentの分割でもありませんでした。ドキュメントのデータ半分は今やプロトコルMADDocumentDataProtocolで、MADocumentがそれに準拠し(すべてのメンバーはすでにそのアクセサの1つでした)、MADHeadlessDocumentがアプリのドキュメントが使うのと同じMADDocumentStore上で実装します。リフレッシュチェーン——ドライバレジストリとともにMADへ移動(ROADMAP.md §3.4、§5.1)——はプロトコルを取り、両プラットフォームが同じMADOperationRefreshを実行します。その1つのレンダー側分岐は#if __APPLE__で、mad export(PDF、Core Graphics)はApple側に残ります。これは§5.2の段階分けです。
  2. ドライバレジストリ(§3、§5.1)。 コンストラクタはもはやMySQLとTDSをインポートしません。各ドライバは+loadで自身を登録し、コンストラクタが型でルックアップします。Linuxではドライバアーカイブがwhole-archiveされます。ドライバの仕事はカテゴリを通じて到達され、カテゴリはリンカが見えないメッセージ送信だからです——それが修正されるまでCLIはMySQLで中止しました(Linux/README.mdのcompat-archive注記参照)。

CLIが追加したGNUstepの差異: ディレクトリ列挙子(-enumeratorAtURL:…は含むディレクトリを剥がしたURLを返す——測定済みで、CLIのメンバーリストは代わりに-subpathsAtPath:を使う)、およびSELECTリストの列順。これは集合順で設定されていたためAppleと異なりました(同じフィールド、同じ行。Linux/README.mdに注記)。2026-10-16に解決、JSONエクスポート形状の決定(下の§10.1)とともに: 順序は両方のSQLビルダーで列エイリアスと定義され、生成SQL、行キャッシュ、すべてのエクスポートが両プラットフォームで一致します(docs/project/registers/BUGS.md、SELECTリストのエントリ。Linux/Tests/MADQuerySelectExpressionTests.mの順序テスト)。

Phase Eステータス(2026-10-16、前半)。 エクスポートシームは実在し、Foundation系フォーマットがここで実行されます。MADReportExporting + MADReportExporterRegistryはドライバレジストリの形(実装プロトコル、+load登録、名前によるルックアップ)で、mad exportはそれらを通じてフォーマットを選ぶため、新しいフォーマットは新しいクラスです(MAD_CLI.md §5.3、ROADMAP.md §5.2)。text、csv、jsonは純粋なFoundationで、Londonフィクスチャに対してLinuxとAppleでバイト同一の出力を生成します——Macのツールとイメージのものでsha256sumで測定(Linux/README.mdのCLIセクション。Linux/Tests/MADReportExporterTests.mがFNV-1aチェックサムで同じバイトを固定)。JSON形状は決定済み(§10.1)。jsonはデータ契約——クエリの列をエイリアス順で、行、SQL、ドライバ——であり、json-reportは同じドキュメントにレンダリングされたレポートのセクションを追加メンバーとして加えたもので、2026-10-16のユーザーの選択です。ページ、描画順のセクション、各ラインの種類、フレーム、解決済みテキストを、何も描画しないレンダラー自身のページウォークから構築するため、PDFが示すものからドリフトできません。レンダー半分を必要とするため、どこでも登録され、ここで実行できない理由を報告します。そのウォークはMADPrintPageRenderer -buildPageAtIndex:context:inPageRect:で、NULL可能なコンテキストを取ります。PDFパスは自身のものを渡して以前のように描画し、json-reportはNULLを渡します。レンダー半分の最初のプロトコルMADDocumentRenderProtocolが、フォーマットがドキュメントに求めるものです。Phase Eの残り半分——Linux上のレポートメンバーとHTML/SVG——はレンダー半分のLinuxへの移動であり、ユーザーのレンダラー決定(HTML/SVGが次、PDFが最後、§10.2)がそれをHTMLステップに置きます。pdfは依然としてCLI自身の腕で、その同じステップでエクスポーターになります。


Phase Eステータス(2026-10-16、後半: ライター)。 .madライターはLinuxで実行され、両プラットフォームが同じバイトを書きます。MADArchiveManager.reproducibleはユーザーが選んだオプトインモード(固定時刻2001-01-12T00:00:00Z、uid/gid 0、ソートされたメンバーウォーク。通常の保存はファイルシステムのメタデータを保つ)で、MADHeadlessDocumentが-writeToURL:reproducible:error:を獲得し(UIDocument部分なしのアプリの保存)、mad writeが両プラットフォームでそれに到達する動詞です。測定: Macで書かれたLondonフィクスチャとイメージ内のそれは同じ16,261バイトのファイルで、sha256は09815b24…(SQL entry Phase Aのストア移行が書かれたバイトを変えました。フィクスチャ自体はバージョン1ストアのまま)。Linux/Tests/MADArchiveManagerTests.mがバイト、ラウンドトリップ、モードを固定します。2つのLinux専用不具合が邪魔をし、修正されました(BUGS.md、バイト同一性のエントリ)。終わらないウォークと、glibc上で呼び出し元のアーカイブパスを切り詰めるdirname(3)/basename(3)。比較がカバーするのはコンテナです。メンバーはフィクスチャ自身のバイトです。ストアを作成するLinuxライターはそれをストアレイヤーに拡張します。

Phase Eステータス(2026-10-16、第3部: レンダー半分とHTML)。 レンダー半分はLinuxへ移動し、フォークではなく準拠として移動しました。形状についてのユーザーの答えは「1つのフォーマッタ、2つのパスではなく、同じものをレンダリングすべき」でした。したがって:

ページネーションはテキストエンジンを必要としません、仮定ではなく測定: セクションの表示高はMADSectionLayout(保存された矩形+マージン+パディング+ボーダー)から来て、それはLinuxビルドにありPhase C以降ずっとそうなので、ページブレークはどこでも同じです。テキストメトリクスは要素が描画されるときにのみ入り、レンダラーはNSLineBreakByTruncatingTail——1行、クリップ——で描画し、CSSではwhite-space: pre; overflow: hidden; text-overflow: ellipsisと綴ります。何も折り返さないため、移植する折り返しモデルはなく、フォントエンジンも追加されませんでした。

mad export --format json-reportはここで実行され、同じウォーク上で、報告するフレームは今やページ座標(要素のフレームをそのセクションでオフセットしたもの)であり、レンダラーやブラウザが必要とするものです。

2つの新しいフォーマット、どちらも両プラットフォーム(ユーザーが両方を選択): htmlはファクシミリで、ウォークされたページごとに1つのCSSページボックス、各要素はそのフレームに絶対配置され、解決済みテキストと保存されたフォント、サイズ、特性、配置を持ちます。ブラウザがPDFと同じページに印刷します。html-flowは同じレポートをリフロー可能にしたもので、<section>、セクションごとに<table>、要素ごとに<td>、ページ家具は一度だけ出力します。読むためのビューであり、--format jsonがデータ契約のままです。どちらも埋め込み<style>を持ちスクリプトを持たない1つのUTF-8ファイルで、ファクシミリのCSSは上記20行に配置ルールを加えたもの、フローファイルのスタイルは生成されたクラステーブル(Londonフィクスチャで9クラス)です。

pdfはシーム上にあります: MADReportExporterPDFはどこでも登録されます。Appleでは本体はCore Graphics + MADPrintPageRendererで変更なし、Apple以外では同じウォーク済みページをMADReportExporterPDFCairoに渡し、バンドルされたLiberationフェイスからのFreeTypeグリフでCairo PDFサーフェスに描画します(docs/developers/build/pdf.md)。CLIにはローカルの腕が残っていません。Appleの移動はバイト中立でした。Londonサンプルの決定論的エクスポートは前後で同じ43,177バイト、5ページのPDFです(両方でsha256 3eb2f1c4…)。前のコミットのCLIをビルドして比較して測定しました。ヘッドレスライターはバイト同等性ではなく構造同等性を目標とします。

クロスプラットフォーム比較が言うこと。 すべてのラインのテキスト、すべてのフレーム、すべてのフォント、ページ数、ファイル構造はLondonフィクスチャでAppleとLinuxで同一で、バイトも同様です。html、html-flow、json-reportは両プラットフォームで同じsha256を持ちます(Linux/README.mdにダイジェスト)。そこへ到達するのに1つの発見とその修正がかかりました。レンダリングされた通貨がマシンに依存していました。レポートは今、ロケールと小数桁数をドキュメントの数値フォーマットから取ります(ストアは両方を保ち、述べないドキュメントはマシンのロケールではなくen_USにフォールバックします)。要素ファクトリは新しい要素に設計ロケールを記録し、通貨記号は円記号を正規化して明示的に書かれます(GNUstepは全角で綴ります)。6ロケールにわたる60ケースの比較はバイト同一です。完全なエントリはBUGS.mdのアーカイブにあります。

Phase Fステータス(2026-10-17、一部)。 CLIはビルドツリー内のバイナリではなく、ランタイムイメージとしての成果物です。Linux/Dockerfileはubuntu:24.04上のruntimeステージを獲得し、/usr/local/bin/mad(CMakeのインストールルール)、CLIがリンクする共有オブジェクト(GNUstep Base、libobjc2、libdispatch、libBlocksRuntime、mysqlclient)、GNUstepのランタイムディレクトリ、mysqlclientのメッセージと文字セットファイル、アプリサポートパスのchinook.sqlite3を運びます。コンパイラ、ソース、テスト、ヘッダー、静的アーカイブは残します。ディスク上283 MB(圧縮66.5 MB)で、6.65 GBのビルドイメージに対してです。./Linux/build.sh --runtimeがそれをビルドし、--verifyがその中でLinux/verify-cli.shを実行します。30のチェック——6つの動詞、各オフラインフォーマットの固定ダイジェスト、pdfの拒否、再現可能ライターのバイト、終了コード、イメージ自身の形状(clang、cmake、git、ビルドツリーなし)。2026-10-17にグリーン。--liveはMySQLとTDSのリフレッシュを追加します(32/32)。スイートはまた、Londonフィクスチャとサンプルデータベースを共有する2つのテストバイナリ間にRESOURCE_LOCKを得ました——ctestの並列性がそのペアを断続的に失敗させていました(ロック後35回連続グリーンの並列実行)。

同日のユーザーの決定: CIなし(Linuxポートは概念実証と反復可能なテストであり、リリースではない。./Linux/build.sh --verifyがチェック)と公開なし(レジストリから何もプルされないため、GPLの問いは§10.3が残した場所に留まる)。Compressor LinuxドライバはPhase Fで唯一未完了の部分で、CLIには不要です。イメージはCライブラリをネイティブにビルドするからです。

10. ユーザーのための決定

  1. JSONエクスポートの形(MAD_CLI.md §8.3、MAD_FUTURE.md §10.5)——これがPython契約です。最初に決めてください。§2のすべてがそれに依存します。2026-10-16に決定: 両方、レポート半分は独自のフォーマットとして。 --format jsonはデータ契約——エンベロープ(フォーマットID、ドキュメント/ドライバ、SQL、行数)、columns(キー、名前、テーブル、型)、およびrowsを行ごとに1オブジェクト、JSON型の値で——であり、--format json-reportはそのドキュメントにreportメンバー(レンダリングされたセクション)を加えたものです。それによりSELECTリストの順序は列エイリアスをソートしたものと定義され、生成SQL、行キャッシュ、すべてのエクスポートが両プラットフォームで一致します(docs/project/registers/BUGS.md、SELECTリストのエントリ——以前は集合順)。データ半分は構築済み(MADReportExporterJSON、両プラットフォーム)。レポートメンバーはレンダー半分を待ちます。
  2. レンダラーの段階分け — HTML/SVGが先、PDFが最後、それともmacOS側PDFワーカー? 2026-10-16に決定: HTML/SVGが次、PDFが最後。 Linux PDFレンダラーなし、macOS側ワーカーなし。HTMLステップはレンダー半分(MADReportFormatter)がLinuxへ移動する場所でもあり、json-reportとテストもそれを望みます。pdfはそれまでCLIのApple側の腕のままです。2026-10-16に完了(HTMLステップ)。 レンダー半分はLinux上にあり、mad exportにはローカルの腕がありません。pdfは登録されたエクスポーターで本体はAppleのもので、Apple以外では理由を述べます。同日のユーザーのさらなる決定: Linux PDFライターは次のステップであり、この一部ではありません。HTMLファクシミリのページボックスはLinuxライターが再現してテストにしなければならないジオメトリだからです。ライターの形はそのステップのためにここに記録されます。Cairo(描画、PDFサーフェス)+ Pango(レイアウト、折り返し)+ FreeType/HarfBuzz、GTK/WebKit/Firefoxが使うスタックで、LinuxがCore Graphics + Core Textに最も近いもの——Objective-Cから呼ばれるC APIで、freetdsやsqlite3がすでにそうであるように、Implラッパーは不要です。ライセンス: CairoはLGPL-2.1/MPL-1.1デュアル、PangoはLGPL-2.1、HarfBuzzはMIT、FreeTypeはFTL/GPLv2デュアル。プロジェクトはすでにLGPL(FreeTDS、LICENSE_COMPLIANCE_PLAN.md §4)を出荷し、Linuxイメージはサーバービルドなので、既知の種類の義務です。libharuは寛容な代替だがレイアウトエンジンがなく、Skiaは能力が最も近いが重いC++ビルドです。達成不可能: プラットフォーム間でバイト同一のPDF——Core Graphicsのライターは再現できません——そのため目標は同じページ、ボックス、テキスト、フォントで、Appleのフォントにはメトリクス互換の代替を使います(MADFontのデフォルトファミリはHelvetica Neueで、Linuxにはありません)。2026-11-20に完了(PDFクロージャ)。 スタックはCairo(PDFサーフェス)+ FreeTypeで、Pangoなしです。ウォークが各ラインにフレーム、テキスト、フォント、サイズ、特性、配置を渡すため、レイアウトは不要で、必要なのはグリフのアドバンスとフェイス自身のkernテーブルだけで、FreeTypeが供給します。Cairo 1.18.6(MPL-1.1)とpixman 0.46.4(MIT)は静的ビルドされ、Liberationフェイス(SIL OFL 1.1)がAppleフォントの代替です。MAD_PDF_LINUX.mdが着地したもの、フォントマッピングポリシー、測定された残差を記録します。目標は構造的なままです。Core Graphicsのバイトは再現できません。
  3. mysqlclient → MariaDB Connector/Cのタイミング — GPLブロッカーは出荷されるあらゆるバイナリをゲートします。代替はLICENSE_COMPLIANCE_PLAN.mdですでに名指しされています。
  4. ツールチェーンポリシー — ソースビルドのclang/libobjc2/GNUstep(ARCに必要)はメンテナンスコミットメントです。受け入れるか、macOSホストに留まってください。
  5. 書き換えトリガー — §9のPhase Dが測定可能なチェックポイントです。それが失敗するまで推奨は維持されます。1つのObjective-Cエンジンを、CLI境界を越えてPythonから呼びます。
  6. ビルドベースライン — Debian-stableかUbuntu-LTSベースのDockerで、macOSからクロスコンパイルするのではなくLinux上でビルドします(§8.1)。選択がサポートされるglibcの下限を設定するため、一度だけ意図的に決めてください。

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