适用于 Windows 的 MAD Designer 是一款基于 Windows Presentation Foundation(WPF)和 .NET 10 的原生桌面应用,用于创建、查询、排版、刷新和导出 Mobile Analytics Document(.mad)。它运行与 macOS 应用和 Linux 的 headless mad CLI 相同的自有 Objective-C 引擎(mad.exe),因此它写出的每个文档都与 iPad/iPhone 应用、mad CLI 和 GitHub Action mad-action 兼容。
此 0.7 版本未签名。 它从公开源代码构建并发布,但不包含商业代码签名证书,因此首次启动时 Windows SmartScreen 会发出警告。这里没有任何隐藏内容:请审查此版本(见下文)、校验其 SHA-256 校验和,然后再运行。
.zip 并将其解压到您选择的文件夹。请保持文件夹结构完整:应用、引擎和许可证彼此关联。Mad.Designer.Windows.exe。MAD-Designer-Windows-0.7/
Mad.Designer.Windows.exe WPF 应用(自包含)
... 应用自身的文件
CLI/Fixtures/ London.portable.mad(示例报表)和
chinook.sqlite3(用于刷新的示例数据)
Windows/Engine/build/mad.exe headless 引擎
Windows/Engine/build/*.dll 引擎的 GNUstep/ObjC/VC 运行时
Windows/Engine/build/fonts/ PDF 导出使用的 Liberation 字体
ThirdParty/Licenses/ 所有第三方许可证和声明
LICENSE, NOTICE, README-Windows.txt
引擎所在位置: Windows/Engine/build/mad.exe,与它的运行时 DLL 和 fonts 文件夹放在一起。应用通过源代码树所用的同一套仓库相对结构找到它;它不使用系统范围的 GNUstep 安装。请保持压缩包放置的文件夹位置不变。
发布页面会公布压缩包的 SHA-256 校验和。下载后请进行比对:
Get-FileHash .\MAD-Designer-Windows-0.7.zip -Algorithm SHA256
也可以逐个文件审查解压内容:压缩包只包含已发布的应用、由 Windows/Engine/build.ps1 构建的引擎、示例文档和许可证文本。mad.exe 就是 Linux 指南和 Windows 构建记录中记录的命令行引擎。
您可以直接运行 mad.exe,无需打开图形界面即可检查文档:
.\Windows\Engine\build\mad.exe inspect .\CLI\Fixtures\London.portable.mad
如果希望 Windows 不再就您自己的副本发出警告,可以创建本地代码签名证书并自行签署可执行文件。这是本地信任决定——它不会让公开下载对其他人变得可信:
$cert = New-SelfSignedCertificate -Type CodeSigningCert `
-Subject "CN=MAD Designer (local review)" `
-CertStoreLocation Cert:\CurrentUser\My
Set-AuthenticodeSignature -FilePath .\Mad.Designer.Windows.exe -Certificate $cert
要在此计算机上信任该证书,请将其导出,并使用 certmgr.msc 或 Import-Certificate 导入到受信任的根证书颁发机构;请仅对您自己创建和控制的证书这样做。
该应用与 macOS 应用具有相同的三个报表阶段:
查看器可导出 PDF、HTML、HTML Flow、CSV、JSON、JSON 完整报表和纯文本,顺序与 macOS 查看器相同。PDF 由引擎自身写入(与 mad export --format pdf 使用相同的导出器),因此大型报表导出时不会阻塞窗口:状态栏会显示不确定进度条和“正在导出…”提示,完成后显示文件大小。
应用使用 Windows/global.json 固定的 .NET SDK(10.0.404)构建:
dotnet publish Windows\App\Mad.Designer.Windows\Mad.Designer.Windows.csproj `
-c Release -r win-x64 --self-contained true
引擎是更难的一半。Windows\Engine\build.ps1 重现原生构建(Clang 20.1.8、固定的 Visual Studio MSVC 工具链、NASM、Strawberry Perl、Meson、Python,以及从七个固定修订版构建到 C:\GNUstep 的 GNUstep)。它必须在提升权限的 PowerShell 提示符中运行:
pwsh -File .\Windows\Engine\build.ps1 # 完整引导工具链并构建
pwsh -File .\Windows\Engine\build.ps1 -SkipToolchain # 工具链已存在时重新构建
两个 .NET 测试套件针对已构建的引擎运行:
dotnet test Windows\App\Mad.Designer.Windows.slnx
Windows/Engine/build.ps1 还会运行移植的原生套件;在引擎和应用构建完成后,Windows/package.ps1 会组装未签名的发布压缩包和 CI 使用的引擎资源。完整配方、Windows 专用的运行时修复、许可证义务和支持的操作系统矩阵记录在 docs/project/MAD_WINDOWS.md 中。
MAD 采用 MIT 许可证(见 LICENSE);“MAD”、“MAD Designer”和“MAD Viewer”这些名称以及应用美术资源不在许可范围内(见 NOTICE)。引擎还附带 GNUstep 运行时(LGPL-2.1-or-later)和 C 库;每个组件、其许可证以及书面的重新链接要约都位于压缩包的 ThirdParty/Licenses/ 文件夹和 docs/project/THIRD_PARTY_LICENSES.md 中。
本页为英文原文的简体中文翻译;如有出入,以英文原文为准。