MAD_MACOS.md – Multiplattform-Frameworks und die native macOS-AnwendungDiese Seite hält den Multiplattform-Audit der Frameworks und die Architektur der nativen macOS-Anwendung fest. Die benutzerseitige Anleitung steht unter /macos.html.
Geschrieben am ursprünglichen Datum; Fakten zum aktuellen Stand abgeglichen am 2026-11-22.
Dieses Dokument hält die Architekturentscheidung, den Portabilitätsaudit Framework für Framework und den phasenweisen Migrations- und Implementierungsplan fest, um die MAD-Frameworks wirklich multiplattformfähig zu machen (iphoneos, iphonesimulator, macosx und headless Linux) und das native macOS-Frontend (AppKit) für MAD Designer zu bauen.
AppKit) vs. Mac CatalystEntscheidung: Eine native macOS-Anwendung (macosx-SDK, AppKit) über geteilten Multiplattform-Frameworks bauen (MACOSX_DEPLOYMENT_TARGET = 12.0, unterstützt jeden Apple-Silicon-Mac und Intel-Macs auf Monterey oder neuer). Mac Catalyst wird abgelehnt.
| Dimension | Natives macOS (macosx / AppKit) |
Mac Catalyst (maccatalyst / UIKit) |
|---|---|---|
Statische C-Bibliotheken (Compressor) |
Bereits gebaut. Alle 10 .xcframework-Bundles in Compressor/library/ tragen universelle macosx-Slices (arm64 + x86_64, -mmacosx-version-min=11.0), verifiziert durch ./Compressor/build.sh --verify --all --platforms ios,simulator,macosx. |
Fehlen. Es existieren null maccatalyst-Slices (-target <arch>-apple-ios15.0-macabi). Der Mach-O-Linker verweigert das Linken von MACOS-Archiven in MACCATALYST-Binärdateien; Catalyst würde erfordern, Compressor eine vierte Plattform hinzuzufügen und alle 10 C-Bibliotheken neu zu bauen (openssl, mariadb, postgres, freetds, libarchive, sqlite3, zint, libpng, bzip2, zlib). |
| Portabilität der Kern-Engine | 90 % abgeschlossen. Der headless Linux-Port (MAD_LINUX.md) hat Core Data bereits aus MAD.framework entfernt, die Datenbanktreiber (MADDatabaseDriverRegistry) und Berichtsexporter (MADReportExporterRegistry) entkoppelt und MADHeadlessDocument, MADSQLQueryCompiler und MADDesignerLayout eingeführt. |
Dieselbe Engine, aber an UIDocument und die Lebenszyklen der iOS-Hintergrundaufgaben gebunden. |
| Desktop-Ergonomie | Natives NSDocument / NSDocumentController (Finder-Doppelklick, Cmd+N, Cmd+O, Cmd+S, Cmd+Shift+S, zuletzt verwendete Dokumente, Fensterwiederherstellung, NSUndoManager), native Split-Views, native Tabellen-/Outline-Views, natives PDFView / WKWebView und Standard-macOS-Menüs. |
Verschachtelte zoombare UIScrollView + UICollectionView-Abschnitte, iOS-Tab-/Navigationsleisten, UIPickerView-Räder und der sandboxed iOS-Dokumentbrowser (MADExplorer). Apple-Silicon-Macs führen den iPad-Build bereits über Designed for iPad aus. |
| Verteilung über GitHub | Sauberes eigenständiges .app-Bundle, paketiert als herunterladbare .dmg und .zip auf GitHub Releases (arm64 + x86_64). |
Erfordert ein Catalyst-Provisioning-Profil und -Entitlements, die nicht zur Ergonomie der Verteilung außerhalb des App Stores passen. |
Compressor)Alle zehn mitgelieferten C-Bibliotheken in Compressor bauen universelle macosx-Slices (arm64 + x86_64) mit -mmacosx-version-min=11.0:
| Bibliothek | Version | ios (arm64) |
simulator (arm64 + x86_64) |
macosx (arm64 + x86_64) |
Verwendet von |
|---|---|---|---|---|---|
sqlite3 |
3.53.3 | Ja | Ja | Ja | MADSqlite3, MAD |
zlib |
1.3.2 | Ja | Ja | Ja | MAD, MADMySQL, MADPostgres, MADBarcodes |
openssl |
3.5.9 | Ja | Ja | Ja | MADTds, MADMySQL, MADPostgres |
bzip2 |
1.0.8 | Ja | Ja | Ja | MAD |
libpng |
1.6.59 | Ja | Ja | Ja | MADBarcodes |
libarchive |
3.8.9 | Ja | Ja | Ja | MAD |
freetds |
1.4.27 | Ja | Ja | Ja | MADTds, MADTdsClient |
mariadb |
3.4.11 | Ja | Ja | Ja | MADMySQL |
postgres |
17.11 | Ja | Ja | Ja | MADPostgres |
zint |
2.16.0 | Ja | Ja | Ja | MADBarcodes |
Verifikationsbefehl:
./Compressor/build.sh --verify --all --platforms ios,simulator,macosx
Zwölf Frameworks bilden den Multiplattform-Stack (iphoneos, iphonesimulator, macosx, plus Linux für die zwölf headless Frameworks):
MADFoundation (28 .m-Dateien):
MADApplication.h: <UIKit/UIApplication.h> mit #if TARGET_OS_IPHONE schützen statt mit #if __APPLE__ (MADApplication.m hat bereits #elif TARGET_OS_OSX #import <AppKit/NSApplication.h>).MADURLFactory.m: <UIKit/UIScreen.h> mit #if TARGET_OS_IPHONE schützen und unter TARGET_OS_OSX NSScreen.mainScreen.backingScaleFactor > 1.0 verwenden.MADKeyChain.m: verwendet Security.framework, das unter iOS und macOS nativ ist.MADDataStructures (17 .m-Dateien):
MADFileManager (11 .m-Dateien):
#import <MobileCoreServices/UTType.h> in MADMetaDataLocal.m:16 entfernen (<UniformTypeIdentifiers/UTType.h> ist bereits in Zeile 17 importiert).MADCocoaExtensions (17 .m-Dateien):
CGGeometry+Extras.h: unter TARGET_OS_OSX UIEdgeInsets bereitstellen (mit NSEdgeInsets kompatibles Layoutstruct + UIEdgeInsetsMake / UIEdgeInsetsZero / UIEdgeInsetsEqualToEdgeInsets), NSStringFromCGPoint / NSStringFromCGSize / NSStringFromCGRect und NSValue (MADCGGeometryExtensions) (valueWithCGPoint:, CGPointValue, valueWithCGRect:, CGRectValue, valueWithCGSize:, CGSizeValue).MADColor.h / MADColor.m: MADColor unter TARGET_OS_OSX auf NSColor überbrücken, während unter TARGET_OS_IPHONE UIColor erhalten bleibt.UIView, UIAlertController, UITextField und UIColor mit #if TARGET_OS_IPHONE schützen.MADAPI (11 .m-Dateien):
MADConnectionViewController und MADConnectionSQLGenericViewController mit #if TARGET_OS_IPHONE schützen.MADSqlite3 (26 .m-Dateien):
sqlite3.xcframework. Keine Quellcodeänderungen erforderlich.MADTds (1 .m-Datei):
freetds.xcframework + openssl.xcframework. Keine Quellcodeänderungen erforderlich.MADTdsClient (4 .m-Dateien):
MADDatabaseSQLServer, MADTdsConnection und MADDataTypeSQLServer sind reines Foundation. MADTdsConnectionViewController mit #if TARGET_OS_IPHONE schützen.MADMySQL (19 .m-Dateien):
mariadb.xcframework. MADMySQLConnectionViewController mit #if TARGET_OS_IPHONE schützen.MADPostgres (5 .m-Dateien):
postgres.xcframework. MADPostgresConnectionViewController mit #if TARGET_OS_IPHONE schützen.MADBarcodes (70 .m-Dateien):
zint.xcframework.MADBarcode, MADBarcodeCache und MADBarcodeView: UIImage / NSImage und UIView / NSView unter TARGET_OS_OSX über die vorhandene CGImageRef-Pipeline MADBarcodeImageFromZintBitmap überbrücken.MAD (199 .m-Dateien):
#if __APPLE__ durch #if TARGET_OS_IPHONE und #elif TARGET_OS_OSX und AppKit-Brücken über die 9 geteilten Modell-/Renderdateien ersetzen (RptqObject.m, RptqDocumentElementImage+Extras.m, RptqDocument+Extras.m, RptqDocumentSection+Extras.m, RptqDocumentElement+Extras.m, MADPrintPageElement.m, MADElementStylizedText.m, MADFonts.m und MADReportExporterPDF.m).MADReportExporterPDF.m paginierte PDFs unter TARGET_OS_OSX mit CGPDFContextCreateWithURL / CGPDFConsumerCreateWithCFData und NSGraphicsContext (+graphicsContextWithCGContext:flipped:YES) rendern, sodass MADPrintPageRenderer und MADPrintPageElement nativ unter macOS zeichnen.UIDocument (MADocument), UIView und UICollectionViewLayout mit #if TARGET_OS_IPHONE schützen.MADExplorer bleibt iOS-only (macOS verwendet NSDocumentController, Finder und NSOpenPanel mit einem primären New Document-Button). MADFeedback und Scrimpter bleiben ungenutzt gemäß AGENTS.md.
docs/project/registers/BUGS.md nach docs/project/registers/BUGS_FIXED.md archiviert:
MADKeyChain (MADFoundation/Source/MADKeyChain.m): das Anfordern von kSecReturnData : @YES (und das Lecken des zurückgegebenen CFDataRef) in +credentialsExist:, +saveToken:forKey:withDescription:, +deleteKey: und +deleteSavedPasswordForKey:error: beendet.MADURLFactory (MADFoundation/Source/MADURLFactory.m): +newURLForLocalApplicationSupportDirectory geschützt, wenn [NSBundle mainBundle].bundleIdentifier nil ist (mit Rückfall auf [MADApplication groupIdentifier]), und containerURLForSecurityApplicationGroupIdentifier: mit #if defined(__APPLE__) && TARGET_OS_IPHONE geschützt, sodass nicht-berechtigte macOS-Prozesse die üblichen benutzerspezifischen Verzeichnisse verwenden, statt TCC-Abfragen auf ~/Library/Group Containers/ auszulösen.MADDataTable (MADFoundation/Source/MADDataTable.m): NSDataWritingFileProtectionCompleteUnlessOpen mit #if defined(__APPLE__) && TARGET_OS_IPHONE geschützt, sodass Cache-Schreibvorgänge unter nicht-berechtigtem macOS gelingen.MADDatabaseSqlite3 (MADSqlite3/Source/MADDatabaseSqlite3.m): [dataTable endBulkInsert] mit if (rowCounter > 0) geschützt, sodass SELECT-Abfragen mit null Zeilen kein COMMIT TRANSACTION ausführen, wenn [dataTable beginBulkInsert] nie aufgerufen wurde.MADBarcode (MADBarcodes/MADBarcodes/MADBarcodes/MADBarcode.m): -drawInRect: verdoppelte rect.origin nicht mehr, wenn self.center == YES.MADDesignerLayout (MAD/Source/MADDesignerLayout.m): den eigenen vorherigen Wert jedes ausgewählten Elements in einem Wörterbuch bewahrt, wenn Undo-Aktionen über alle Massenaktualisierungsmethoden registriert werden (setFontsize:, setFontname:, setVerticalAlignment:, setHorizontalAlignment:, setSizeWidth:, setSizeHeight:, setMargin*, setPadding*, setBorder*).macosx über die 12 Framework-Xcode-Projekte freigeschaltet:
SUPPORTED_PLATFORMS = "iphoneos iphonesimulator macosx" und MACOSX_DEPLOYMENT_TARGET = 12.0 gesetzt.platformFilters = (ios, maccatalyst, ); bei UIKit.framework-Verweisen hinzugefügt und AppKit.framework mit platformFilters = (macos, ); verlinkt, wo nötig.Ensure Libraries aktualisiert, um --platforms ios,simulator,macosx zu übergeben.-destination 'platform=macOS,arch=arm64'):
MADFoundation: 199 Tests bestanden, 0 FehlschlägeMADDataStructures: 72 Tests bestanden, 0 FehlschlägeMADCocoaExtensions: 80 Tests bestanden, 0 FehlschlägeMADFileManager: 85 Tests bestanden, 0 FehlschlägeMADAPI: 106 Tests bestanden, 0 FehlschlägeMADSqlite3: 118 Tests bestanden (5 Benchmarks übersprungen), 0 FehlschlägeMADTds: sauber für macosx gebautMADTdsClient: 77 Tests bestanden (einschließlich der Live-SQL-Server-Suite), 0 FehlschlägeMADMySQL: alle Offline- und Live-MariaDB/MySQL-Tests bestanden, 0 FehlschlägeMADPostgres: 31 Tests bestanden (einschließlich der Live-PostgreSQL-Suite), 0 FehlschlägeMADBarcodes: 30 Tests bestanden, 0 FehlschlägeMAD: 650 Tests bestanden, 0 FehlschlägeNSDocument-Schicht (abgeschlossen)MADHeadlessDocument):
+createDocumentAtURL:withDatabaseConnection:credentials:error: auf MADHeadlessDocument hinzugefügt (MAD/Source/MADHeadlessDocument.h, .m), das sich mit jedem registrierten Treiber verbindet (SQLite3, MySQL, SQL Server, PostgreSQL), alle Datenbanktabellen (-getTablesFromConnection:error:) und Spalten (-fieldsForTable:connection:error:) in RptqDatabaseSchemaTable / RptqDatabaseSchemaField importiert, die Standardberichtsabschnitte initialisiert (Report Header, Page Header, Report Detail, Page Footer, Report Footer) und den portablen .mad-Container schreibt.MADMacDocument (NSDocument-Unterklasse in Mac/Source/MADMacDocument.m):
MADHeadlessDocument (mit automatischer Konvertierung von Legacy-Core-Data-.mad über MADStoreConverter, wenn nötig), erfüllt MADocumentDesignerProtocol, sodass MADDesignerLayout Undo/Redo direkt auf NSDocument.undoManager aufzeichnet, und unterstützt readFromURL:ofType:error:, writeToURL:ofType:forSaveOperation:originalContentsURL:error: und das asynchrone refreshWithCredentials:maxRows:completion:.Mac/) (abgeschlossen)Gebaut unter Mac/ (Mac/Source/, Mac/Resources/, Mac/Tests/, Mac/build.sh) und über das Target MAD Designer Mac und das geteilte Scheme in MAD Designer.xcodeproj integriert:
MADMacAppDelegate, MADMacAboutWindowController und MADMacDocumentController):
MADStoreLegacyConverter, baut das native macOS-Hauptmenü (MAD Designer, File, Edit mit Undo/Redo, View mit Arbeitsbereichswechsel Cmd+1/Cmd+2/Cmd+3, Report mit Refresh Cmd+R, Window, Help) und präsentiert beim Start das standardmäßige NSOpenPanel, wenn kein Dokument offen ist.MADMacAboutWindowController präsentiert das native Fenster About MAD Designer (MAD Designer → About MAD Designer und Help-Menüpunkte) mit der Engine-Version/-Build (MADMeta.plist) und der macOS-Anwendungsversion (CFBundleShortVersionString) als getrennten Werten, Copyright- und Marken-/Artwork-Hinweis, der Aktion Source Code on GitHub und drei Tab-Abschnitten: Overview (was MAD ist, der vierstufige Reporting-Ablauf und unterstützte Treiber/Bänder/Exporter), License & Notice (MIT-Lizenz, NOTICE und das schriftliche Relink-Angebot nach LGPL-3.0 für FreeTDS und MariaDB Connector/C) und Acknowledgements (interaktive Seitenleiste aller 16 Open-Source-Komponenten von Drittanbietern mit ihren Nennungen und den 12 vollständigen Lizenztexten unter Contents/Resources/Licenses/).MADMacDocumentController konfiguriert NSOpenPanel mit allen .mad-UTType-Kennungen (com.everydayapps.productivity.mad und com.thomason.report.mad), sodass bestehende .mad-Dateien nie ausgegraut werden, und platziert einen primären New Document-Button direkt in der unteren linken Leiste des Open-Panels.MADMacConnectionWindowController):
.sqlite3/.db-Datei über NSOpenPanel), MySQL, Microsoft SQL Server und PostgreSQL, mit Test Connection, Passwortspeicherung über MADKeyChain und Create Document… (NSSavePanel).MADMacWindowController):
MADMacQueryViewController):
200px (vom Benutzer über NSSplitViewDelegate größenveränderbar, ohne zurückzuschnappen, und bei Fenstergrößenänderung auf fester Breite gehalten, sodass stattdessen die visuelle Leinwand ihre Größe ändert), gepaart mit einer interaktiven visuellen Leinwand rechts (MADMacQueryCanvasView). Ein Doppelklick auf eine Schematabelle fügt sie der Abfrage hinzu (befüllt alle RptqQueryField-Zeilen) und zeigt sie als ziehbare, größenveränderbare schwebende AppKit-Tabellenkarte (MADMacQueryTableCardView + MADMacQueryFieldTableView), gestaltet mit topologischen Kopfzeilen für Wurzel/Kind (MTGraph); das Ziehen von einem Feld in einer Tabellenkarte zu einem Feld in einer anderen erzeugt einen Standard-Left Outer Join (MADLinkTypeLeftOuterJoin), gezeichnet über Bezier-Verbinder und Join-Typ-Abzeichen (MADMacQueryLinksOverlayView, passend zu MADConnectorView des iPads). Ein Klick oder Rechtsklick auf einen visuellen Join-Verbinder öffnet ein Join-Inspector-Popover oder Kontextmenü zum Ändern des Link-Typs, Umkehren der Richtung oder Löschen des Links; Kopf-Popovers bieten Filters (WHERE), Groupings (GROUP BY) und Arrange Tables.MADSQLParser + MADSQLStatementResolver + MADSQLQueryCompiler).MADMacDesignerViewController + MADMacDesignerCanvasView + MADMacDesignerMinimapView):
38pt): bietet klickbare und ziehbare SF-Symbol-Palettenelemente (Label, Data Field, Aggregate, Barcode, Image, Line), schnelle Ausrichtungssteuerungen für mehrere Elemente (Left, Center, Right, Top, Middle, Bottom), Size to Fit, die Umschalter Grid / Snap / Rulers und einen Zoom-Schieber mit Ein-Klick-Rücksetzung auf 100%.NSSplitViewDelegate): die linke Navigator-Seitenleiste hat standardmäßig 220pt (180–340pt), der rechte Inspector standardmäßig 260pt (220–380pt), und beide Seitenleisten behalten ihre Breiten über Fenstergrößenänderungen hinweg, während Benutzer-Anpassungen der Trenner erhalten bleiben.MADMacDesignerMinimapView): zeichnet proportionale Berichtsbänder mit farbcodierten Streifen, live Miniatur-Elementblöcke und ein blaues Viewport-Rechteck; Klicken oder Ziehen springt zum Band und wählt es aus.NSSearchField) aller RptqQueryField-Spalten; das Ziehen eines Felds auf ein beliebiges Abschnittsband auf der Leinwand (oder ein Doppelklick) fügt ein gebundenes RptqDocumentElementLabelDataField ein.MADMacDesignerCanvasView): gespiegelte, zoombare NSView-Leinwand mit horizontalen/vertikalen Linealen, Papierrändern, farbcodierten Abschnittsbändern, Ziehgriffen für Abschnittshöhen, intelligenten Ausrichtungslinien, Einrasten am Raster, Rahmenauswahl, Shift-Klick-Mehrfachauswahl, 8-Punkt-Größengriffen, Inline-Bearbeitung von Beschriftungen per Doppelklick, intelligenter nicht-überlappender Elementplatzierung (-nextAvailableOriginInSection:forElementSize:) und Drag-and-Drop über Abschnitte hinweg (-moveElement:toSection:atOrigin:) mit Live-Hervorhebung des Zielbands und vollständiger NSUndoManager-Integration.1 · PAGE & SELECTED SECTION): Papiergröße, Abzeichen des ausgewählten Bands, Bandhöhe (pt) mit Button Fit Height, Section Visible und Page Break After.2 · SELECTED ELEMENT INSPECTOR): 4 gruppierte Inspector-Karten (Element & Band Assignment mit Popup zum Verschieben über Abschnitte, Duplicate und Delete; Content & Data Binding mit statischem Text, Bindung an Abfragefelder, Aggregatfunktion und -bereich, Währungsformatierung und Barcode-Optionen; Typography & Appearance mit Font-Familie/-Größe, Fett/Kursiv/Unterstrichen/Durchgestrichen, horizontaler/vertikaler Ausrichtung und Text-/Hintergrundfarben; und Position, Size & Box Model mit X, Y, W, H, synchronisiert über rect.origin und dropPoint, plus Rahmen, Padding und Margin).MADMacViewerViewController):
40pt): Popup Page Size (Standard-Papiertypen von MTPaper: US Letter, US Legal, US Tabloid, A3, A4, A5, B4, B5, JIS B4, JIS B5), Refresh (Cmd+R), Zoom-Steuerungen (-, 100%, +), Page Navigation (Previous, Page N of M, Next), Print… (Cmd+P über NSPrintOperation) und Export… (Cmd+E).PDFView): rendert paginierte PDF-Seiten in der gewählten Papiergröße aus dem lokalen SQLite-Tabellen-Cache (MADDataTableFast) mit Seitenschatten und einer unteren Statusleiste (statusBarView), die die gerenderte Seitenzahl, die gecachte Zeilenzahl und die Papierabmessungen anzeigt.NSSavePanel): konfiguriert ein Zubehör-Format-Popup, das alle 7 registrierten Exporter unterstützt (PDF, HTML, HTML Flow, CSV, JSON, JSON Report, Plain Text), und aktualisiert dynamisch die zulässige Dateiendung des Speicherpanels../Mac/build.sh --smoke-test --package
Erzeugt:
Mac/build/MAD Designer.app (eigenständiges natives macOS-App-Bundle mit allen 12 Frameworks und eingebetteten und signierten Legacy-Core-Data-.momd-Modellen)Mac/build/MAD-Designer-macOS.zipMac/build/MAD-Designer-macOS.dmgDie öffentliche Benutzer- und Entwicklerdokumentation für die native macOS-Anwendung wird in docs/macos.md veröffentlicht (mit Screenshots unter docs/assets/macos-native-mad-query.png und docs/assets/macos-native-mad-designer.png) und in Mac/README.md.
.github/workflows/macos.yml läuft bei jedem Pull Request und Push auf master. Es baut (und cached) die statischen Compressor-Bibliotheken, führt dann die Suiten MADBarcodes und MAD auf einem aus dem Runner entdeckten iPhone-Simulator aus, baut das iOS-Scheme MAD Designer und führt ./Mac/build.sh --smoke-test aus. Das About-Fenster meldet die Engine-Version (MADMeta.plist, v9.0 (r4433)) und die macOS-Anwendungsversion (CFBundleShortVersionString, v0.7) als getrennte Werte, passend zur Darstellung des Windows-About-Fensters nach Phase 6f.
macos-latest ist ein arm64-Runner, und Mac/build.sh baut die Frameworks für platform=macOS,arch=arm64. Der erste Lauf lädt und kompiliert jede festgeschriebene Drittanbieterquelle für drei Plattformen (etwa 15–40 Minuten); spätere Läufe stellen Compressor/library aus dem Actions-Cache wieder her, und der Ensure-Schritt ist ein No-op. Das freetds-Rezept holt config.guess/config.sub einmal ohne Wiederholung von Savannah, also speist der Workflow zuerst Compressor/media (siehe die Kommentare des Workflows). Ein Rest, kein Buildfehler: der configure-Schritt von libarchive fand die libbz2.tbd des SDK statt die bzip2-Installation von Compressor, weil BZIP2_LIBRARY nicht der Hinweis ist, den das moderne FindBZIP2 von CMake liest; die SDK-Bibliothek ist vorhanden, und die App verarbeitet das bzip2-xcframework.
Diese Seite ist eine deutsche Übersetzung des englischen Originals; bei Abweichungen ist der englische Originaltext maßgeblich.