MAD_MACOS.md – マルチプラットフォームフレームワークとネイティブmacOSアプリケーションこのページはマルチプラットフォームフレームワーク監査とネイティブmacOSアプリケーションアーキテクチャを記録します。ユーザー向けガイドは/macos.htmlにあります。
元の日付に書かれ、現状の事実は2026-11-22に整合。
このドキュメントは、MADフレームワークを真にマルチプラットフォーム(iphoneos、iphonesimulator、macosx、およびヘッドレスLinux)にし、MAD DesignerのネイティブmacOS(AppKit)フロントエンドを構築するための、アーキテクチャ決定、フレームワークごとのポータビリティ監査、段階的な移行と実装計画を記録します。
AppKit)対Mac Catalyst決定: 共有マルチプラットフォームフレームワーク(MACOSX_DEPLOYMENT_TARGET = 12.0、すべてのAppleシリコンMacとMonterey以降のIntel Macをサポート)の上にネイティブmacOSアプリケーション(macosx SDK、AppKit)を構築します。Mac Catalystは却下します。
| 次元 | ネイティブmacOS(macosx / AppKit) |
Mac Catalyst(maccatalyst / UIKit) |
|---|---|---|
静的Cライブラリ(Compressor) |
すでにビルド済み。 Compressor/library/の10個の.xcframeworkバンドルすべてがユニバーサルmacosx(arm64 + x86_64、-mmacosx-version-min=11.0)スライスを運び、./Compressor/build.sh --verify --all --platforms ios,simulator,macosxで検証済み。 |
欠けている。 maccatalystスライス(-target <arch>-apple-ios15.0-macabi)はゼロ。Mach-OリンカはMACOSアーカイブをMACCATALYSTバイナリにリンクすることを拒否する。CatalystはCompressorに4つ目のプラットフォームを追加し、10個のCライブラリ(openssl、mariadb、postgres、freetds、libarchive、sqlite3、zint、libpng、bzip2、zlib)をすべて再ビルドする必要がある。 |
| コアエンジンのポータビリティ | 90%完了。 Linuxヘッドレスポート(MAD_LINUX.md)はすでにMAD.frameworkからCore Dataを除去し、データベースドライバ(MADDatabaseDriverRegistry)とレポートエクスポーター(MADReportExporterRegistry)を分離し、MADHeadlessDocument、MADSQLQueryCompiler、MADDesignerLayoutを導入した。 |
同じエンジンだが、UIDocumentとiOSバックグラウンドタスクのライフサイクルに縛られる。 |
| デスクトップの人間工学 | ネイティブNSDocument / NSDocumentController(Finderダブルクリック、Cmd+N、Cmd+O、Cmd+S、Cmd+Shift+S、Recent Documents、ウィンドウ復元、NSUndoManager)、ネイティブスプリットビュー、ネイティブテーブル/アウトラインビュー、ネイティブPDFView / WKWebView、標準macOSメニュー。 |
ネストされたズーミングUIScrollView + UICollectionViewセクション、iOSタブ/ナビゲーションバー、UIPickerViewホイール、iOSサンドボックスドキュメントブラウザ(MADExplorer)。AppleシリコンMacはすでにDesigned for iPadでiPadビルドを実行する。 |
| GitHub経由の配布 | クリーンなスタンドアロン.appバンドルを、GitHub Releases(arm64 + x86_64)のダウンロード可能な.dmgと.zipとしてパッケージ。 |
Catalystプロビジョニングプロファイルとエンタイトルメントが必要で、App Store外配布の人間工学と合わない。 |
Compressor)Compressorの10個のベンダーCライブラリすべてが、-mmacosx-version-min=11.0でユニバーサルmacosx(arm64 + x86_64)スライスをビルドします。
| ライブラリ | バージョン | ios(arm64) |
simulator(arm64 + x86_64) |
macosx(arm64 + x86_64) |
使用者 |
|---|---|---|---|---|---|
sqlite3 |
3.53.3 | はい | はい | はい | MADSqlite3、MAD |
zlib |
1.3.2 | はい | はい | はい | MAD、MADMySQL、MADPostgres、MADBarcodes |
openssl |
3.5.9 | はい | はい | はい | MADTds、MADMySQL、MADPostgres |
bzip2 |
1.0.8 | はい | はい | はい | MAD |
libpng |
1.6.59 | はい | はい | はい | MADBarcodes |
libarchive |
3.8.9 | はい | はい | はい | MAD |
freetds |
1.4.27 | はい | はい | はい | MADTds、MADTdsClient |
mariadb |
3.4.11 | はい | はい | はい | MADMySQL |
postgres |
17.11 | はい | はい | はい | MADPostgres |
zint |
2.16.0 | はい | はい | はい | MADBarcodes |
検証コマンド:
./Compressor/build.sh --verify --all --platforms ios,simulator,macosx
12のフレームワークがマルチプラットフォームスタックを形成します(iphoneos、iphonesimulator、macosx、加えて12のヘッドレスフレームワークのためのLinux)。
MADFoundation(28の.mファイル):
MADApplication.h: <UIKit/UIApplication.h>を#if __APPLE__ではなく#if TARGET_OS_IPHONEでガードする(MADApplication.mはすでに#elif TARGET_OS_OSX #import <AppKit/NSApplication.h>を持つ)。MADURLFactory.m: <UIKit/UIScreen.h>を#if TARGET_OS_IPHONEでガードし、TARGET_OS_OSXではNSScreen.mainScreen.backingScaleFactor > 1.0を使う。MADKeyChain.m: Security.frameworkを使う。それはiOSとmacOSの両方でネイティブ。MADDataStructures(17の.mファイル):
MADFileManager(11の.mファイル):
MADMetaDataLocal.m:16の未使用#import <MobileCoreServices/UTType.h>を削除する(<UniformTypeIdentifiers/UTType.h>はすでに17行目でインポートされている)。MADCocoaExtensions(17の.mファイル):
CGGeometry+Extras.h: TARGET_OS_OSXでUIEdgeInsets(NSEdgeInsets互換のレイアウト構造体 + UIEdgeInsetsMake / UIEdgeInsetsZero / UIEdgeInsetsEqualToEdgeInsets)、NSStringFromCGPoint / NSStringFromCGSize / NSStringFromCGRect、およびNSValue (MADCGGeometryExtensions)(valueWithCGPoint:、CGPointValue、valueWithCGRect:、CGRectValue、valueWithCGSize:、CGSizeValue)を提供する。MADColor.h / MADColor.m: TARGET_OS_OSXでMADColorをNSColorにブリッジし、TARGET_OS_IPHONEではUIColorを保つ。UIView、UIAlertController、UITextField、UIColorカテゴリを#if TARGET_OS_IPHONEでガードする。MADAPI(11の.mファイル):
MADConnectionViewControllerとMADConnectionSQLGenericViewControllerを#if TARGET_OS_IPHONEでガードする。MADSqlite3(26の.mファイル):
sqlite3.xcframework。ソース変更はゼロ。MADTds(1の.mファイル):
freetds.xcframework + openssl.xcframework。ソース変更はゼロ。MADTdsClient(4の.mファイル):
MADDatabaseSQLServer、MADTdsConnection、MADDataTypeSQLServerは純粋なFoundation。MADTdsConnectionViewControllerを#if TARGET_OS_IPHONEでガードする。MADMySQL(19の.mファイル):
mariadb.xcframework。MADMySQLConnectionViewControllerを#if TARGET_OS_IPHONEでガードする。MADPostgres(5の.mファイル):
postgres.xcframework。MADPostgresConnectionViewControllerを#if TARGET_OS_IPHONEでガードする。MADBarcodes(70の.mファイル):
zint.xcframework。MADBarcode、MADBarcodeCache、MADBarcodeView: 既存のCGImageRef MADBarcodeImageFromZintBitmapパイプライン上で、TARGET_OS_OSXでUIImage / NSImageとUIView / NSViewをブリッジする。MAD(199の.mファイル):
RptqObject.m、RptqDocumentElementImage+Extras.m、RptqDocument+Extras.m、RptqDocumentSection+Extras.m、RptqDocumentElement+Extras.m、MADPrintPageElement.m、MADElementStylizedText.m、MADFonts.m、MADReportExporterPDF.m)にまたがる#if __APPLE__を#if TARGET_OS_IPHONEと#elif TARGET_OS_OSXのAppKitブリッジに置き換える。MADReportExporterPDF.mでは、TARGET_OS_OSXでCGPDFContextCreateWithURL / CGPDFConsumerCreateWithCFDataとNSGraphicsContext(+graphicsContextWithCGContext:flipped:YES)を使ってページ分割PDFをレンダリングし、MADPrintPageRendererとMADPrintPageElementがmacOSでネイティブに描画するようにする。UIDocument(MADocument)、UIView、UICollectionViewLayoutファイルを#if TARGET_OS_IPHONEでガードする。MADExplorerはiOS専用のままです(macOSはNSDocumentController、Finder、NSOpenPanelとプライマリのNew Documentボタンを使います)。MADFeedbackとScrimpterはAGENTS.mdにより未使用のままです。
docs/project/registers/BUGS.mdからdocs/project/registers/BUGS_FIXED.mdへアーカイブしました。
MADKeyChain(MADFoundation/Source/MADKeyChain.m): +credentialsExist:、+saveToken:forKey:withDescription:、+deleteKey:、+deleteSavedPasswordForKey:error:でkSecReturnData : @YESを要求すること(および返されたCFDataRefをリークすること)を止めた。MADURLFactory(MADFoundation/Source/MADURLFactory.m): [NSBundle mainBundle].bundleIdentifierがnilのとき+newURLForLocalApplicationSupportDirectoryをガードし([MADApplication groupIdentifier]にフォールバック)、containerURLForSecurityApplicationGroupIdentifier:を#if defined(__APPLE__) && TARGET_OS_IPHONEでガードしたため、エンタイトルメントのないmacOSプロセスは~/Library/Group Containers/でTCCプロンプトをトリガーする代わりに標準のユーザーごとディレクトリを使う。MADDataTable(MADFoundation/Source/MADDataTable.m): NSDataWritingFileProtectionCompleteUnlessOpenを#if defined(__APPLE__) && TARGET_OS_IPHONEでガードし、エンタイトルメントのないmacOSキャッシュ書き込みが成功するようにした。MADDatabaseSqlite3(MADSqlite3/Source/MADDatabaseSqlite3.m): [dataTable endBulkInsert]をif (rowCounter > 0)でガードし、ゼロ行のSELECTクエリが[dataTable beginBulkInsert]が呼ばれていないのにCOMMIT TRANSACTIONを実行しないようにした。MADBarcode(MADBarcodes/MADBarcodes/MADBarcodes/MADBarcode.m): self.center == YESのとき-drawInRect:がrect.originを二重化する不具合を修正した。MADDesignerLayout(MAD/Source/MADDesignerLayout.m): すべてのバルク更新メソッド(setFontsize:、setFontname:、setVerticalAlignment:、setHorizontalAlignment:、setSizeWidth:、setSizeHeight:、setMargin*、setPadding*、setBorder*)でundoアクションを登録するとき、各選択要素自身の以前の値を辞書に保存した。macosxを有効化:
SUPPORTED_PLATFORMS = "iphoneos iphonesimulator macosx"とMACOSX_DEPLOYMENT_TARGET = 12.0を設定した。UIKit.framework参照にplatformFilters = (ios, maccatalyst, );を追加し、必要な場所でAppKit.frameworkをplatformFilters = (macos, );でリンクした。Ensure Librariesビルドフェーズを--platforms ios,simulator,macosxを渡すように更新した。-destination 'platform=macOS,arch=arm64')で12のフレームワークすべてを検証:
MADFoundation: 199テスト合格、0失敗MADDataStructures: 72テスト合格、0失敗MADCocoaExtensions: 80テスト合格、0失敗MADFileManager: 85テスト合格、0失敗MADAPI: 106テスト合格、0失敗MADSqlite3: 118テスト合格(5ベンチマークスキップ)、0失敗MADTds: macosx向けにクリーンにビルドMADTdsClient: 77テスト合格(ライブSQL Serverスイートを含む)、0失敗MADMySQL: すべてのオフライン&ライブMariaDB/MySQLテスト合格、0失敗MADPostgres: 31テスト合格(ライブPostgreSQLスイートを含む)、0失敗MADBarcodes: 30テスト合格、0失敗MAD: 650テスト合格、0失敗NSDocumentレイヤー(完了)MADHeadlessDocument):
MADHeadlessDocument(MAD/Source/MADHeadlessDocument.h、.m)に+createDocumentAtURL:withDatabaseConnection:credentials:error:を追加した。任意の登録ドライバ(SQLite3、MySQL、SQL Server、PostgreSQL)に接続し、すべてのデータベーステーブル(-getTablesFromConnection:error:)と列(-fieldsForTable:connection:error:)をRptqDatabaseSchemaTable / RptqDatabaseSchemaFieldにインポートし、標準レポートセクション(Report Header、Page Header、Report Detail、Page Footer、Report Footer)を初期化し、ポータブル.madコンテナを書く。MADMacDocument(Mac/Source/MADMacDocument.mのNSDocumentサブクラス):
MADHeadlessDocumentをラップし(必要に応じてMADStoreConverterによる自動レガシーCore Data .mad変換付き)、MADocumentDesignerProtocolに準拠してMADDesignerLayoutがundo/redoをNSDocument.undoManagerに直接記録できるようにし、readFromURL:ofType:error:、writeToURL:ofType:forSaveOperation:originalContentsURL:error:、非同期refreshWithCredentials:maxRows:completion:をサポートする。Mac/)(完了)Mac/(Mac/Source/、Mac/Resources/、Mac/Tests/、Mac/build.sh)の下に構築され、MAD Designer Macターゲットと共有スキームを通じてMAD Designer.xcodeprojに統合されました。
MADMacAppDelegate、MADMacAboutWindowController、MADMacDocumentController):
MADStoreLegacyConverterを登録し、ネイティブmacOSメインメニュー(MAD Designer、File、Undo/Redo付きEdit、ワークスペースをCmd+1/Cmd+2/Cmd+3で切り替えるView、Cmd+RでリフレッシュするReport、Window、Help)を構築し、ドキュメントが開いていない状態で起動すると標準NSOpenPanelを提示する。MADMacAboutWindowControllerはネイティブのAbout MAD Designerウィンドウ(MAD Designer → About MAD DesignerとHelpメニュー項目)を提示し、エンジンのバージョン/ビルド(MADMeta.plist)とmacOSアプリケーションのバージョン(CFBundleShortVersionString)を別個の値として示し、著作権と予約済みブランド/アートワーク通知、Source Code on GitHubアクション、および3つのタブ付きセクションを持ちます。Overview(MADとは何か、4ステップのレポーティングワークフロー、サポートされるドライバ/バンド/エクスポーター)、License & Notice(MIT License、NOTICE、FreeTDSとMariaDB Connector/CのLGPL-3.0書面による再リンクの申し出)、Acknowledgements(16のサードパーティオープンソースコンポーネントすべての帰属とContents/Resources/Licenses/にバンドルされた12の完全なライセンステキストを対にしたインタラクティブなサイドバー)。MADMacDocumentControllerはNSOpenPanelをすべての.mad UTType識別子(com.everydayapps.productivity.madとcom.thomason.report.mad)で設定し、既存の.madファイルが決して暗く表示されないようにし、Openパネルの左下バーにプライマリのNew Documentボタンを直接置く。MADMacConnectionWindowController):
NSOpenPanel経由のカスタム.sqlite3/.dbファイル)、MySQL、Microsoft SQL Server、PostgreSQLをサポートし、Test Connection、MADKeyChainのパスワード保存、Create Document…(NSSavePanel)を持つ。MADMacWindowController):
MADMacQueryViewController):
200pxの左側Database Tablesリスト(NSSplitViewDelegateでスナップバックせずにユーザーがリサイズ可能で、ウィンドウリサイズ時は固定幅に保たれビジュアルキャンバスが代わりにリサイズされる)と、インタラクティブな右側ビジュアルキャンバス(MADMacQueryCanvasView)を対にする。スキーマテーブルをダブルクリックするとクエリに追加され(すべてのRptqQueryField行を設定する)、ドラッグ・リサイズ可能なフローティングAppKitテーブルカード(MADMacQueryTableCardView + MADMacQueryFieldTableView)として表示され、トポロジカルなルート/子ヘッダー(MTGraph)でスタイルされ、あるテーブルカードのフィールドから別のカードのフィールドへドラッグするとデフォルトのLeft Outer Join(MADLinkTypeLeftOuterJoin)が作成され、Bezierコネクタと結合型バッジ(MADMacQueryLinksOverlayView、iPadのMADConnectorViewに一致)で描画される。ビジュアル結合コネクタをクリックまたは右クリックすると結合インスペクタポップオーバーまたはコンテキストメニューが開き、リンク型の変更、方向の入れ替え、リンクの削除ができる。ヘッダーポップオーバーはFilters (WHERE)、Groupings (GROUP BY)、Arrange Tablesを提供する。MADSQLParser + MADSQLStatementResolver + MADSQLQueryCompiler)。MADMacDesignerViewController + MADMacDesignerCanvasView + MADMacDesignerMinimapView):
38pt): クリック可能でドラッグ可能なSF Symbol要素パレット項目(Label、Data Field、Aggregate、Barcode、Image、Line)、複数要素のクイック整列コントロール(Left、Center、Right、Top、Middle、Bottom)、Size to Fit、Grid / Snap / Rulersトグル、ワンクリック100%リセット付きのZoomスライダーを提供する。NSSplitViewDelegate): 左ナビゲータサイドバーはデフォルト220pt(180–340pt)、右インスペクタはデフォルト260pt(220–380pt)で、両サイドバーはユーザーのディバイダ調整を保ちながらウィンドウリサイズをまたいで幅を保つ。MADMacDesignerMinimapView): 比例したレポートバンドを色分けストライプ、ライブのミニチュア要素ブロック、青いビューポート矩形で描画する。クリックまたはドラッグでバンドにジャンプして選択する。RptqQueryField列のフィルタ可能なリスト(NSSearchField)。フィールドをキャンバスの任意のセクションバンドにドラッグ(またはダブルクリック)すると、バインドされたRptqDocumentElementLabelDataFieldを挿入する。MADMacDesignerCanvasView): フリップされズーム可能なNSViewキャンバスで、水平/垂直ルーラー、紙マージン、色分けセクションバンド、セクション高さドラッグハンドル、スマート整列ガイド、グリッドスナップ、マーキー選択、Shiftクリック複数選択、8点リサイズハンドル、インラインのダブルクリックラベル編集、スマートな非重複要素配置(-nextAvailableOriginInSection:forElementSize:)、クロスセクションドラッグ&ドロップ(-moveElement:toSection:atOrigin:)とライブのターゲットバンドハイライト、完全なNSUndoManager統合を持つ。1 · PAGE & SELECTED SECTION): 用紙サイズ、選択バンドバッジ、バンド高(pt)とFit Heightボタン、Section Visible、Page Break After。2 · SELECTED ELEMENT INSPECTOR): 4つのグループ化されたインスペクタカード(クロスセクション移動ポップアップ、Duplicate、Delete付きのElement & Band Assignment、静的テキスト、クエリフィールドバインディング、集計関数とスコープ、通貨フォーマット、バーコードオプション付きのContent & Data Binding、フォントファミリ/サイズ、太字/斜体/下線/取り消し線、水平/垂直配置、テキスト/背景色付きのTypography & Appearance、X、Y、W、Hがrect.originとdropPointの両方で同期され、ボーダー、パディング、マージン付きのPosition, Size & Box Model)。MADMacViewerViewController):
40pt): Page Sizeポップアップ(MTPaper標準用紙タイプ: US Letter、US Legal、US Tabloid、A3、A4、A5、B4、B5、JIS B4、JIS B5)、Refresh(Cmd+R)、Zoomコントロール(-、100%、+)、Page Navigation(Previous、Page N of M、Next)、Print…(NSPrintOperation経由のCmd+P)、Export…(Cmd+E)。PDFView): ローカルSQLiteテーブルキャッシュ(MADDataTableFast)から選択された用紙サイズでページ分割PDFページをレンダリングし、ページシャドウと下部ステータスバー(statusBarView)でレンダリングページ数、キャッシュ行数、用紙寸法を表示する。NSSavePanel): 登録された7つのエクスポーターすべて(PDF、HTML、HTML Flow、CSV、JSON、JSON Report、Plain Text)をサポートするアクセサリフォーマットポップアップを設定し、保存パネルの許可ファイル拡張子を動的に更新する。./Mac/build.sh --smoke-test --package
生成物:
Mac/build/MAD Designer.app(12のフレームワークすべてとレガシーCore Data .momdモデルを埋め込み署名した、スタンドアロンのネイティブmacOSアプリバンドル)Mac/build/MAD-Designer-macOS.zipMac/build/MAD-Designer-macOS.dmgネイティブmacOSアプリケーションの公開ユーザーおよび開発者ドキュメントはdocs/macos.md(スクリーンショットはdocs/assets/macos-native-mad-query.pngとdocs/assets/macos-native-mad-designer.png)とMac/README.mdに公開されています。
.github/workflows/macos.ymlはすべてのプルリクエストとmasterへのプッシュで実行されます。Compressor静的ライブラリをビルド(およびキャッシュ)し、ランナーから発見されたiPhoneシミュレータでMADBarcodesとMADスイートを実行し、iOS MAD Designerスキームをビルドし、./Mac/build.sh --smoke-testを実行します。Aboutウィンドウはエンジンバージョン(MADMeta.plist、v9.0 (r4433))とmacOSアプリケーションバージョン(CFBundleShortVersionString、v0.7)を別個の値として報告し、Windows AboutウィンドウのPhase 6f後の提示に一致します。
macos-latestはarm64ランナーで、Mac/build.shはplatform=macOS,arch=arm64向けにフレームワークをビルドします。最初の実行は3プラットフォーム向けのすべての固定サードパーティソースをダウンロードしてコンパイルします(およそ15〜40分)。後の実行はActionsキャッシュからCompressor/libraryを復元し、ensureステップはノーオペレーションです。freetdsレシピはconfig.guess/config.subをSavannahから一度だけリトライなしで取得するため、ワークフローは最初にCompressor/mediaをシードします(ワークフローのコメント参照)。ビルド失敗ではない残差: libarchiveのconfigureステップがCompressorのbzip2インストールではなくSDKのlibbz2.tbdを見つけました。BZIP2_LIBRARYは現代のCMakeのFindBZIP2が読むヒントではないからです。SDKライブラリは存在し、アプリはbzip2 xcframeworkを処理します。
このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。