Difference between revisions of "Projects/KDE on Mac OS X"

Jump to: navigation, search
(downloads are at mac.kde.org now)
(Replacing page with 'This content has been moved to http://mac.kde.org/')
Line 1: Line 1:
== Introduction ==
+
This content has been moved to [[http://mac.kde.org/]]
 
+
KDE on Mac OS X has a long history, but is seeing new life in KDE4 and Qt4/Mac by bringing native KDE4 applications to the Mac OS X desktop.
+
 
+
== About KDE on Mac OS X ==
+
 
+
=== KDE 3 ===
+
 
+
If you are interested in installing KDE 3.x on Mac OS X, check out the [[Projects/KDE on Mac OS X/KDE 3|KDE 3]] page.
+
 
+
=== KDE 4 ===
+
 
+
KDE 4.x on Mac OS X is quickly reaching a stable stage, and currently could be considered a "technology preview".  Official support for Mac OS X is targeted for KDE 4.1.0.
+
 
+
== Goals for KDE on Mac OS X ==
+
 
+
Mac OS X is already a "desktop environment" in the sense that it provides window management, application launching, etc.  The goal of KDE on Mac OS X is to provide the rich frameworks and applications in KDE to a wider audience.
+
 
+
In KDE 4, we intend to have:
+
 
+
* [[Development/Architecture/KDE4/Solid|Solid]] hardware integration
+
* [[Development/Architecture/KDE4/Phonon|Phonon]] support (already finished, thanks to [http://arstechnica.com/journals/linux.ars/2007/12/13/trolltech-contributes-new-phonon-backends-to-kde Trolltech])
+
* [[Development/Architecture/KDE4/Strigi|Strigi]] integration with [http://en.wikipedia.org/wiki/Spotlight_(software) Spotlight]
+
 
+
Perhaps not all of these things will be available by 4.1, but the goal is to do as much as possible for release.
+
 
+
== KDE4 Installation ==
+
 
+
You must install at least Qt, kdesupport, and kdelibs for any of these packages to work. Note that kdelibs requires soprano and strigi.  Also, kdepimlibs and kdebase are recommended since a number of things will want them. (...and it has Konqueror)
+
 
+
=== Source Installation ===
+
The instructions listed for installing amarok from source can be adapted to install other KDE4 programs from source. See http://amarok.kde.org/wiki/Amarok2_On_OS_X for details.
+
 
+
=== Download Torrent Files ===
+
 
+
See [http://mac.kde.org/ the official KDE/Mac web page] for download details.
+
 
+
=== Download CMake (Developers) ===
+
 
+
If you want to compile against these snapshots, you also need cmake.  You can get the latest release from [http://www.cmake.org/HTML/Download.html their download page].
+
 
+
== Running Apps ==
+
 
+
Running apps should usually work from Finder. But if for some reason they don't, you can try these two steps:
+
 
+
=== Environment ===
+
 
+
From the command line, update PATH and launch dbus, like so:
+
 
+
  export PATH="/opt/kde4/bin:/opt/kde4-deps/bin:/opt/qt4/bin:$PATH"
+
  eval `dbus-launch --auto-syntax`
+
 
+
=== Launching ===
+
 
+
Then, to start an app, you call it from the same terminal, like this:
+
 
+
  open /opt/kde4/bin/konqueror.app
+
 
+
NOTE: Don't try to start the 'real' binary directly, like so:
+
 
+
/opt/kde4/bin/konqueror.app/Contents/MacOS/konqueror
+
 
+
since this will result in various interactions with the OS (drag and drop, for example) not working.
+
 
+
=== Troubleshooting ===
+
 
+
Sometimes, Installer.app fails to run the post-install.  Try running:
+
 
+
  /opt/kde4-deps/bin/update-kde-mac.sh
+
 
+
...and see if your application starts.
+
 
+
== Development (Helping Out) ==
+
 
+
=== Building ===
+
 
+
If you'd like to try building KDE yourself, it should (mostly) work out of the box.  You can get [[Projects/KDE on Mac OS X/Tips On Building|tips on building here]] (including a link to the tools I use to generate these packages).
+
 
+
=== TODO ===
+
 
+
There's still a lot to do.  I'm going to try to keep a running list of what needs to be done on the [[Projects/KDE on Mac OS X/TODO|TODO]] page.
+
 
+
=== Communicating (Real Time) ===
+
 
+
You can find the KDE4/Mac developers in the [irc://irc.freenode.net/%23kde-mac #kde-mac] IRC channel on FreeNode and folks working on KDE4 in general in the [irc://irc.freenode.net/%23kde-devel #kde-devel] channel. This should be the first place you look. If you have a question, be patient, sometimes we're logged in but not looking at IRC all the time. If you stick around, we'll answer.
+
 
+
=== Communicating (E-Mail) ===
+
 
+
The official list for KDE/Mac development is [https://mail.kde.org/mailman/listinfo/kde-mac kde-mac@kde.org].
+
 
+
There are lots of great mailing lists for more general KDE discussion. For a complete list, see [http://lists.kde.org/ the KDE mailing list page]. The KDE/Mac developers have been known to hang out on kde-buildsystem, kde-devel, and kde-nonlinux.
+
 
+
=== Bugs (Finding, and Reporting) ===
+
 
+
First of all, before doing anything else, check the [http://bugs.kde.org/ KDE bug page] to see if your problem has already been reported.  If so, add as much as you can to the existing bug report to make it easier for developers to figure out what's gone wrong.
+
 
+
You might also want to try [[#Communicating (Real Time)|the IRC channel(s)]] before filing a bug, you're more likely to get a quick response there.  Also be aware, we know there's still stuff broken on Mac OS X, so be gentle. :)
+
 
+
[[Category:Mac OSX]]
+

Revision as of 03:05, 1 July 2008

This content has been moved to [[1]]


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal