|
|
(23 intermediate revisions by 7 users not shown) |
Line 1: |
Line 1: |
| == Install required tools and libraries ==
| | #REDIRECT [[Get_Involved/development/Mac]] |
| Required tools and libraries can be installed using ''either'' Homebrew or Macports, as described below.
| |
| | |
| In ''both'' cases, you will need to download and install [https://developer.apple.com/xcode/ XCode], first.
| |
| | |
| === Homebrew (plus official Qt installer) ===
| |
| * Install Qt (use the official Qt installer, recommended version Qt >= 5.6)
| |
| * Install homebrew and get some basic dependencies (http://brew.sh/)
| |
| /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
| |
| brew install cmake wget coreutils p7zip gettext ninja python3 bison boost shared-mime-info
| |
| * Optional: You might need some extra environment variables
| |
| | |
| export CMAKE_LIBRARY_PATH=/usr/local/Cellar/gettext/0.19.8.1/lib
| |
| export CMAKE_INCLUDE_PATH=/usr/local/Cellar/gettext/0.19.8.1/include
| |
| export PATH=/usr/local/Cellar/bison/3.0.4/bin:$PATH
| |
|
| |
| # Setup environment (path must contain your Qt install, here 5.7 default location and brew's gettext)
| |
| export PATH=/Users/cullmann/Qt5.7.0/5.7/clang_64/bin:/usr/local/Cellar/gettext/0.19.7/bin:$PATH
| |
| | |
| === Macports (including Qt) ===
| |
| * Install Macports
| |
| * Install basic dependencies and tools:
| |
| sudo port install git qt56 cmake wget coreutils p7zip gettext ninja python36 bison boost shared-mime-info
| |
| * Add GNU coreutils to your path:
| |
| export PATH=/opt/local/libexec/gnubin/:$PATH
| |
| | |
| == Install Craft ==
| |
| # Prepare some build directory in your home directory, here we assume:
| |
| mkdir ~/kf
| |
| # Switch to this build dir
| |
| cd ~/kf
| |
| # Get Craft
| |
| git clone git://anongit.kde.org/craft.git
| |
| # Copy Mac OS X config template to right location, should be OK to use out of the box
| |
| mkdir etc
| |
| cp craft/kdesettings.mac etc/kdesettings.ini
| |
| | |
| == Using craft ==
| |
| * Every time you want to use craft in a new shell, you need to set up the craft environment, first:
| |
| . craft/kdeenv.sh
| |
| | |
| * In this shell, now craft is usable, e.g. to build Kate with all dependencies:
| |
| craft kate
| |
| | |
| == Deploying applications ==
| |
| * To create a app bundle (+ dmg file), you need to have the breeze-icons around:
| |
| craft breeze-icons
| |
| | |
| * To do deploy all things, unfortunately at the moment you need a patched macdeployqt. Example scripty for kate can be found on [https://quickgit.kde.org/?p=kate.git&a=blob&f=mac%2Femerge-deploy.sh kate.git/mac/emerge-deploy.sh]
| |
| ** If you installed qt using Macports, your copy of macdeployqt ''should'' be patched, already. It will not be in your system path by default, however. Find it at /opt/local/libexec/qt5 .
| |