MAD Designer iconMAD

WindowsでのMADエンジンのコンパイル — アーキテクチャと決定記録

このページはWindowsエンジンビルドを記録します。固定されたツールチェーン、フレームワークの移植とそのシム、およびWindows/Engine/build.ps1エントリポイントです。アプリケーションガイドは/windows.htmlにあります。

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

2026-11-18、Windows PoCのPhase 2であるwindows-engineブランチのためにmasterに対して書かれました。WindowsビルドはLinux/の兄弟です。ヘッドレスエンジンのObjective-Cフレームワークを、ClangでGNUstep Baseに対してWindows上でネイティブにコンパイルし、macOSアプリとLinux CLIを動かす同じエンジンがWindowsでも動くようにします。このドキュメントはLinux/README.md / docs/developers/build/linux.mdの技術的コンパニオンであり、ツールチェーンレシピ、各ピースを固定する理由、この増分が下した決定を記録します。


1. これが何であり、何でないか

ターゲットは、既存のヘッドレスObjective-CエンジンをWindows向けにネイティブにコンパイルして再利用する、ネイティブWindows MAD Designer(.NET 10 LTS上のWPF)です。エンジンビルドはWindows/の下に着地し、Mac/とLinux/の兄弟です。WPFアプリはPhase 5〜6f(Windows/App、§6e〜§6i)で続きました。

Phase 2bの増分はツールチェーンとフレームワークの移植を証明しました。Phase 2(最初の増分)はMADDataStructuresとMADFoundationをビルドし、スモークテストを実行しました。Phase 2bはMADAPI(MADSqlite3が引き込む推移的依存)とMADSqlite3を追加し、固定されたSQLiteアマルガメーションを静的ライブラリにコンパイルし、MADDataStructures、MADFoundation、MADSqlite3のLinuxテストスイートをポーティングしました(GNUstep Testing.h + MADTestSupport.h)。残りのヘッドレスフレームワーク、CLI、アプリはまだビルドしていませんでした。


2. ツールチェーンレシピ、および各ピースを固定する理由

要約(このセクションは単独で成り立ちます):

2.1 コンパイラ: Clang 20.1.8

Phase 1の起動クラッシュ(すべてのFoundationバイナリで0xC0000005)は、フローティングmasterのGNUstepコンポーネントにおけるランタイム回帰——§2.3の7つのピンがそれを修正します——であり、Clang 23のコード生成バグではありませんでした。Clang 20.1.8はCIでテストされたコンパイラであり、証明済みレシピの一部です。ピン付きのClang 22/23はテストされていません。これはピンであり、好みではありません。新しい実現可能性テストなしにLLVMをアップグレードしないでください。

2.2 STLゲートのオーバーライド

このマシンはVisual Studio 2026(18.12.0)を搭載し、そのMSVC STLは「Clang 22以降」をハード要求します(_MSVC_STL_UPDATE 202609L、yvals_core.h:923)。

#elif defined(__clang__)
#if __clang_major__ < 22
_EMIT_STL_ERROR(STL1000, "Unexpected compiler version, expected Clang 22 or newer.");

オーバーライド-D_ALLOW_COMPILER_AND_STL_VERSION_MISMATCHはSTL自身のエスケープハッチです。無害であることが証明されています。<map>を使うC++プログラムはClang 20.1.8 +オーバーライドでコンパイル・実行でき、ツールチェーン全体とMADの.mmファイル(<map>/<vector>を含む)も同様です。ツールチェーンビルド(Engine/toolchain/stl-gate-override.patch)と、フレームワークビルドのすべてのObjective-C++翻訳単位に適用されます。

2.3 7つの固定されたGNUstepリビジョン(フローティングmasterの回帰)

gnustep/tools-windows-msvcはすべてのコンポーネントの最新masterをクローンします(フェーズスクリプトでTAG=が空です)。そのCI(.github/workflows/ci.yml)はツールチェーンをビルドしてパッケージしますが、バイナリを決して実行しないため、ランタイム回帰が見逃されました。A/Bテストがそれを分離しました。

コンポーネント 11-14(動作) 11-17/18 master(クラッシュ)
libobjc2 a21ae931 762f9d7
gnustep-base 24654296 ff647838
libdispatch 22798930 20b4c8b2
gnustep-make e7c0730d 8fa108c7
libffi v3.8.0 v3.8.1
libiconv v1.19 (a536e24a) v1.19.1

修正は、7つの既知の良好な11-14リビジョンを固定することです(Engine/toolchain/revision-pins.patch)。ドライバ自体もコミット54d08e57に固定されています(そのmasterはフローティングで、追跡してはなりません)。両方の事実はWindows/Engine/toolchain.confに記録されています。

2.4 ビルドラッパーの3つの非自明な要件

ツールチェーンのbuild.batはvcvars64開発者環境から、BASHをMSYS2のシェルに設定して、build.batの絶対パスで、PATHを編集せずに実行しなければなりません(vcvars64のPATHは約2500文字で、cmdの裸名解決を壊します)。Git Bashからはcmd //cでcmdを呼びます(cmd /cではなく)。PowerShellからはcmd /cが正しいです。Engine/toolchain/bootstrap.ps1が3つすべてをカプセル化します。


3. ビルドエントリポイント

Windows/Engine/build.ps1はリポジトリからレシピを再現します。

  1. 前提条件チェック — Clang 20.1.8、lld、CMake、Ninja、MSYS2、git、curl、tar、llvm-lib、VS 2026、Windows SDK、NASM。
  2. 冪等なツールチェーンブートストラップ — Engine/toolchain/bootstrap.ps1が固定ドライバをクローンし、2つのパッチファイルを適用し、GNUstepをソースからC:\GNUstepにビルドします(設定可能。初回実行で約20〜30分)。
  3. SQLiteライブラリビルド — Engine/libraries.confから3.53.3アマルガメーションをダウンロードし、sha256を検証し、展開し、Compressor/sqlite3.xcconfigのオプションリストでsqlite3.cをコンパイルし、llvm-libでCOFF sqlite3.libにアーカイブします。
  4. フレームワークビルド — MADDataStructures、MADFoundation、MADAPI、MADSqlite3(およびEngine/Compatシム)をコンパイルします。
  5. テストビルド — ポーティングされたテストファイルごとに1つの実行ファイル(およびスモークテスト)をコンパイル・リンクします。
  6. テスト実行 — スモークテストとすべてのスイートを実行し、失敗があれば非ゼロで終了します。

