diff --git a/pages/distros/osx-start.txt b/pages/distros/osx-start.txt new file mode 100644 index 000000000..ac3dc39fc --- /dev/null +++ b/pages/distros/osx-start.txt @@ -0,0 +1,81 @@ +~~Title: EFL on Mac OS X~~ + + +If you are coming here for Enlightenment (the desktop manager) on Mac OS X... sorry but Enlightenment is not supported on Mac OS X... and it is not planned in a near future. + + +The Enlightenment Foundation's projects mostly targets Linux platforms, therefore not everything work on Mac OS X works the first time. This is due to: + * the specificities of the Operating System (kernel+userland); + * the fact there are a very few Enlightened OS X users :'( + +This document explains how to install the EFL/Elementary which are key projects to install anything else made by the Enlightenment Foundation. It also shows what does not work on OS X that does on Linux. + +====== Setting up the environment ====== + +You need to have the OS X CLT (Command-Line Tools) first, then install the dependancies. The easiest way is by using a package manager. [[http://brew.sh|Homebrew]] is assumed to be the package manager. + + +The CTL are not bundled with Xcode. Don't assume that they are installed if Xcode is installed. + + +To install the CTL, you should process as it follows: + * download the latest version of Xcode on the Mac App Store; + * run ''xcode-select --install'' in a terminal to install the CLT. + +====== Mac OS X Homebrew Packages (not advised) ====== + + +Mac OS X packages are outdated. They might work, but you SHOULD instead consider manual installation since EFL on Mac OS X are still experimental. + + +Since mid-April 2015, Leif Middelschulte provided Homebrew formulas for: + * EFL 1.14.y + * Elementary 1.14.y + * evas-generic-loaders 1.14.y + +See at http://brew.sh how to install Homebrew if it isn't already installed. +Then, just execute : + + +brew update # Just to refresh homebrew +brew install efl # To install EFL +brew install elementary # To install Elementary +brew install evas-generic-loaders # To install evas-generic-loaders + + +====== Manual Installation (recommanded) ====== + +If you want to have the very latest version of EFL, here is the procedure: + * install the dependancies; + * configure the source; + * compile the sources and install them. + +===== Dependancies with Homebrew ===== + + +brew install autoconf automake libtool autoconf-archive gettext check pkg-config luajit libjpeg freetype fribidi fontconfig giflib libtiff glib dbus libsndfile bullet +brew migrate dbus +mkdir -p ~/Library/LaunchAgents +ln -sfv /usr/local/opt/d-bus/*.plist ~/Library/LaunchAgents +launchctl load ~/Library/LaunchAgents/org.freedesktop.dbus-session.plist + + +You need to add `autopoint` to your `$PATH` if you want to use gettext. Write the line below in your ''$HOME/.profile'' or similar file. + + +export PATH="$(brew --prefix gettext)/bin:$PATH" + + + +===== Configuring, Building and Installing EFL ===== + +Installing dependancies on OS X is painful, but now you did it (congrats'), you can grab the sources from the git repository: + + +git clone git://git.enlightenment.org/core/efl.git # Get the sources +cd efl # Go to repository you cloned +./autogen.sh --disable-gstreamer --disable-gstreamer1 --disable-pulseaudio +make -j $(nproc) # Compile +sudo make -j $(nproc) install # Install + +