summaryrefslogtreecommitdiff
path: root/pages/docs/distros/osx-start.txt
diff options
context:
space:
mode:
authorAndrew Williams <andy@andywilliams.me>2018-01-05 07:57:19 -0800
committerapache <apache@e5-web1.enlightenment.org>2018-01-05 07:57:19 -0800
commit0e1b2f5ec535e7f4854d0dd859831f0f1d09d788 (patch)
treeb9682eb1d5db5fe1ddbe072e73de9ad3cf31c159 /pages/docs/distros/osx-start.txt
parent1875029eb0a9502329245d8bba03355a8046e083 (diff)
Wiki page osx-start.md changed with summary [created] by Andrew Williams
Diffstat (limited to '')
-rw-r--r--pages/docs/distros/osx-start.txt113
1 files changed, 0 insertions, 113 deletions
diff --git a/pages/docs/distros/osx-start.txt b/pages/docs/distros/osx-start.txt
deleted file mode 100644
index 63c071502..000000000
--- a/pages/docs/distros/osx-start.txt
+++ /dev/null
@@ -1,113 +0,0 @@
1~~Title: EFL on Mac OS X~~
2
3<note warning>
4If 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 (but any help is very welcomed).
5</note>
6
7The Enlightenment Foundation's projects mostly targets Linux platforms, therefore not everything work on Mac OS X works the first time. This is due to:
8 * the specificities of the Operating System (kernel+userland);
9 * the fact there are a very few Enlightened OS X users :-\
10
11This document explains how to install the EFL which are key projects to install anything else made by the Enlightenment Foundation.
12
13
14====== Mac OS X Homebrew Packages (for EFL USERS) ======
15
16Homebrew is a package manager for Mac OS X. See at http://brew.sh how to install Homebrew if it isn't already installed.
17Then, just execute:
18
19<code bash>
20brew update # To make sure you have the latest versions
21brew install efl # To install EFL
22</code>
23
24And that's it! Enjoy your freshly distributed EFL :-).
25The distributed version of EFL is [[http://braumeister.org/formula/efl|1.20.4]].
26
27
28====== Manual Installation (for EFL DEVELOPERS) ======
29
30===== Setting up the environment =====
31
32You need to have the OS X CLT (Command-Line Tools) first, then install the EFL dependancies. The easiest way is by using a package manager. [[http://brew.sh|Homebrew]] is assumed to be the package manager.
33
34<note important>
35The CTL are not bundled with Xcode. Don't assume that they are installed if Xcode is installed.
36</note>
37
38To install the CTL, you should process as it follows:
39 * download the latest version of Xcode on the Mac App Store;
40 * run ''xcode-select --install'' in a terminal to install the CLT.
41
42
43If you want to have the very latest version of EFL, here is the procedure:
44 * install the dependancies;
45 * configure the source;
46 * compile the sources and install them.
47
48===== Dependancies with Homebrew =====
49
50<code bash>
51brew install autoconf automake libtool autoconf-archive gettext check pkg-config luajit jpeg freetype fribidi fontconfig giflib libtiff glib dbus libsndfile bullet libspectre libraw librsvg poppler gstreamer gst-plugins-good pulseaudio
52brew migrate dbus
53mkdir -p ~/Library/LaunchAgents
54ln -sfv /usr/local/opt/dbus/*.plist ~/Library/LaunchAgents
55launchctl load ~/Library/LaunchAgents/org.freedesktop.dbus-session.plist
56</code>
57
58You need to add ''autopoint'' to your ''$PATH'' if you want to use gettext. Write the line below in your ''$HOME/.profile'' or similar file.
59
60<code bash>
61export PATH="$(brew --prefix gettext)/bin:$PATH"
62</code>
63
64===== OpenSSL handling =====
65
66Since Mac OS X El Capitan, Apple does not distribute OpenSSL headers anymore.
67It is necessary to install OpenSLL manually through homebrew:
68
69<code bash>
70brew install openssl
71brew link openssl --force
72</code>
73
74and to add flags to your bashrc (or equivalent):
75
76<code bash>
77export CFLAGS="-I/usr/local/opt/openssl/include $CFLAGS"
78export LDFLAGS="-L/usr/local/opt/openssl/lib $LDFLAGS"
79</code>
80
81===== Modifying your linker flags =====
82
83<note>
84This step is **required** if you wish to build Mac OS X App Bundles (i.e. ''.app''). Otherwise, you can safely ignore this section.
85</note>
86
87''osx-packager'' is a python package initially developed at Open Wide to
88generate App Bundles and/or DMG files for easy distribution.
89It is available at [[https://git.enlightenment.org/devs/jayji/osx-packager.git]].
90
91To make it work, you **MUST** provide custom linker flags:
92
93<code bash>
94export LDFLAGS="-Wl,-headerpad_max_install_names ${LDFLAGS}"
95</code>
96
97===== Configuring, Building and Installing EFL =====
98
99Installing dependancies on OS X is painful, but now you did it (congrats'), you can grab the sources from the git repository:
100
101<code bash>
102git clone https://git.enlightenment.org/core/efl.git # Get the sources
103cd efl # Go to repository you cloned
104./autogen.sh --disable-cxx-bindings
105make -j $(nproc) # Compile
106sudo make -j $(nproc) install # Install
107</code>
108
109
110======= Additional Resources =======
111
112 * Enlightenment Developer Days 2016 Slides (EFL & Mac OS X slides): https://phab.enlightenment.org/F36470.
113 * Internal Wiki Page. Contains “legacy” information: https://phab.enlightenment.org/w/osx/. \ No newline at end of file