summaryrefslogtreecommitdiff
path: root/pages/docs
diff options
context:
space:
mode:
authorAndrew Williams <andy@andywilliams.me>2018-01-05 07:44:40 -0800
committerapache <apache@e5-web1.enlightenment.org>2018-01-05 07:44:40 -0800
commitfb61497a5b952fa32d92aef9d0dc07b1829597fe (patch)
treef1ba1c7c275ac93f4e3ff7b051b4f2eeeaf45f33 /pages/docs
parent99d5d959a2d212333e61e162325529a363e911c9 (diff)
Wiki page debian-start.md changed with summary [created] by Andrew Williams
Diffstat (limited to 'pages/docs')
-rw-r--r--pages/docs/distros/debian-start.md.txt155
1 files changed, 155 insertions, 0 deletions
diff --git a/pages/docs/distros/debian-start.md.txt b/pages/docs/distros/debian-start.md.txt
new file mode 100644
index 000000000..512b35cf5
--- /dev/null
+++ b/pages/docs/distros/debian-start.md.txt
@@ -0,0 +1,155 @@
1---
2~~Title: Installing EFL on Debian~~
3~~NOCACHE~~
4---
5
6# Installing EFL on Debian #
7
8[The *Enlightenment Foundation Libraries (EFL)*](/about-efl.md) power millions of systems from mobile phones to set-top boxes, desktops, laptops, game systems and more. You'll need EFL if you want to develop apps for Enlightenment and for any of the devices that use Enlightenment for its visual interface.
9
10This tutorial describes several ways to install EFL on your system. You will only need to use one of these. Select your chosen method using the index on the right.
11
12Many distributions offer EFL as an installable package from their default repositories. In this case you only need to use your distribution's software management system to install. However most versions of EFL in default repositories are out of date and will not compile more recent Enlightenment applications. If this is not an issue for you, read through the ["From Distribution Repositories"](#From_Distribution_Repositories) section below.
13
14Distributions often provide a special repository maintained by users or a method of integrating a bleeding edge version of EFL with your software management system. This means that once installed you can keep EFL current just by running system updates. If your distribution offers this, take a look at the section ["Installing from a Special Repository"](#Installing_from_a_Special_Repository).
15
16The Enlightenment developers provide a pre-packaged source of EFL. Although not bleeding edge it is up to date and considered stable for production environments. You can download, compile and install it yourself by following the instructions in ["Installing from Packaged Source"](#Installing_from_Packaged_Source).
17
18You can also download the source code for the most recent version from the EFL git repositories. This will provide you with the latest code, which is updated on a nightly basis. To get started, read the section ["Installing from Git"](#Installing_from_Git).
19
20Whichever installation method you use, visit ["Compiling EFL Applications"](#Compiling_EFL_Applications) to discover how to compile your Enlightenment applications.
21
22## From Distribution Repositories ##
23
24There's no EFL package in the official Debian repositories nor in any of the working user-maintained repositories. In light of this either [install EFL from the packaged source](#Installing_from Packaged_Source) or [download and install the most recent source code from the git repository](Installing_from_Git) as described below.
25
26## Installing from Packaged Source ##
27
28There are two versions of EFL available from the Enlightenment website. One is the nightly bleeding edge version which you can [download using git](#Installing_from_Git). The other comes already packaged and is available from the [EFL's download site](https://download.enlightenment.org/rel/libs/efl/), which is the focus of this section.
29
30### Step 1: Downloading Stable Version ###
31
32[Download the latest version of EFL](https://download.enlightenment.org/rel/libs/efl/) and check it against its SHA256 hash:
33
34```bash
35wget https://download.enlightenment.orgtar /rel/libs/efl/efl-X.XX.X.tar.xz
36wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz.sha256
37cat efl-X.XX.X.tar.xz.sha256; sha256sum efl-X.XX.X.tar.xz
38```
39
40Note that you will have to change ``X.XX.X`` to the actual version of EFL.
41
42### Step 2: Unpacking ###
43
44Once you have the archive file containing EFL on your hard disk unpack it with:
45
46```bash
47tar xvf efl-X.XX.X.tar.xz
48```
49
50This will create a folder named *efl-X.XX.X*.
51
52### Step 3: Installing Dependencies ###
53
54In order to compile and install EFL, first download the necessary software:
55
56```bash
57su -c "apt install gcc g++ check libssl-dev libsystemd-dev libjpeg-dev libglib2.0-dev libgstreamer1.0-dev libluajit-5.1-dev libfreetype6-dev libfontconfig1-dev libfribidi-dev libx11-dev libxext-dev libxrender-dev libgl1-mesa-dev libgif-dev libtiff5-dev libpoppler-dev libpoppler-cpp-dev libspectre-dev libraw-dev librsvg2-dev libudev-dev libmount-dev libdbus-1-dev libpulse-dev libsndfile1-dev libxcursor-dev libxcomposite-dev libxinerama-dev libxrandr-dev libxtst-dev libxss-dev libbullet-dev libgstreamer-plugins-base1.0-dev doxygen"
58```
59
60### Step 4: Building and Installing ###
61
62Once you have installed all the required packages to compile and install EFL, ``cd`` into the *efl-X.XX.X* folder and run
63
64```bash
65./configure
66make
67su -c "make install"
68```
69
70This will configure the files needed to compile software, then compile and install it.
71
72### Step 5: Carrying out Post Installation Tasks ###
73
74As you are not installing to */usr* but to */usr/local*, ensure that some files are visible to *dbus*:
75
76```bash
77su -c "ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service"
78```
79
80You may also need to refresh your library path to make sure your apps can find the EFL libraries:
81
82```bash
83su -c "ldconfig"
84```
85
86## Installing from Git ##
87
88You can also get the bleeding edge version of EFL by cloning it from the git repository.
89
90### Step 1: Installing git and Cloning ###
91
92By default, *git* is not installed in Debian so the first step is to install it:
93
94```bash
95su -c "apt install git"
96```
97
98Next clone EFL's source code:
99
100```bash
101git clone https://git.enlightenment.org/core/efl.git
102```
103
104This will create a a directory named *efl/*.
105
106### Step 2: Installing Dependencies ###
107
108You'll need to install some tools to build the configuration file:
109
110```bash
111su -c "apt install autoconf autopoint libtool"
112```
113
114You'll also need to download the software dependencies for EFL itself:
115
116```bash
117su -c "apt install gcc g++ check libssl-dev libsystemd-dev libjpeg-dev libglib2.0-dev libgstreamer1.0-dev libluajit-5.1-dev libfreetype6-dev libfontconfig1-dev libfribidi-dev libx11-dev libxext-dev libxrender-dev libgl1-mesa-dev libgif-dev libtiff5-dev libpoppler-dev libpoppler-cpp-dev libspectre-dev libraw-dev librsvg2-dev libudev-dev libmount-dev libdbus-1-dev libpulse-dev libsndfile1-dev libxcursor-dev libxcomposite-dev libxinerama-dev libxrandr-dev libxtst-dev libxss-dev libbullet-dev libgstreamer-plugins-base1.0-dev doxygen"
118```
119
120### Step 3: Configuring the Software ###
121
122You can now ``cd`` into the *efl\* directory and run the *autoreconf* script to create and configure the software ready for compilation:
123
124```bash
125./autogen.sh
126```
127
128Once configured, compile the software with:
129
130```bash
131make
132su -c "make install"
133```
134
135### Step 4: Carrying out Post Installation Tasks ###
136
137As you are not installing to */usr* but to */usr/local*, you will have to ensure that some files are visible to *dbus*:
138
139```bash
140su -c "ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service"
141```
142
143You may also need to refresh your library path to make sure your apps can find the EFL libraries:
144
145```bash
146su -c "ldconfig"
147```
148
149## Troubleshooting ##
150
151If you're having problems compiling and installing EFL, you can find help on any of [our IRC channels](https://www.enlightenment.org/contact) or [post a ticket to our Phabricator](https://phab.enlightenment.org).
152
153## Installing on Other Operating Systems ##
154
155If you would like to install EFL on a different operating system visit the [Setting up a C Development Environment page](start.md). \ No newline at end of file