| Stepan Salenikovich | e3500cb | 2015-02-13 15:55:46 -0500 | [diff] [blame] | 1 | ring-client-gnome |
| 2 | ***************** |
| 3 | |
| 4 | Ring-client-gnome is a Ring client written in GTK+3. It uses libRingClient to |
| 5 | communicate with the Ring daemon and for all of the underlying models and their |
| 6 | logic. Ideally ring-client-gnome should only contain UI related code and any |
| 7 | wrappers necessary for interacting with libRingClient. |
| 8 | |
| Stepan Salenikovich | 137376c | 2015-04-15 14:25:43 -0400 | [diff] [blame] | 9 | Packages for Debian/Ubuntu/Fedora can be found on http://ring.cx |
| 10 | |
| 11 | More info about the Ring project or this client can be found on their respective wiki pages: |
| 12 | - https://projects.savoirfairelinux.com/projects/ring/wiki |
| 13 | - https://projects.savoirfairelinux.com/projects/ring-gnome-client/wiki |
| 14 | |
| Stepan Salenikovich | 4e740b6 | 2015-03-13 14:06:49 -0400 | [diff] [blame] | 15 | |
| Stepan Salenikovich | e3500cb | 2015-02-13 15:55:46 -0500 | [diff] [blame] | 16 | Requirements |
| 17 | ================== |
| 18 | |
| 19 | - Ring daemon |
| Stepan Salenikovich | 137376c | 2015-04-15 14:25:43 -0400 | [diff] [blame] | 20 | - libRingClient |
| Stepan Salenikovich | e3500cb | 2015-02-13 15:55:46 -0500 | [diff] [blame] | 21 | - GTK+3 (3.10 or higher) |
| 22 | - Qt5 Core |
| Stepan Salenikovich | 137376c | 2015-04-15 14:25:43 -0400 | [diff] [blame] | 23 | - X11 |
| 24 | - gnome-icon-theme-symbolic (certain icons are used which other themes might be missing) |
| 25 | - libebook1.2 / evolution-data-server (3.10 or higher) |
| 26 | |
| 27 | On Debian/Ubuntu these can be installed by: |
| 28 | sudo apt-get install g++ cmake libgtk-3-dev qtbase5-dev libclutter-gtk-1.0-dev gnome-icon-theme-symbolic libebook-1.2-dev |
| 29 | |
| 30 | On Fedora: |
| 31 | yum install gcc-c++ cmake gtk3-devel qt5-qtbase-devel clutter-gtk-devel gnome-icon-theme-symbolic evolution-data-server-devel |
| 32 | |
| 33 | The build instruction for the daemon and libRingClient can be found on their respective wiki pages: |
| 34 | - https://projects.savoirfairelinux.com/projects/ring-daemon/wiki |
| 35 | - https://projects.savoirfairelinux.com/projects/libringclient/wiki/Wiki |
| Stepan Salenikovich | e3500cb | 2015-02-13 15:55:46 -0500 | [diff] [blame] | 36 | |
| Stepan Salenikovich | 4e740b6 | 2015-03-13 14:06:49 -0400 | [diff] [blame] | 37 | |
| Stepan Salenikovich | e3500cb | 2015-02-13 15:55:46 -0500 | [diff] [blame] | 38 | Compiling |
| 39 | ================== |
| 40 | |
| 41 | In the project root dir: |
| Stepan Salenikovich | 137376c | 2015-04-15 14:25:43 -0400 | [diff] [blame] | 42 | mkdir build |
| 43 | cd build |
| 44 | cmake .. |
| 45 | make |
| Stepan Salenikovich | e3500cb | 2015-02-13 15:55:46 -0500 | [diff] [blame] | 46 | |
| 47 | Then simply run ./ring-client-gnome |
| Stepan Salenikovich | 4e740b6 | 2015-03-13 14:06:49 -0400 | [diff] [blame] | 48 | |
| 49 | |
| 50 | Building without installing Ring daemon and libRingClient |
| 51 | ================== |
| 52 | |
| 53 | It is possible to build ring-client-gnome without installing the deamon and |
| 54 | libRingClient on your system (eg: in /usr or /usr/local): |
| 55 | |
| 56 | 1. build the daemon |
| 57 | 2. when building libRingClient, specify the location of the daemon lib in the |
| 58 | cmake options with -DRING_BUILD_DIR=, eg: |
| 59 | -DRING_BUILD_DIR=/home/user/ring/daemon/src |
| 60 | 3. to get the proper headers, we still need to 'make install' libRingClient, but |
| 61 | we don't have to install it in /usr, so just specify another location for the |
| 62 | install prefix in the cmake options, eg: |
| 63 | -DCMAKE_INSTALL_PREFIX=/home/user/ringinstall |
| 64 | 4. now compile libRingClient and do 'make install', everything will be installed |
| 65 | in the dir specified by the prefix |
| 66 | 4. now we just have to give the same install prefix to the cmake options of the |
| 67 | client and it will find libRingClient: |
| 68 | -DCMAKE_INSTALL_PREFIX=/home/user/ringinstall |
| 69 | |
| 70 | |
| 71 | Debugging |
| 72 | ================== |
| 73 | |
| 74 | For now, the build type of the client is "Debug" by default, however it is |
| 75 | useful to also have the debug symbols of libRingClient. To do this, specify this |
| 76 | when compiling libRingClient with '-DCMAKE_BUILD_TYPE=Debug' in the cmake |
| Stepan Salenikovich | 137376c | 2015-04-15 14:25:43 -0400 | [diff] [blame] | 77 | options. |