From ad77140035eb38002fbad4c2f4f34872b19459fc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?A=20C=C5=93ur?= Date: Wed, 19 Oct 2022 04:23:26 +0800 Subject: [PATCH] doc: Building the GTK app on macOS (#3982) --- docs/Building-Transmission.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/docs/Building-Transmission.md b/docs/Building-Transmission.md index dd477ddf7..7abd0da32 100644 --- a/docs/Building-Transmission.md +++ b/docs/Building-Transmission.md @@ -2,15 +2,40 @@ The source code for both official and nightly releases can be found on our [download page](https://transmissionbt.com/download/). ## On macOS ## -Transmission has an Xcode project file (Transmission.xcodeproj) for building in Xcode. Make sure you have this software: +Software prerequisites: * macOS 10.14.4 or newer * Xcode 11.3.1 or newer Building the project on Mac requires the source to be retrieved from GitHub. Pre-packaged source code will not compile. +```console +git clone --recurse-submodules https://github.com/transmission/transmission Transmission +``` If building from source is too daunting for you, check out the [nightly builds](https://build.transmissionbt.com/job/trunk-mac/). (Note: These are untested snapshots. Use them with care.) +### Building the native app with Xcode ### +Transmission has an Xcode project file for building in Xcode. +- Open Transmission.xcodeproj +- Run the Transmission scheme + +### Building the native app with ninja ### +Build the app: +```console +cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo +ninja -C build transmission-mac +open ./build/macosx/Transmission.app +``` + +### Building the GTK app with ninja ### +Install GTK and build the app: +```console +brew install gtk4 gtkmm4 +cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DENABLE_GTK=ON -DENABLE_MAC=OFF +ninja -C build transmission-gtk +./build/gtk/transmission-gtk +``` + ## On Unix ## ### Prerequisites ### #### Ubuntu ####