Skip to content

Fixed Mac silicon/intel compatibility issues#337

Open
SkynetTZ wants to merge 2 commits into
Adaptix-Framework:dev-v1.3from
SkynetTZ:main
Open

Fixed Mac silicon/intel compatibility issues#337
SkynetTZ wants to merge 2 commits into
Adaptix-Framework:dev-v1.3from
SkynetTZ:main

Conversation

@SkynetTZ
Copy link
Copy Markdown

@SkynetTZ SkynetTZ commented Jun 4, 2026

macOS Build Support Improvements

This contribution adds documentation and setup guidance for building the AdaptixClient on macOS (Apple Silicon and Intel).

Issues Identified

  • CMake could not locate Qt6 packages installed through Homebrew.
  • Qt6 modules (Svg, WebSockets, Qml) were installed separately and were not automatically discovered during configuration.
  • Existing qt@5 installations caused Homebrew linking conflicts with Qt6 components.
  • The client failed to launch after a successful build because Qt could not locate the macOS Cocoa platform plugin (libqcocoa.dylib).

Changes

  • Added macOS-specific build instructions.

  • Documented required Homebrew dependencies:

    • qtbase
    • qtdeclarative
    • qtsvg
    • qtwebsockets
  • Added guidance for resolving Qt5/Qt6 conflicts.

  • Documented CMake configuration using explicit Qt6 module paths.

  • Added runtime instructions for configuring Qt plugin paths on macOS.

  • Added a setup-macos.sh helper script to simplify environment setup.

Tested On

  • macOS Apple Silicon (arm64)
  • Homebrew Qt 6.11.1
  • Successful configuration, compilation, and execution of AdaptixClient

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant