PDF version Edit on GitHub 

Building Polyphone for Mac OS X

Use these instructions if you cannot install Polyphone on your Mac with the available installers in the section “Software”.

Prerequisite

The following applications are required:

• Qt Creator with its framework ,
• Xcode or just the "Command Line Tools" (the version to use is specified on the Qt website - here  for instance).

You also need the sources of Polyphone, available here  or on GitHub , along with the necessary libraries you can download here.

For correctly opening a project with Qt Creator, it must first be given the permission to read all files from your computer (in "Security and privacy" => "Full disk access" => add "Qt creator.app" which is in its installation directory).

If some of the previously provided libraries are not up to date or not compatible with the version of Mac, like SSL for example, it will be necessary to look for their sources on the internet and to recompile them by enabling a static linking:

configure --enable-static --disable-shared --prefix=...
make
make install

Then copy all .h (headers) and .a (static libraries).

Another way to get the libraries already built is to use Homebrew . After installing this tool, it is for example possible to get "libsndfile" along with its dependencies with this command:

arch -x86_64 brew install libsndfile

The .h and .a files will then be located in "/usr/local/Cellar".

Build

Unzip the libraries and place the directory macos just next to the directory sources.

Open the file polyphone.pro with Qt Creator. Build the project, a bundle polyphone.app should appear in the directory macos.

If the SDK path cannot be resolved, try modifying this variable in file polyphone.pro for matching your SDK version (linked to the Xcode version):

QMAKE_MAC_SDK = macosx10.15

If the compiler is now complaining that some features are not available with the specified MacOS target, you can increase this variable in the .pro file:

QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15

This value is also to be written in file "sources/contrib/mac/polyphone.plist" below "LSMinimumSystemVersion".

Complete the bundle

Run the following command to include libraries and frameworks inside the bundle (adjust the path first!):

/Path/To/Qt/5.2.0/clang_64/bin/macdeployqt /Path/To/macos/polyphone.app

You can then execute the program or compress it as a .zip or .dmg file to share it.

Troubleshooting

See this topic if you need more information or for getting some help.