フレームワークのコンパイルフラグはLinuxビルドのDebugプロファイルに一致します。--enable-debug-by-default下のGNUstepのgnustep-config --objc-flags(Linuxツールチェーンが使う)は-DDEBUGを運ぶため、build.ps1はすべての翻訳単位——ライブラリもテストも——に-DDEBUG=1を渡し、NS_BLOCK_ASSERTIONSを定義しません。Linuxとまったく同じようにNSAssertをアクティブに保ちます。

決定 — build.ps1はCMakeを通さずClangを直接駆動する。 Windows上のCMakeのObjective-C言語サポートは、このレシピが必要とする組み合わせ(GNUドライバのclangがx86_64-pc-windows-msvcをターゲット)で壊れています。そのObjective-CリンクプローブはGNU-ldフラグ(--out-implib、-nostdlib、-nostartfiles)をlld-linkに渡し、-lですでに接頭されたライブラリ名に.libを追加するため、リンクが失敗します(undefined symbol: $_OBJC_CLASS_NSObject、およびObjCメタデータのセクションGCエラー)。証明済みレシピは直接のclang呼び出し——実現可能性フェーズのcompile-mad.sh / link-and-run.sh——であり、build.ps1はそのレシピを掃除して冪等にしたものです。フレームワークごとのソースリストは依然としてEngine/cmake/<Name>Sources.cmake(正規のCMake対応インベントリで、除外理由付き)にあり、build.ps1はそれを読み戻すため両者はドリフトできません。CMakeのWindows Objective-Cサポートが着地すれば、実際のCMakeビルドがそれらを変更なしで消費できます。


4. 何がコンパイルされ、Windowsシムは何か

フレームワーク Windowsビルド 除外、および理由
MADFoundation 27中26(+ madlib.c) MADKeyChain(Security.framework。Linuxですでに除外)とBDHost(POSIXソケットの逆引きDNS——sys/socket.h/netpacket/packet.h/ifaddrs.h/arpa/inet.h。Winsock2ポートが必要)。アンブレラはMADKeyChainとともに除外
MADDataStructures 17すべて (madmap.cppはXcodeターゲットにもない)
MADAPI 11中8 3つの接続ビューコントローラ(MADConnectionViewController、MADConnectionSQLGenericViewController)——UIKitで、ヘッドレスではない。Phase 2b独自の成果物ではなく、MADSqlite3の推移的依存
MADSqlite3 26すべて Xcodeターゲットにもない5つの孤立.mファイル(Engine/cmake/MADSqlite3Sources.cmakeに名指し)

Windows/Engine/Compat/はLinux/Compatのコピーで、Windows向けに適応されています。

他のLinuxシムは変更なしで引き継がれます。WindowsとLinuxのGNUstep-baseは同じ1.31.x系だからです。


5. 避けられない共有ソース変更

2つの共有ソース変更が必要で、どちらも最小かつポータブルでした(Linux CIとAppleスイートがゲートです)。

5.1 madlib.cのitoa/ltoa/ultoa名前変更

MADFoundation/Source/madlib.cはitoa/ltoa/ultoaを定義し、Windows UCRTの同じ綴りの3引数非標準名と衝突します。それらはmad_itoa/mad_ltoa/mad_ultoaに名前変更され、すべての呼び出し元が更新されました。

これは純粋な機械的名前変更で、AppleとLinuxで振る舞い中立です。uitoa、reverse、count_digits、count_digits_ulは触れられません(UCRTと衝突しません)。MADExplorerのitoa参照はコメントアウトされたブロック内にあり、呼び出し元ではありません。

5.2 高速列挙のカーソルポインタ

MTStack.m、MTQueue.m、MTLinkedList.mはcountByEnumerating…カーソルノードポインタをNSFastEnumerationState.extra[0]にunsigned longでキャストして保存します。それはWindows(LLP64)では32ビットですがLinux/Apple(LP64)では64ビットなので、ポインタが切り詰められ、マルチバッチ列挙(1つのスタックバッファ分を超える任意のコレクション)がクラッシュするかゴミを返しました。3つのファイルは今、ポインタをmemcpyでextraにコピーし(LP64とLLP64の両方で正しい)、__unsafe_unretainedローカルに保持します。コレクションがノードチェーンを所有し、それが呼び出しより長く生きるため、借用ポインタがすべてのプラットフォームで正直な所有モデルです。変更はApple/Linuxで振る舞い中立です(同じポインタバイトが通ります)。


6. 既知のギャップと次の増分

このセクションは当時のPhase 1/2のギャップを記録します。Phase 3a〜6eが受け入れ済みのものを除いてすべてを閉じました。§6b〜§6h、および現在の状態についてはWindows/README.mdを参照してください。

6b. Phase 3a — フレームワーク、アーカイブスタック、およびCLI

Phase 3aは残りのヘッドレスフレームワーク、.madコンテナのCライブラリ、およびmad.exeをビルドします。

6b.1 2つのWindows専用ランタイム修正(Phase 3a最終)

6b.2 テストインベントリ

コピーされたMAD/MADFileManager/MADCocoaExtensions/MADAPIスイートがbuild.ps1に配線されます(フィクスチャパスはWindows/Engine/Tests向けに適応): 107のポーティング済みスイート + スモークテスト、966テスト、6ニーズ、5スキップ、0失敗。6つのニーズはLinuxイメージのプラットフォームギャップに一致します。MADDirectoryMonitorTests(3——Windowsモニタは不活性)、MADStoreTests(1——Core Data + MAD.momd)、RptqStoreContextTests(2——コンバータ/ドキュメントパス)。Phase 3bドライバを必要とする4つのMADスイートは延期され、build.ps1に記録されます。MADDatabaseDriverDispatchTests、MADQueryFullTests、MADSQLParserTests、MADQueryMaxFieldLengthTests。5つのスキップはデフォルトスケールのSQLiteベンチマークです。

追加のWindows Compatシムはunistd.h、dirent.h、libgen.h、sys/{unistd,fcntl,inotify}.h、加えてMADCompat.hがstrlcpy、S_IS*/S_IR*モードマクロ、ssize_t/mode_t、M_PI、arc4random、gmtime_rを得ます。追加の最小限の共有ソース変更(すべて#if __APPLE__セーフまたはLinuxでバイト中立。Linux CIとAppleスイートがゲート):

6c. Phase 3b — ドライバ、BDHost、およびライブフィクスチャ

Phase 3bは4つのデータベースドライバと、それらがリンクするCライブラリを追加します。

6d. Phase 4 — stdio JSONプロセス契約

Phase 4はmad serveを追加します。WPFシェルが使う長命プロセス境界です。標準入力で改行区切りJSONを読み、リクエストごとに1つの改行区切りJSONレスポンスを標準出力に書きます。診断は標準エラーに留まるため、2つは決して混ざりません。ワイヤ形状は並行するものを発明するのではなく、プロジェクトの既存JSON契約を再利用します。

リクエスト/レスポンス — 行ごとに1つのJSON値、UTF-8、\n終端:

request:   { "id": <int|string>, "method": "<name>", "params": { … } }
ok:        { "id": <id>, "ok": true,  "result": { … } }
error:     { "id": <id|null>, "ok": false, "error": { "code": <int>, "message": "…" } }

idはクライアントが選び、相関のためにエコーバックされます。不正なリクエストは"id": nullで答えます。error.codeはCLIの終了コード(MADCLI.h)です。1は使用法/プロトコル、2は悪いドキュメント、3はデータベース到達不能、4はクエリ失敗、5はエクスポート失敗。不正な行、不明なメソッド、欠けたパラメータ、予期しないエンジン例外はすべてok: falseとメッセージで答え——トレースバックは決して返さず——セッションは動き続けます。

メソッド:

メソッド パラメータ 結果
open path、任意のhost/port/database handle、filename、driver
create path、driver + 接続フィールド、任意のcredentials handle、filename、driver(作成されたドキュメント)
test-connection driver + 接続フィールド、任意のcredentials tableCount
describe handle driver、columns(key/name/table/type)、tables(名前+フィールド)
connection handle driver + file/host/port/database/server
apply-connection handle、driver + 接続フィールド、任意のcredentials {}
query handle sql
query-model handle driverトークン、sql、sqlSourceText、tables/links/predicates/groups(ストア識別子付き)
add-table handle、table(スキーマ名) 完全なquery-model
remove-table handle、table(クエリテーブルID) 完全なquery-model
add-link handle、leftField、rightField(フィールドID) 完全なquery-model(デフォルトはLeft Outer Join)
set-link-type handle、link、type 完全なquery-model
swap-link handle、link 完全なquery-model
delete-link handle、link 完全なquery-model
add-predicate handle、leftField、operator、value 完全なquery-model
remove-predicate handle、predicate 完全なquery-model
add-group handle、field、sort 完全なquery-model
remove-group handle、group 完全なquery-model
validate-sql handle、sql tables、links、predicates、groups(プランのカウント)
apply-sql handle、sql tables、links、predicates、groups
refresh handle、任意のrows/credentials rowCount、elapsed
export handle、format、任意のpath/deterministic format + data(エクスポーターのバイト)またはpath + bytes
write handle、out、任意のreproducible path、bytes——ライブドキュメントをシリアライズ
shutdown — {}、その後プロセスは0で終了
接続メソッド(create、test-connection、connection、apply-connection)はdriverトークン——sqlite3 mysql sqlserver postgres——とドライバ固有フィールドを取ります。SQLiteはfileを、サーバードライバはhost/port/database(SQL Serverは任意のserverインスタンスも)を取り、加えて既存のcredentials(user:password)文字列を取ります。それらはエンジンのcreateDocumentAtURL:、MADDatabase(connect/getTables/close)、applyDatabaseConnection:を再利用します——Macの接続ウィンドウが呼ぶのと同じ呼び出しです。

exportはエクスポートシーム(MADReportExporting / MADReportExporterRegistry)であり、新しいスキーマではありません。format: "json"はmad export --format jsonが書くのと正確に同じmad.report/1バイト(MADReportExporterJSON——columnsとrows)を返し、format: "csv"はRFC 4180バイトを返します。このビルドが生成できないフォーマット(例えばApple以外のpdf)はエクスポーターの理由とともにerror.code 5で答えます。describeのcolumnsは同じmad.report/1列(MADReportExportSource)で、そのtablesはmad schemaが出力する保存されたデータベーススキーマです。openはhost/port/databaseを単発動詞と同じように適用するため、チェックインされたドキュメントをセッションのために別のサーバーに対して実行できます。writeは今sourceURLを再オープンするのではなくライブセッションドキュメントをシリアライズするため、セッション内で適用された接続が永続化されます。標準入力のEOFはクリーンなシャットダウンで、shutdownも同様です。

query-model/add-table/…/apply-sqlメソッドはPhase 6bのQueryワークスペース拡張です。元のserve契約はクエリを生成されたsqlとしてのみ公開し、MacはRptqQueryオブジェクトをインプロセスで変更してそれを導出します。WPFアプリにはそのようなインプロセスのハンドルがないため、これらのメソッドがそのギャップを閉じます。query-modelは完全なクエリモデル——テーブル/フィールド/リンク/述語/グループとそのストア識別子、入力されたsqlSourceText、ドライバトークン——を読み、すべての変更メソッドが同じ形で答えるため、クライアントはスナップショットをアトミックに置き換えます。変更はMacのMADMacQueryViewControllerが使うのと同じファクトリとMADSQLQueryDocumentヘルパーを呼び(newQueryTableForSchemaTable:、newQueryLinksWithLeftField:、addQueryGroupWithQueryField:、removeGroupWitObjectID:、……)、validate-sql/apply-sqlは既存のMADSQLParser → MADSQLStatementResolver → MADSQLQueryCompilerパスを変更なしで実行します。queryは今、全フィールドSQLを先に返し、アクティブフィールド選択にフォールバックします。MacのgeneratedSQLString:に一致するため、レポート要素のない新しいドキュメントでもSQLを生成します。

クライアントとテスト。 Windows/Client/は.NET 10コンソール受け入れクライアント(Mad.Client)とxunitスイート(Mad.Client.Tests)を保持し、どちらもWindows/global.jsonで固定されています。クライアントはmad serveを起動し、7つのメソッドをカバーします。テストはCLI/Fixtures/London.portable.mad上の成功パス(open → describe → query → refresh 76行 → export json/csv → shutdown、終了0、孤児プロセスなし)、不正なリクエスト、不明なメソッド、悪いドキュメント、利用不可のフォーマット、プロセスシャットダウンを行使します。

6e. Phase 5 — WPFシェルの証明

Phase 5はPhase 4のプロセス境界の上に最初のWPFアプリを追加します。Windows/App/のnet10.0-windowsシェルで、エンジンが実際のUIから動くことを証明します。Mad.Clientを変更なしで再利用し、非同期EngineService(SemaphoreSlimがシングルスレッドのラインプロトコルを直列化し、すべてのブロッキング呼び出しがスレッドプールで実行)、手作りのMVVMレイヤー(ObservableObject、RelayCommand、AsyncRelayCommand)、および最初のスライスのためにMacのMADMacDocumentをミラーするDocumentViewModelを追加します。open → describe → query → refresh → export。

シェルは3ワークスペースのフレーム(MAD Query / Designer / Viewer)を持ちます。Queryは保存されたスキーマと生成SQLを表示し、Viewerはリフレッシュされた行をDataGrid(mad.report/1をDataTableにパースして供給)で表示しCSV/JSONをエクスポートし、DesignerはPhase 6のプレースホルダです。起動時にCLI/Fixtures/London.portable.madを自動オープンする(MAD_DOCUMENTで上書き)ため、ゼロクリックでデモできます。Aboutウィンドウ(Overview / License & Notice / Acknowledgements)はThirdParty/Licenses/Windows/のWindows依存レジスタと再リンクの申し出をレンダリングします——Windowsのコンポーネント集合であり、Appleのものではありません。

受け入れはWindows/App/Mad.Designer.Windows.Tests(xunit)でヘッドレスに検証されます。open London → describe(21列 / 11テーブル / ドライバ”Sqlite 3”)→ refresh 76行 → export json(76行)/ csv(78行)→ 孤児なしのクリーンシャットダウン、加えてmad.report/1パーサとライセンスレジスタチェック。アプリとテストはnet10.0-windowsでビルド・実行されます(Windows/global.jsonで固定)。Linux CIは影響を受けません(.NETを決してビルドしない)。

6f. Phase 6c — レポートレイアウトモデル(Designer)

Phase 6cはserveをDesignerワークスペースが編集するレポートレイアウトモデルで拡張し、6bのクエリモデルメソッドと同じ粒度パターンを使います。layout-modelは完全なスナップショットを読み、すべての変更メソッドが既存のRptqDocumentSection/RptqDocumentElementオブジェクトを変更して同じスナップショットで答えるため、クライアントは状態をアトミックに置き換えます。バーコードはモデルの一部です(バーコードクロージャ増分が要素種別、そのコンテンツ編集、シンボロジカタログ、エンジンレンダリングのプレビュー、WPFコンポーザを追加——§6j。画像クロージャはPNGコンテンツとWPFファイルピッカーで続いた——§6k)。色は延期されます(ヘッドレスモデルにポータブルな色型がない)。元に戻す/やり直しはクライアント側です。

メソッド パラメータ 結果
layout-model handle paperSize、sections[]、elements[]、fields[]
add-element handle、kind(label|data-field|aggregate|image|line|barcode)、section、x、y。画像の場合はdata(base64 PNG) 完全なスナップショット
remove-elements handle、elements: [id…] 完全なスナップショット
duplicate-elements handle、elements: [id…] 完全なスナップショット
move-elements handle、elements: [id…]、section 完全なスナップショット
set-element-geometry handle、elements: [{id,x,y,w,h}…] 完全なスナップショット
set-element-content handle、element、content{text,field,function,scope,group,barcodeType,humanReadable,borderStyle,data}(dataは画像のbase64 PNG。空はクリア) 完全なスナップショット
set-element-typography handle、elements: [id…]、style{fontname,fontsize,bold,italic,underline,strikethrough,hAlign,vAlign} 完全なスナップショット
set-element-box-model handle、elements: [id…]、box{borderTop,borderBottom,borderLeft,borderRight,padding,margin} 完全なスナップショット
set-section handle、section、{height,visible,pageBreak} 完全なスナップショット
set-paper-size handle、paperSize(MTPaperType int16: Letter 2 / Legal 7 / A4 19) 完全なスナップショット

スナップショットはセクションをデザイナの正規順(Report Header、Page Header、Group Headers、Detail、Group Footers、Page Footer、Report Footer)で運び、それぞれid、type(MADocumentSectionType)、title、height(インターフェース高layoutHeight)、visible、pageBreak、groupFieldを持ちます。各要素はid、type(MADPrintPageElementType)、section、x/y/w/h、text、field(バインドされたクエリフィールドID)、table/column、function/scope/group(集計)、fontname/fontsize、bold/italic/underline/strikethrough、hAlign/vAlign、borderTop/borderBottom/borderLeft/borderRight、padding、marginを持ちます。バーコード要素はさらにネストされたbarcodeオブジェクト(§6j)を運び、画像要素はimage{data}、保存されたピクチャをbase64 PNGとして運びます(持たない場合は空——§6k)。fields[]はサイドバーブラウザとバインディングポップオーバーのためにクエリフィールド(ストアID付き)を一覧します。

6g. Phase 6d — Viewerワークスペース(レンダリング、ページサイズ、エクスポート、印刷)

Phase 6dは6a〜6cのシェルの上にMAD Viewerを完成させます。Macビューアはページ分割PDFをPDFViewでレンダリングしますが、WindowsにはPDFKitがないため、プレビューはエンジンのHTMLファクシミリをレンダリングし、PDF自体はエクスポート時にエンジン自身のエクスポーターが書きます(§6l)。

ViewerはPhase 5のプレースホルダ行グリッドを置き換えます。レンダリングされたレポートがワークスペースであり、Macと同じで、行はCSV/JSONエクスポートを通じて引き続き利用できます。

テスト。 ViewerViewModelTests(ステータス文法、フォーマットカタログ、ページカウント、ズーム、ナビゲーション、印刷リクエスト)、ViewerSurfaceTests(STAスレッドで具現化されたワークスペース——ツールバー、7つのフォーマット、ページサイズセレクタ、ステータス色、ページラベル)、およびエンジンに対するViewerAcceptanceTests(London → 5ページ / 76キャッシュ行、A4を通じたページサイズロックと永続化でエクスポートされたページボックスが595 × 842、各エクスポートフォーマットとその拡張子、PDFは%PDF-シグネチャでチェック、スペースと非ASCII文字を含むパスへのエクスポート、PDF書き込み中に設定され後にクリアされるexporting状態、A4 → Legal → Letterの用紙サイズ切り替えが各エクスポートに届く)。

6h. Phase 6e — About、ローカライゼーション、およびWPFスモークテスト

Phase 6eはエンジンを変えずにマージゲートを閉じます。Aboutウィンドウの依存レジスタを完成させ、WPFアプリをMacアプリの言語集合にローカライズし、MADMacSmokeTest.mのWPF対応物を追加し、この記録とWindows/README.mdを最新にします。公開docs/windows.mdとその翻訳は設計上延期されます。

AboutとWebView2の通知。 ViewerプレビューはMicrosoft Edge WebView2コントロール(NuGet Microsoft.Web.WebView2 1.0.4314.35)で実行されます。アプリに同梱されるSDKはBSD-3-ClauseでMicrosoftのサードパーティ通知を運び、Evergreen WebView2 RuntimeはMicrosoftの再頒布可能物でありオープンソースソフトウェアではありません。したがってAboutウィンドウはMicrosoft Edge WebView2を両方の条項とランタイムの帰属とともに一覧し、すべてThirdParty/Licenses/Windows/WebView2-LICENSE.txtにあります。レジスタはdocs/project/THIRD_PARTY_LICENSES.md §10です。残りのコンポーネントリストは変わりません(GNUstep Base、gnustep-corebase、libiconv、libobjc2、libdispatch/BlocksRuntime、libffi、およびCライブラリ)で、LGPL再リンクの申し出は依然としてWindowsエンジンを名指しします。WPFアプリはAppleの集合を決して表示しません。

ローカライゼーション。 すべてのユーザー向け文字列はWindows/App/Mad.Designer.Windows/Resources/のWPF ResourceDictionaryに存在します。Strings-en.xamlが権威あるソースで、Strings-de.xaml、Strings-es.xaml、Strings-ja.xaml、Strings-pt-BR.xaml、Strings-zh-Hans.xamlがMacアプリの言語集合をミラーします(MAD_APP_LOCALIZATION.md D1/D9)。辞書はメインアセンブリに埋め込まれ(コンパイルされたPage項目でもサテライトアセンブリでもない——Strings-de.xamlのハイフンがMSBuildに言語コードをカルチャサフィックスとして読ませないようにします)、Infrastructure/Localizer.csがXamlReaderでそれらをロードしGet/Formatを提供します。XAMLはロード時に解決される{infra:Loc Key}マークアップ拡張を通じてそれらを消費し、コードビハインドとビューモデルはLocalizerを呼びます。言語は起動時にOS UIカルチャに従い(de、es、ja、pt-BR、zh-Hans。それ以外は英語)、検査のためにMAD_LANGUAGEが上書きします。

$env:MAD_LANGUAGE = "de"
dotnet run --project .\Windows\App\Mad.Designer.Windows\Mad.Designer.Windows.csproj

翻訳は英語ソースが一致する場合MacのLocalizable.xcstringsを再利用し、その後機械支援ポリシー(MAD_APP_LOCALIZATION.md D14)に従います。About Overviewは各言語で翻訳が機械支援であり誤りを含む可能性があるという通知で終わります。Aboutのクローム、接続アシスタント、クエリ/デザイナ/ビューアのツールバーとステータス行、ダイアログ、バンド名は翻訳され、ライセンス本体、コンポーネント通知、LGPL再リンクの申し出、著作権、ブランド名は逐語的な英語のままです(D6/§8)。ライセンステキストが元の英語で再現されていることを述べるローカライズされた文が付きます。SQLキーワード、データ型名、フィールド/テーブル識別子は翻訳されず、エンジン自身が返すエラーテキスト(ドライバ失敗、SQLパーサメッセージ)はMacのドライバメッセージと同じく英語のままです。

スモークテスト。 Windows/App/Mad.Designer.Windows.Tests/SmokeTests.csはMADMacSmokeTest.mのビューモデル/サービスレベルの対応物で、ピクセルテストではありません。

  1. London。 CLI/Fixtures/London.portable.madを開き、76行(5ページ)をリフレッシュし、Viewer自身のパスを通じてHTML Page、HTML Flow、CSV、JSON Data、JSON Full Report、Plain Textをエクスポートします。各ファイルのバイト数とSHA-256はLinux/README.mdのMac/Linuxピン(html 285541ed…、html-flow 0565204a…、csv 773f6215…、json 569c6ee2…、json-report 9d01d0da…、text 7dcee96c…)に対してアサートされます。
  2. 新しいドキュメント。 chinook.sqlite3から.madを作成し、MacのSQLステートメント(SELECT Customer.FirstName, Customer.LastName, Customer.City FROM Customer WHERE Customer.Country = 'United Kingdom';)を適用し、静的ラベル、LastNameにバインドされたデータフィールド、レポートスコープのCOUNT集計を追加し、リフレッシュし、利用可能なすべてのフォーマットをエクスポートしてJSON行数とHTMLページ数をチェックします。

Viewerは両方のテストでエンジンのパスエクスポートを通じてPDFをエクスポートし、スモークテストはテキストとして読むのではなく%PDF-シグネチャをチェックします。スイートはアプリの他のテストとともにヘッドレスで実行されます。Windows/README.mdを参照してください。

6i. Phase 6f — テーマ、シェル、およびユーザビリティパス

Phase 6fはプレゼンテーションのみです。エンジン、プロトコル、ドキュメント、ワークフローの変更はありません。デザインレビューが報告した2つの機能的不具合を修正し、既存の3ワークスペースアーキテクチャ全体に1つのFluentにインスパイアされたデザインシステムとシェルを適用します。(テーマパスはマージゲートの一部ではなく、それに続きます。)

修正された不具合。 Help ▸ Aboutがプロセスを終了しました。Aboutウィンドウの読み取り専用Overview、LicenseNotice、SelectedAcknowledgementがTextBox.Textにバインドされ、そのデフォルトバインディングモードがTwoWayで、バインディングがウィンドウの最初のレイアウト中にInvalidOperationExceptionを投げました。バインディングは今OneWayで、AboutWindowTestsがウィンドウを表示して固定します。Designerのドラッグ不具合はZオーダーでした。各バンドの不透明な背景がその要素とともに追加されたため、後のバンドにドラッグされた要素がそのバンドの下に描画され、ドロップがキャンバスを再構築するまで消えました。リサイズハンドルも古い位置に留まりました。ドラッグされた要素は今すべてのバンドの上に描画され、ドラッグ中はハンドルが隠れ、選択クロームは再構築ではなくその場で更新され、ScrollViewerのオフセットは再構築をまたいで保たれ、ドラッグの計算はズーム2でビューをスクロールした状態で固定されます。

デザインシステム。 Themes/Theme.xamlが単一のリソースセットです。タイポグラフィ(Segoe UI Variable Text/Display、Fluentサイズ)、スペーシング、コーナー半径、サーフェス、コマンドとナビゲーションのスタイル、プライマリ/セカンダリボタン、セグメント化トグル、フォームとカードのスタイル、セマンティックステータス色。クロームブラシはFluentの動的リソースキーなので、ライト/ダーク、ユーザーのアクセント、ハイコントラストがシステムに従います。App.xamlはThemeMode="System"でネイティブFluentテーマにオプトインします(実験的APIのWPF0001は抑制されます)。レポートドキュメントは独自の固定パレットを保ちます。Infrastructure/DesignPalette.csは紙、要素の色合い、選択アクセント、結合、ミニマップの単一の凍結されたソースです。MAD_THEME=Light|DarkはMAD_LANGUAGEと同様の検査用上書きで、ViewerのWebView2デスクがそれに従います(またはWindowsのAppsUseLightTheme設定)。

シェル。 アプリケーションアイコンは既存のMADアートワーク(Assets/AppIcon.pngとマルチサイズAppIcon.ico)から生成され、ウィンドウ、タスクバー、Aboutのアイデンティティです。レポートなしで起動すると、空のViewerではなくWelcome/Home画面(New report、Open report、最近のレポート、短い紹介)を表示します。3つのワークスペースはアイコン+ラベル、明確な選択状態、Ctrl+1/Ctrl+2/Ctrl+3を持つNavigationViewスタイルの左レールで、Welcome表示中は無効です。新しく作成されたレポートはDesignerで開き、既存のレポートはViewerで開きます。Homeの目的地はありません。3つのワークスペースが第一級のピア集合のままです。FileメニューはNew/Open/Save/Save As/Recent/Connection/Exitを保ち、コマンドバーはNewとOpenを保ちます(AboutはHelpに残ります)。

ワークスペース構成。 接続アシスタントは固定の640 × 660ウィンドウ(リサイズ可能、本体はスクロール)で、グループ化されたカードがドライバ固有のフォームを同じフレーム内に保ちます。SQLite → MySQL/SQL Server/PostgreSQLの切り替えでリサイズされません。Queryはセグメント化されたDesigner/SQLスイッチ、グループ化されたコマンド、テーブルパネルのヘッダーにある通常サイズのAdd tableコマンド、イン/アウト、パーセンテージ、Fitを持つ下部ズームバーを持ちます。Designerは挿入と編集コマンドをグループ化し、ミニマップを左上隅からインスペクタ上部の折りたたまれたExpanderに移し、ズーム/グリッド/スナップ/ルーラーを下部ビューバーに置きます。Viewerはドキュメント/ページ/出力コマンドを上部に、ズーム、ページナビゲーション、ステータス/用紙行を下部に置き、レポートに最大の領域を与えます。

About。 ウィンドウは今2つの異なるアイデンティティを報告します。エンジン(v9.0 (r4433))とWindowsアプリケーション(v0.7)。確定した決定は、エンジンが成熟している一方でWindowsアプリケーションは1.0前であるということです。

アクセシビリティとローカライゼーション。 ナビゲーションとコマンドの表面はツールチップ、アイコンが曖昧な場所のテキストラベル、UI Automation名(アイコンのみのズームとページボタンを含む)、キーボードショートカット、Fluentのフォーカスと無効状態を持ちます。新規または名前変更されたすべての文字列は6つの辞書すべてにあります(LocalizerTestsが完全性とプレースホルダをチェック。英語が権威あるソースのまま)。ライセンス本体、通知、著作権、ブランド名は逐語的な英語のままです。スイートは110テストで、Welcome/ナビゲーション/最初のワークスペースのテスト、Aboutウィンドウ表示テスト、テーマ辞書テスト、クエリズーム/フィットテストを含みます。

リボンの評価。 リボンは導入されませんでした。Designerのコマンド表面は2つのグループ(挿入パレット、編集)とビューバーです。リボンはクロームを追加し、このコマンド数では発見性の向上なしにキャンバス領域を奪います。Designer専用リボンは、要素/コマンド集合が大幅に増えた場合(例えば完全なタイポグラフィ、配置、テーブルレイアウトグループ)にのみ再検討する価値があります。3つのワークスペースは実質的に異なるコマンドを持つため、アプリ全体のリボンはより複雑になり、より単純にはなりません。

未完了(記録、不具合ではない)。 4つ目のHome目的地なし、アプリ内のWelcomeへのクローズなし。ViewerのWebView2デスク色はブラウザ作成時に読まれるため、セッション途中のテーマ切り替えには再起動が必要です。ブリーフで名指しされた参照WPFアプリケーションはワークステーションに存在しませんでした。方向性はMicrosoftのWindows 11デザインガイダンス、ネイティブFluentテーマ、既存のMADアートワークに従い、パレットとスペーシングは簡単な再調整のために一元化されています。公開docs/windows.mdとその翻訳は延期されたままです。

6j. バーコードクロージャ(2026-11-20)

バーコード要素はもはや境界のどちら側のギャップでもありません。

エンジン。 MADBarcodesはここでコンパイルされます(すべてのシンボロジサブクラス。MADBarcodeViewとMADBarcodeCacheはApple専用のまま)。libraries.confからlibpng 1.6.59とzint 2.16.0をリンクします。MADBarcodeのエンコードパスは共有され、-renderedPNGDataはCore GraphicsなしでzintのRGBビットマップをlibpng経由で書くため、ヘッドレスエンジンは同じシンボルを生成します。MADPrintPageElementBarcode、RptqDocumentElementBarcode+Extras、MADDocumentObjectDataReferenceBarcodeはヘッドレスビルドにあり、ページウォークはPNGをMADReportLineRepresentation.imageDataに置き、HTMLファクシミリはそれをデータURIとして埋め込み(入力はaltテキスト)、JSONレポートは"image": trueで名指しします。useStaticInput1/inputStatic1を持つバーコードはその文字列をレンダリングし、バインドされたものはクエリフィールドを読みます。

serve。 add-elementは"kind": "barcode"を受け入れ(Code 128、人間可読、静的MAD-2026、160×48、Macのデフォルト)、layout-modelはネストされた"barcode"オブジェクト(シンボロジIDと名前、オプション、入力バインディング、同じレンダーコアからのbase64 PNG preview)を運び、set-element-contentはシンボロジ、人間可読フラグ、ボーダースタイル、静的かフィールドかのバインディングを編集し、duplicate-elementsはバーコード列をコピーし、barcode-typesはMADBarcodeの名前テーブルを名前順の{id, name}として返します。

WPF。 パレットのBarcodeボタンが1つを挿入し、キャンバスはエンジンのプレビューを描画し(zintが拒否した場合はテキストフォールバック)、インスペクタはシンボロジピッカー、Show text、ボーダーピッカー、入力ピッカー(静的——Textボックスが編集する——またはクエリフィールド)を表示します。DesignerAcceptanceTests.Barcode_InsertEditBindAndUnbindと作成ドキュメントのスモークテストがそれを固定し(HTML/JSONエクスポートがシンボルとそのテキストを運ぶ)、バーコードのないドキュメントのバイトは動かなかったためLondonのバイトピンは変わりません。

ライセンス。 zint(BSD-3-Clause)とlibpng(PNG Reference Library v2)は§10、Aboutウィンドウのコンポーネントリスト、ThirdParty/Licenses/にあります(両方のテキストはすでに存在しました)。

6k. 画像クロージャ(2026-11-20)

画像要素はプレースホルダであることをやめます。ライブラリは追加されませんでした。ストアの画像列はすでにPNGバイトを保持しています。

エンジン。 Apple以外ではMADReferenceImageとMADElementImageはNSData——ストアのワイヤフォーマットそのもの——であるため、モデルはヘッドレス対応で、RptqDocumentElementImage (Extras)はポータブルな-pngData / -setPngData:を得ました。それはすべての場所でバイトをそのまま保存します(Appleの-imageアクセサはUIKit/AppKitが存在する場所で依然としてピクチャをコード/デコードします)。MADPrintPageElementImage -renderedImageDataは保存されたPNGを返すため、MADReportLineRepresentation.imageData——バーコードクロージャのシーム——はピクチャも運びます。HTMLファクシミリはそれをdata:image/png;base64,… URIとして埋め込み、JSONレポートはテキストなしで"image": trueと名指しします。AppleではPDFパスが依然として要素を描画し、-renderedImageDataはnilを返します。それは既存のMacエクスポート振る舞いです。

serve。 add-elementは任意のbase64 "data"付きで"kind": "image"を受け入れ(要素が挿入される前にデコードされるため、不正なリクエストは何も残しません)、layout-modelはネストされた"image"オブジェクト{data}を運び、set-element-contentは"data"(base64 PNG。空はクリア)を受け入れ、duplicate-elementsはピクチャをコピーします。

WPF。 パレットのImageボタンが要素を挿入し、インスペクタは選択された画像にローカライズされた「Choose Image…」ボタンを表示します(Macインスペクタの行)。ピッカーはWICを通じて任意のPNG/JPEGをデコードし、送信前にPNGとして再エンコードします(ImageFileEncoder)。列は常にPNGなので、HTMLデータURIは正直です。キャンバスは保存されたピクチャを描画し、要素にない場合は[Image]プレースホルダにフォールバックします。ImageElementTestsがプロトコル、ピッカーの再エンコード、キャンバスを固定し、作成ドキュメントのスモークテストがエクスポートされたドキュメントに1つを追加します。

6l. PDFクロージャ(2026-11-20)

mad export --format pdfとmad serveのexportが今WindowsでPDFを書き、Windows半分はビルドが運ぶ3つ目のヘッドレスライブラリスタックです。

ライブラリ。 Windows/Engine/libraries.confはLinuxのピンを正確に固定します。pixman 0.46.4とcairo 1.18.6(gitタグ、コミット固定)、FreeType 2.15.0(tarball)、加えてLiberation 2.1.5フォントtarball。build.ps1はFreeTypeを自身のCMake(clang-cl、静的、コアのみ)でビルドし、次にpixmanとcairoをMSVC環境(cl)下でMesonで、静的かつPDFサーフェスのみでビルドします。Mesonビルドは生成された.pcファイルと、libpqビルドが導入したのと同じWindowsネイティブpkg-configシム(Ensure-PkgConfigShim、今は関数で両ビルドが共有)を通じてローカル依存を見つけます。3つのアーカイブがリンクに加わります。cairo.lib、freetype.lib、pixman-1.lib。msimg32がcairoのwin32サーフェスのためにシステムリストに加わります。

フォント。 LiberationフェイスはEngine/build/fontsにコピーされ、MADReportExporterPDFCairoは<exe>/fontsを最初に検索し(mad.exeがbuild/fontsを見つけ、build/testsのテストが<exe>/../fontsを通じてbuild/fontsを見つける)、次にインストール済みレイアウトとMAD_FONTS_DIRを検索します。

ライター。 MAD/SourceのMADReportExporterPDFCairoはMADReportExporterPDFの非Apple本体です。Apple本体は変更なしでCairoをリンクしません。構造目標、フォントマッピング、決定論はdocs/developers/build/pdf.mdのものです。MADPDFExportTestsは両エンジンでの受け入れテストで、PDFを読み戻し、ページ数、MediaBox、すべてのフレーム、すべてのラインのテキストをjson-reportオラクルと比較し、バーコードとピクチャを画像XObjectとしてチェックし、決定論的バイト同等性をチェックします。

ライセンス。 cairo(MPL-1.1)、pixman(MIT)、FreeType(FTL)、Liberationフォント(SIL OFL 1.1)はTHIRD_PARTY_LICENSES.md §3.5と§10に登録され、テキストはThirdParty/Licenses/にあり、WindowsLicenseRegistryがAboutウィンドウのために4つすべてを一覧します。どれも再リンク義務を追加しません。

Viewer。 WPF ViewerのフォーマットピッカーはMacと同じくPDFを最初に一覧し、serveのパス形式(path付きのexport)を通じてエクスポートするため、エンジンがエクスポーターのバイトを書き、レスポンスがバイト数を運びます。テキストフォーマットはdata読み戻しを保ち、そのUTF-8デコードはそれらにとってロスレスです。不確定プログレスバーと「Exporting…」ステータス行が呼び出しを覆い、Format.PdfとViewer.Exporting文字列は6つの辞書すべてで出荷されます。

7. 対応Windowsバージョン

.NET 10の対応OSマトリックス(Windows 10 Enterprise 21H2/1809/1607、Windows 11)とGNUstepのWindows 10 1903+ベースライン。Windows 11 Enterprise 26H2(ビルド26300)でテスト済み。Windows 7/8は.NET 10でサポートされません。

8. サードパーティライセンスとWindows Aboutページ

Windowsエンジンは第3の配布面であり、docs/project/THIRD_PARTY_LICENSES.md §10に登録されています。コンプライアンス面にGNUstepランタイムを追加します。

正確なDLL/静的の分割は、ビルドされたmad.exeからdumpbin /dependents(またはllvm-objdump -p)で測定され、Phase 3bレポートに記録されます。ツールチェーンレイアウトから推測されません。ビルドと任意のパッケージはThirdParty/Licenses/とNOTICEをコピーしなければなりません。

WPFのAboutウィンドウ(Phase 5シェル証明、Phase 6eで完成。エンジン/アプリケーションバージョンの分割はPhase 6fで到来)はMacの3つのタブ——Overview、License & Notice、Acknowledgements——をミラーし、上記のすべてのコンポーネントをWebView2を含めて一覧し、ThirdParty/Licenses/Windows/のテキスト、共有ルートテキスト、LGPL書面による申し出を表示します。AcknowledgementsリストはWindowsのコンポーネントリストであり、Appleアプリのものではありません。License & NoticeタブはMIT/ブランド通知とWindows再リンクの申し出を運び、Overviewは機械支援翻訳の通知を運びます。そのクロームはローカライズされますが、すべてのライセンス本体、コンポーネント通知、ライセンス名、著作権行は逐語的な英語のままです(MAD_APP_LOCALIZATION.mdのD6/§8)。既存のiOSとmacOSのAbout画面はApple専用のままです。それらはAppleアプリがリンクするCライブラリを一覧し、AppleアプリがGNUstepランタイムをリンクすると主張してはなりません。公開docs/windows.mdとREADME.mdのWindowsエントリは0.7の未署名リリース(2026-11-21)とともに着地しました。ページはドキュメント契約(docs/project/localization/LOCALIZATION.md)の下で6言語すべてに存在します。Windows検証ワークフロー(.github/workflows/windows.yml)はv0.7.0に添付されたmad-windows-x64.zipエンジンアセットに対して.NETスイートをテストし、Windows/package.ps1はそのアセットとアプリのリリースzipの両方を組み立てます。

テストデータベース

3つのライブドライバスイート(Phase 3b)は、Apple/Linuxビルドが使うのと同じ固定Dockerテストサーバーに対して行使され、127.0.0.1にバインドされたローカルWindowsコンテナとして実行されます(Macは全インターフェース公開を保ち、LinuxイメージとCLIフィクスチャが名前でそのコンテナに到達します)。クロスプラットフォームのエントリポイントはTestDatabase/test-databases.sh(Git Bash)とTestDatabase/test-databases.ps1(PowerShell)で、3つのフレームワークごとのスクリプトに委譲します。TestDatabase/README.mdがリファレンスです。

.\TestDatabase\test-databases.ps1 -Action download   # fetch datasets, no Docker
.\TestDatabase\test-databases.ps1 -Action up         # create/start all three
.\TestDatabase\test-databases.ps1 -Action status     # -Service mysql|tds|postgres
.\TestDatabase\test-databases.ps1 -Action verify
.\TestDatabase\test-databases.ps1 -Action env        # print the env block

envブロックはPhase 3bのライブスイートが読む契約で、build.ps1と同じセッションで適用します。

$env:MAD_MYSQL_TEST_HOST = "127.0.0.1"; $env:MAD_MYSQL_TEST_PORT = "13306"
$env:MAD_MYSQL_TEST_USER = "root"; $env:MAD_MYSQL_TEST_PASSWORD = "root"
$env:MAD_MYSQL_TEST_SCHEMA = "employees"
$env:MAD_TDS_TEST_HOST = "127.0.0.1"; $env:MAD_TDS_TEST_USER = "sa"
$env:MAD_TDS_TEST_PASSWORD = "Root1@Root2"; $env:MAD_TDS_TEST_DATABASE = "AdventureWorksLT2022"
$env:MAD_PG_TEST_HOST = "127.0.0.1"; $env:MAD_PG_TEST_PORT = "5432"
$env:MAD_PG_TEST_USER = "mad"; $env:MAD_PG_TEST_PASSWORD = "mad_test_pw"
$env:MAD_PG_TEST_DATABASE = "chinook"

MAD_TDS_TEST_PORTはありません——TDSスイートは1433をハードコードします。ドライバのビルド結果はここではなくPhase 3bレポートに記録されます。

関連ドキュメント

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