このページは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の技術的コンパニオンであり、ツールチェーンレシピ、各ピースを固定する理由、この増分が下した決定を記録します。
ターゲットは、既存のヘッドレス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、アプリはまだビルドしていませんでした。
要約(このセクションは単独で成り立ちます):
Phase 1の起動クラッシュ(すべてのFoundationバイナリで0xC0000005)は、フローティングmasterのGNUstepコンポーネントにおけるランタイム回帰——§2.3の7つのピンがそれを修正します——であり、Clang 23のコード生成バグではありませんでした。Clang 20.1.8はCIでテストされたコンパイラであり、証明済みレシピの一部です。ピン付きのClang 22/23はテストされていません。これはピンであり、好みではありません。新しい実現可能性テストなしにLLVMをアップグレードしないでください。
このマシンは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++翻訳単位に適用されます。
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に記録されています。
ツールチェーンの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つすべてをカプセル化します。
Windows/Engine/build.ps1はリポジトリからレシピを再現します。
llvm-lib、VS 2026、Windows SDK、NASM。Engine/toolchain/bootstrap.ps1が固定ドライバをクローンし、2つのパッチファイルを適用し、GNUstepをソースからC:\GNUstepにビルドします(設定可能。初回実行で約20〜30分)。Engine/libraries.confから3.53.3アマルガメーションをダウンロードし、sha256を検証し、展開し、Compressor/sqlite3.xcconfigのオプションリストでsqlite3.cをコンパイルし、llvm-libでCOFF sqlite3.libにアーカイブします。Engine/Compatシム)をコンパイルします。フレームワークのコンパイルフラグは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ビルドがそれらを変更なしで消費できます。
| フレームワーク | 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向けに適応されています。
syslog.h — madlogのApple以外分岐用のノーオペレーションsyslog()とLOG_*定数(madlog.hは__APPLE__が定義されていないとき<syslog.h>をインクルードする)。pthread.h — MADOperation.mの状態ロック用の、Windows CRITICAL_SECTION上のpthread_mutex_t(再帰)。NSData+ReadingOptionsは落とされた — 固定GNUstep masterはすでにNSDataReadingOptionsと-options:error:を運ぶため、Linuxシム(gnustep-base 1.31.1用に再宣言する)はWindowsでは重複インターフェースになる。NSPropertyListSerialization+Stream.mが明示的な#import <Foundation/NSData.h>を得る——Windowsのヘッダーインクルード順の差異(LinuxのヘッダーはたまたまNSDataに先に到達し、Windowsはそうしない)。MADCompat.h(force-includeされるプレリュード)は<endian.h> + htonll/ntohllブロックを落とす——MADFoundationもMADDataStructuresもそれを使わず(grep検証済み)、<endian.h>はWindowsに存在しません。ドライバレイヤー(MAD)は移植時にWindowsのバイトオーダーシムを必要とします。MADCompat.hはまたstatic inline strlcatを得る——Windows UCRTにはstrlcat/strlcpyがなく(BSD/Appleの綴り。glibc 2.38+は提供するのでLinuxにはシム不要)、MADQueryCacheAddRow.mがそれを求めます。NSURL+FileSystem.mは-fileSystemRepresentationにself.path.UTF8Stringで答え、GNUstepのGSNativeChar*の綴り(WindowsではUTF-16)を使いません。それはconst char *として偽装されるとsqlite3_open_v2のパスを壊しました。他のLinuxシムは変更なしで引き継がれます。WindowsとLinuxのGNUstep-baseは同じ1.31.x系だからです。
2つの共有ソース変更が必要で、どちらも最小かつポータブルでした(Linux CIとAppleスイートがゲートです)。
madlib.cのitoa/ltoa/ultoa名前変更MADFoundation/Source/madlib.cはitoa/ltoa/ultoaを定義し、Windows UCRTの同じ綴りの3引数非標準名と衝突します。それらはmad_itoa/mad_ltoa/mad_ultoaに名前変更され、すべての呼び出し元が更新されました。
MADFoundation/Source/madlib.{c,h} — 定義と宣言。未使用でWindowsに存在しない#import <strings.h>も落とす。MADFoundation/MADFoundationTests/madlibTests.mとLinux/Tests/madlibTests.m — テスト。MAD/Source/model/MADModelQueryTable.m、MAD/Source/rptq/RptqQueryTable+Extras.m(ltoa)、MADSqlite3/Source/MADDataTableFast.m、MADSqlite3/Source/MADQueryCacheAddRow.m(ultoa)。これは純粋な機械的名前変更で、AppleとLinuxで振る舞い中立です。uitoa、reverse、count_digits、count_digits_ulは触れられません(UCRTと衝突しません)。MADExplorerのitoa参照はコメントアウトされたブロック内にあり、呼び出し元ではありません。
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で振る舞い中立です(同じポインタバイトが通ります)。
このセクションは当時のPhase 1/2のギャップを記録します。Phase 3a〜6eが受け入れ済みのものを除いてすべてを閉じました。§6b〜§6h、および現在の状態については
Windows/README.mdを参照してください。
BDHost(逆引きDNS)とMADKeyChain(Security.framework)は除外されます。BDHostはWinsock2ポートが必要で、MADKeyChainにはまだWindowsのキーチェーン同等物がありません。BDHostTestsも同じ理由でWindowsに登録されません(BDHost.mなしではリンクできない)——スキップではなく記録です。MAD、ドライバ、MADFileManager、MADCocoaExtensions、……)とCLIが次の増分です。Phase 3aは残りのヘッドレスフレームワーク、.madコンテナのCライブラリ、およびmad.exeをビルドします。
MADCocoaExtensions(7ファイル)、MADFileManager(10)、MAD(168)がPhase 2/2bの集合に加わり、同じLinuxソースリストと同じ除外理由(UIテール、MADocument、キーチェーンオペレーション、MADCloud)でビルドされます。MADDirectoryMonitorは不活性なsys/inotify.hシムに対してコンパイルされます——CLIは単発で変更イベントを必要としません。zlib 1.3.2、bzip2 1.0.8、libarchive 3.8.9(Linuxのピン)がbuild.ps1でビルドされます。zlibとbzip2は直接clang + llvm-lib、libarchiveはCMake + clang-cl(zlib/bzip2はin、xml2/lzma/zstd/lz4/opensslとツールはout)で、Linux/lib/libraries.sh / Compressorに一致します。バーコードスタック——libpng 1.6.59とzint 2.16.0——も同じ方法(どちらもCMake + clang-cl)でビルドされ、MADBarcodesもここでコンパイル・レンダリングされます。CLI/Source → mad.exe、whole-link。inspect、schema、query、refresh(76行)がLondon.portable.madで実行されます。6つのエクスポートダイジェストすべてがMac/Linuxのピンとバイト単位で一致し、write --reproducibleはMacとLinuxが書くのと同じ16261バイトのドキュメント(09815b24…)を書きます。write --reproducible(116バイトのストア読み取り)。 アーカイブライターのopen/readはWindows/Engine/Compat/unistd.hを通り、そのopenはUCRT _openにマップされていました——それはデフォルトでテキストモードです。SQLiteストアはオフセット116に0x1A(Ctrl-Z)バイトを含み、テキストモードの_readはそこでEOFとして止まるため、ライターは663552バイトのうち116バイトだけを見て518バイトのアーカイブを出力しました。シムは今_O_BINARYをフラグにORするので、open/readはPOSIXのバイト単位動作です。Windowsシムにガードされ、Apple/Linuxのバイトは変わりません。MADArchiveManagerTestsで固定(5テスト、0ニーズ)。export(.mdcache名前変更)。 行キャッシュ.mdcacheはNSInputStreamで読み、その後アトミックに書き換えられるplistです。Compat/NSPropertyListSerialization+Stream.mがすでに開いているストリームを2度目に開きました。GNUstepのwin32 GSFileInputStream -openは毎回CreateFileW(FILE_SHARE_READ)を呼び、_loopIDを上書きして最初のハンドルをリークします。そのハンドルが後の.mdcache上のMoveFileExをブロックし("being used by another process")、2回目のエクスポートが失敗しました。シムは今、開いているストリームを再オープンせずに読み(Appleの契約)、1ユーザーでの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スイートがゲート):
MADReportSectionRepresentation.mが空の@finallyを落とす(clang 20.1.8のGNUstep-2.2 + ARCコード生成がそれでクラッシュした)。madtar.mが_WIN32 mtime分岐を得る(UCRT struct statはst_mtimeを持ち、st_mtimはない)。MADArchiveManager.m、MADStore.m、MADCLIInspect.mが-fileSystemRepresentationを使っていたところでNSString -UTF8Stringを使う(GNUstepのNSStringの綴りはWindowsでUTF-16を返す)。MADDatabaseConnection+Constructor.mの+Identifier:が4つのドキュメントフォーマット定数を直接返すため、Sqlite3だけをリンクするプロセスでも保存されたdriverIDを型にマップできます。(Phase 3bがこのガードを除去——§6c参照。)Phase 3bは4つのデータベースドライバと、それらがリンクするCライブラリを追加します。
Windows/Engine/libraries.conf、build.ps1 §3c): OpenSSL 3.5.9(Strawberry Perl + VC-WIN64A + nmake、静的)、FreeTDS 1.4.27(CMake db-lib、ENABLE_MSDBLIB、sybdb.h BOOL編集)、MariaDB Connector/C 3.4.11(CMake mariadbclient、認証プラグイン静的)、libpq 17.11(Meson + MSVC cl.exe、libpq_st + libpgcommon_shlib + libpgport_shlibを1つのCOFF libpq.libにマージ)。PostgreSQL 17はMSVCビルドを落としたため、MesonがそのWindowsパスです。cl.exe(clang-clではなく)を使うのは、PostgreSQLのMesonがcc.get_id() == 'msvc'をチェックし、clang-clがclang-clと報告するためで、win32gettimeofday.c/dirent.cとwin32_msvcインクルードディレクトリが静かに落ちます。MesonとStrawberry Perlがドキュメント化された前提条件です。MADFoundation/Source/BDHost.mがwinsock2.h/ws2tcpip.h上の#elif defined(_WIN32)分岐を得ます(WSAStartupを一度、getaddrinfo/getnameinfo、IPv4のみ)。+ipAddresses/+ethernetAddressesはWindowsでコンパイルアウトされます。BDHostTestsは3/3で通ります。cmake/*Sources.cmakeリスト(18/1/3/4ファイル)と<MADTds/sybdb.h>、<MADTdsClient/MADTdsClient.h>、<MADPostgres/libpq-fe.h>などのヘッダーシム。MADTdsDb.mは通常どおりリンクされます(そのグローバルerr_handlerはMADDatabaseSQLServer.mのものと衝突します)。Phase 3aの+Identifier:ガードは除去され、4つのドライバすべてをリンクした状態でレジストリルックアップが機能し、MADDatabaseDriverDispatchTests(9/9)で固定されます。MADBarcodesTestsとMADBarcodeExportTestsを追加し、イメージクロージャがMADImageElementTestsとMADImageExportTestsを追加)。ローカル127.0.0.1コンテナに対するライブスイート: MADMySQLLiveTests 44/44、MADTdsClientLiveTests 29/29、MADPostgresLiveTests 14/14。CLIのmad refreshはMySQL 50行 / TDS 20行 / PostgreSQL 25行を返します。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、孤児プロセスなし)、不正なリクエスト、不明なメソッド、悪いドキュメント、利用不可のフォーマット、プロセスシャットダウンを行使します。
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を決してビルドしない)。
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付き)を一覧します。
Phase 6dは6a〜6cのシェルの上にMAD Viewerを完成させます。Macビューアはページ分割PDFをPDFViewでレンダリングしますが、WindowsにはPDFKitがないため、プレビューはエンジンのHTMLファクシミリをレンダリングし、PDF自体はエクスポート時にエンジン自身のエクスポーターが書きます(§6l)。
export --format htmlバイト(ページごとに1つの<div class="page" data-index="N">ボックス、PDFと他のすべてのエクスポーターが使うのと同じフォーマッタ)をWebView2でホストして表示します。ステータス行のページ数はそれらのページボックスの数なので、エンジンが唯一のページネータのままで、エクスポーターがC#で再実装されることはありません。プレビューは注入されたスタイルを通じてプレゼンテーション用のクローム(灰色のデスク、ページの間隔と影)だけを追加し、エクスポートされるバイトは変わりません。HTMLは一時ファイルに書かれ、URLでナビゲートされます。NavigateToStringには2 MBの上限があり、大きなレポートがそれに当たるからです。ズームはWebView2のZoomFactor、ページナビゲーションは要求されたページボックスをビューにスクロールします。PrintはCoreWebView2.ShowPrintUI——暫定のHTML印刷パス——を使います。ブラウザはXAMLではなくLoadedで作成されるため、ワークスペースはテストのためにヘッドレスで構成できます。ViewerViewModelはページサイズ選択とそのレンダリングロック(US Letterデフォルト、US Legal、A4)、ズームステップ(0.25〜4.0、1.25×、100%リセット)、前後ナビゲーション、エクスポートフォーマットカタログ、ステータス行を所有します。ステータス行はMacのものです。Rendered N pages from M cached rows.とその単数/複数文法で、成功時は緑、失敗時は赤。用紙サイズを選んでも次のリフレッシュまでレンダリングされたレポートは変わらず(MacのselectedPaperType/renderedPaperTypeの分割)、選択はリフレッシュを生き延び、エクスポートはレンダリングされた用紙を使います。pdf、html、html、csv、json、json、txt)を持ちます。ツールバーにフォーマットセレクタがあり、Exportは選択されたフォーマットでフィルタされた保存ダイアログを開きます。PDFはserveのパス形式(path付きのexport)を通るため、エンジンがエクスポーターのバイトを選ばれたファイルに書き、レスポンスはバイト数のみを運びます。テキストフォーマットが使うdata読み戻しはUTF-8で、バイナリPDFを破損するからです。リフレッシュ前のエクスポートはMacのExportと同様に先にリフレッシュし、エクスポート中はステータスバーが不確定プログレスバーと「Exporting…」行を表示します(コマンドは無効。serveは進捗をストリームせず、エクスポートは単一リクエストです)。DocumentViewModel.RefreshAsyncはクエリを実行し、次にViewer.RenderAsyncを呼びます。それは選択された用紙をドキュメントを通じて適用し(Designerのスナップショットが追従する)、HTMLプレビューをロードします。ViewerのRefresh、Export、Printボタンはすべて同じドキュメントパスを通ります。set-paper-sizeは保存されたRptqDocumentを変更しましたがレンダードキュメントは変更しませんでした。そのMTPaperは最初のレイアウト後にキャッシュされるため、2回目の用紙変更がエクスポートに届きませんでした。それは今、レンダードキュメントでsetPaperType:も呼び(Macビューアがリフレッシュ前に呼ぶ呼び出し)、すでにレイアウトされたレポートを再フォーマットするため、新しいサイズが別のリフレッシュなしで続くエクスポートに届きます。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の用紙サイズ切り替えが各エクスポートに届く)。
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のビューモデル/サービスレベルの対応物で、ピクセルテストではありません。
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…)に対してアサートされます。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を参照してください。
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とその翻訳は延期されたままです。
バーコード要素はもはや境界のどちら側のギャップでもありません。
エンジン。 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/にあります(両方のテキストはすでに存在しました)。
画像要素はプレースホルダであることをやめます。ライブラリは追加されませんでした。ストアの画像列はすでに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つを追加します。
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つの辞書すべてで出荷されます。
.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でサポートされません。
Windowsエンジンは第3の配布面であり、docs/project/THIRD_PARTY_LICENSES.md §10に登録されています。コンプライアンス面にGNUstepランタイムを追加します。
ThirdParty/Licenses/README.mdの書面による再リンクの申し出を運ばなければなりません。sybdb.h編集はマークされ、既存の再リンクの申し出は今Windowsエンジンを名指しします。ThirdParty/Licenses/の既存エントリとテキストを使います。Microsoft.Web.WebView2 1.0.4314.35)はMicrosoft製品でオープンソースソフトウェアではありません。Evergreen WebView2 RuntimeはWindows 11とEdgeとともにインストールされ、このプロジェクトによって変更も再頒布もされません。SDKのBSD-3-ClauseライセンスとMicrosoftのサードパーティ通知、ランタイムのMicrosoft Software License Terms、このプロジェクトの帰属とともに登録され、すべてThirdParty/Licenses/Windows/WebView2-LICENSE.txtにあります。Testing.hはテストバイナリにのみコンパイルされ、出荷されません。libiconvのiconvツールとgnustep-corebaseのテストプログラムも同様に配布されません。GNUstep Baseのコマンドラインツール(gdomap、gdnc、defaults、plutil、gspath)はGPL-3.0-or-laterで、mad.exeの一部ではありません。GPLテキストと対応ソースの申し出なしにパッケージ化しないでください。正確な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レポートに記録されます。
docs/developers/build/linux.mdとLinux/README.md — このWindowsビルドがミラーするLinuxビルド。docs/developers/build/macos.mdとMac/README.md — WPFアプリが振る舞いをミラーするネイティブmacOSアプリケーション。docs/project/THIRD_PARTY_LICENSES.md §10 — Windowsエンジンのライセンスレジストリ。ThirdParty/Licenses/とThirdParty/Licenses/Windows/ — テキストと書面による再リンクの申し出。このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。