Mac: Difference between revisions

From KDE Community Wiki
(Describe how to open KDE apps)
 
(41 intermediate revisions by 10 users not shown)
Line 1: Line 1:
== Building KDE Frameworks based software on Mac OS X ==
== Application Bundles ==


* Install Qt (use the official Qt installer, recommended version Qt >= 5.6)
Several KDE applications have downloads with application bundles for macOS available.


* Install Python >= 3.5 (using the pkg installer from http://python.org)
* [https://www.digikam.org/download/binary/#MacOS digiKam]


* Install homebrew and get some basic dependencies (http://brew.sh/)
* [https://kate-editor.org/get-it/ Kate & KWrite]
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install cmake p7zip gettext ninja


* Prepare some build directory in your home directory, here we assume:
* [https://krita.org/en/download/krita-desktop/ Krita]
mkdir ~/kf


* Switch to this build dir
* [https://kmymoney.org/download.html KMyMoney]
cd ~/kf


* Get the unix3 branch of KDE emerge
* [https://labplot.kde.org/download/ LabPlot]
git clone kde:emerge
cd emerge
git checkout unix3
cd ~/kf


* Copy Mac OS X config template to right location, should be OK to use out of the box
* [https://kdenlive.org/download/ Kdenlive]
mkdir etc
cp emerge/kdesettings.mac etc/kdesettings.ini


* Setup environment (path must contain your Qt install, here 5.7 default location)
Additional macOS installers of KDE applications are available at https://cdn.kde.org/ci-builds/ .
export PATH=/Users/cullmann/Qt5.7.0/5.7/clang_64/bin:$PATH
. emerge/kdeenv.sh


== Installing KDE software on Mac OSX ==
See also https://apps.kde.org/platforms/macos .


The easiest way to do this is to use one of the Mac build systems which will automatically resolve all the dependencies for you. Unfortunately, this can be a very long process, taking up to 2 or more days. As at December 2012 MacPorts is currently recommended as it is the most up-to-date.
== Install KDE apps on macOS ==


=== Installing using MacPorts ===
[[File:MacOS-gatekeeper-warning.jpg|thumb|alt=Message dialog: "Apple can’t check app for malicious software"]]


* http://www.macports.org/
Apple is very strict about running apps downloaded from the internet. KDE apps are signed, but for technical limitations on the KDE infrastructure not yet notarized. Notarization means that the app is send to Apple to check it.


As of June 2016, the latest available and supported version is KDE SC 4.14.3.
Hence you will likely see a message "Apple can’t check app for malicious software" when trying to open a KDE app.


Instructions are provided on TechBase for [https://techbase.kde.org/Getting_Started/Build/Mac_OS_X/MacPorts installing a development environment using MacPorts]. If you want a user installation then just skip the final 'Configure your KDE development environment' section.
To open your app anyway follow these steps:


Additional information:
# In the Finder on your Mac, locate the app you want to open. Don’t use Launchpad to locate the app.
# Open the shortcut menu by right-click to the app icon or by holding the <keycap>Control</keycap> key and left-click.
# Choose <menuchoice>Open</menuchoice> from the shortcut menu.
# A message dialog opens. Click Open.


* [https://techbase.kde.org/Getting_Started/Build/Mac_OS_X/MacPorts KDE Techbase page on getting started with MacPorts]
The app is saved as an exception to your security settings, and from now on you can open it at any time by double-clicking it, just as you do with any registered app.
* [https://trac.macports.org/wiki/KDE Wiki page on macports.org about KDE software in general]
* [https://trac.macports.org/wiki/KDEProblems Wiki page on macports.org about current problems with KDE software]


=== Installing using Fink ===
For further instructions see Apples support page: https://support.apple.com/guide/mac-help/mchleab3a043/mac


* http://www.finkproject.org/
<br clear=all>


As of June 2016, the latest available and supported version is KDE SC 4.14.6.
== Getting in Touch ==


The Fink packages allow you to install KDE SC 4 as either Qt/X11 or Qt/Mac (native) packages by selecting either packages ending in "-x11" or "-mac", for example "kdebase4-x11" and "kdebase4-mac".
* IRC: [irc://irc.libera.chat/kde-mac #kde-mac] on Libera Chat


Additionally, the Fink packages allow the running of the Plasma desktop in X11 mode. Just install "kdebase4-workspace-x11" to install it.
* Mailing list: [mailto:kde-mac@kde.org kde-[email protected]] ([https://mail.kde.org/mailman/listinfo/kde-mac  subscribe], [http://lists.kde.org/?l=kde-mac&r=1&w=2 archives])


The Fink KDE software packages will be installed in /sw/opt/kde4/x11 or /sw/opt/kde4/mac respectively. They also are able to start D-Bus for you as long as you run "/sw/bin/init.sh" normally, or when you open a terminal, if you have run the path setup script in the Fink installer.
* Forums: https://discuss.kde.org/search?q=macos


=== Installing using Homebrew ===
== Development & Alternative Installation Methods ==
* [[Get_Involved/development/Mac|Build from source]].
* [[Mac/MacPorts_Fink_Homebrew|Installing KDE software via MacPorts/Fink/Homebrew]].


==== Installing KDevelop and Kate using Homebrew (KDE4-based) ====


* https://github.com/adymo/homebrew-kde
__NOTOC__
 
As of June 2016, the latest available and supported version is KDE SC 4.14.3.
 
You can tap this repository into your homebrew. It installs the following apps and all their dependencies:
 
* KDevelop
* Kate
* Konversation
* Massif Visualizer
 
Please carefully follow installation instructions on that above page.
 
==== Installing KDE Frameworks 5 using Homebrew ====
 
* https://github.com/haraldF/homebrew-kf5
 
As of June 2016, the latest available and supported version is KDE SC 5.22.0.
 
You can tap this repository into your homebrew. It adds KDE Frameworks 5 packages (and all their dependencies) and some applications that already make use of them (e.g. Kate and Kwrite). As of March 28th, 2014 the repository still is experimental as the developer tries to get them into a working state. Hints and patches are welcome.
 
Please carefully follow [https://github.com/haraldF/homebrew-kf5 installation instructions].
 
=== Standalone Application Installers ===
 
Some KDE applications provide a standalone installer, usually in a Qt only mode and missing some KDE software integration features.
 
* [http://edu.kde.org/marble/download.php Marble Virtual Globe] v1.5.0 (outdated)
 
== Running KDE Applications ==
 
Please see the distribution notes for MacPorts / Fink / Homebrew formulas you are using. You may need to run the following steps once after installation:
 
sudo chown -R $USER ~/Library/Preferences/KDE
sudo launchctl load  -w /Library/LaunchDaemons/org.freedesktop.dbus-system.plist
 
Sometimes, Installer.app fails to run the post-install. If things are acting funny, try running these two commands in a terminal:
 
sudo launchctl load -w /Library/LaunchAgents/org.freedesktop.dbus-session.plist
/opt/local/bin/kbuildsycoca4
 
== Getting Help ==
 
IRC:
* #kde-mac on Freenode
 
Mailing list:
* https://mail.kde.org/mailman/listinfo/kde-mac
 
Forums:
* http://forum.kde.org/viewforum.php?f=60
 
Bugs:
* [http://bugs.kde.org/buglist.cgi?query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDSINFO&op_sys=OS+X bugs.kde.org]
 
== Continuous Integration ==
 
In the [http://community.kde.org/Frameworks Frameworks] section of this wiki you find more information about [http://community.kde.org/Frameworks/Epics/Continuous_Integration Continuous Integration on Mac] and other systems.

Latest revision as of 13:36, 10 March 2024

Application Bundles

Several KDE applications have downloads with application bundles for macOS available.

Additional macOS installers of KDE applications are available at https://cdn.kde.org/ci-builds/ .

See also https://apps.kde.org/platforms/macos .

Install KDE apps on macOS

Message dialog: "Apple can’t check app for malicious software"

Apple is very strict about running apps downloaded from the internet. KDE apps are signed, but for technical limitations on the KDE infrastructure not yet notarized. Notarization means that the app is send to Apple to check it.

Hence you will likely see a message "Apple can’t check app for malicious software" when trying to open a KDE app.

To open your app anyway follow these steps:

  1. In the Finder on your Mac, locate the app you want to open. Don’t use Launchpad to locate the app.
  2. Open the shortcut menu by right-click to the app icon or by holding the Control key and left-click.
  3. Choose Open from the shortcut menu.
  4. A message dialog opens. Click Open.

The app is saved as an exception to your security settings, and from now on you can open it at any time by double-clicking it, just as you do with any registered app.

For further instructions see Apples support page: https://support.apple.com/guide/mac-help/mchleab3a043/mac


Getting in Touch

Development & Alternative Installation Methods