diff options
author | Christian Mollekopf <chrigi_1@fastmail.fm> | 2018-02-19 17:38:16 +0100 |
---|---|---|
committer | Christian Mollekopf <chrigi_1@fastmail.fm> | 2018-02-19 17:38:45 +0100 |
commit | 6ec9327081c87c8f6c48cb1fcf66dc3cd4e3dc18 (patch) | |
tree | 277e53ac59bd3f1a165373a6860003bfecae38a8 | |
parent | 636d25b7635e9e9fa55384ca1df4c4bf9730ec13 (diff) | |
parent | 761a431d3d9774f12848d2c63e875523f3ededdf (diff) | |
download | kube-6ec9327081c87c8f6c48cb1fcf66dc3cd4e3dc18.tar.gz kube-6ec9327081c87c8f6c48cb1fcf66dc3cd4e3dc18.zip |
Add development setup instructions
Summary:
Add some development setup instructions for manual install and using docker.
The docker instructions might need reviewing as I haven't been able to make it work myself.
Reviewers: cmollekopf
Reviewed By: cmollekopf
Tags: #kube
Differential Revision: https://phabricator.kde.org/D10655
-rw-r--r-- | docs/setting-up-dev-env.md | 43 | ||||
-rw-r--r-- | mkdocs.yml | 1 |
2 files changed, 44 insertions, 0 deletions
diff --git a/docs/setting-up-dev-env.md b/docs/setting-up-dev-env.md new file mode 100644 index 00000000..82d823bf --- /dev/null +++ b/docs/setting-up-dev-env.md | |||
@@ -0,0 +1,43 @@ | |||
1 | # Setting up the development environment | ||
2 | |||
3 | Multiple choices are available for developing the Kube project: | ||
4 | |||
5 | - Manually | ||
6 | - Docker | ||
7 | |||
8 | ## Manually | ||
9 | |||
10 | - If sink is not in you repositories: | ||
11 | - Install the dependencies of Sink: | ||
12 | - extra-cmake-modules | ||
13 | - qt5-qtbase-devel / qtbase5-dev | ||
14 | - libgit2-dev(el) | ||
15 | - lmdb-devel / liblmdb-dev | ||
16 | - readline-devel / libreadline-dev | ||
17 | - libcurl-dev(el) | ||
18 | - kf5-kimap | ||
19 | - kf5-kimap-devel | ||
20 | - [KAsync](https://github.com/KDE/kasync/releases) | ||
21 | - Install Sink | ||
22 | - Install the Kube project: | ||
23 | - `mkdir build && cd build && cmake .. && make && sudo make install` | ||
24 | |||
25 | If you did not install sink in the `/usr` directory, you might need to set the | ||
26 | `QT_PLUGIN_PATH` variable to something like this: | ||
27 | `$SINK_INSTALL_PREFIX/lib/plugins`. | ||
28 | |||
29 | In the same way, if did not install Kube in the `/usr` directory, you might | ||
30 | need to set the `QML2_IMPORT_PATH` to something like this: | ||
31 | `$KUBE_INSTALL_PREFIX/lib/qml/`. | ||
32 | |||
33 | ## Docker | ||
34 | |||
35 | - Go to the `docker` directory | ||
36 | - In the `run.sh` script, set the SOURCEDIR, BUILDDIR and INSTALLDIR variables | ||
37 | to an existing path containing respectively the source, build and | ||
38 | installation directory of kube. The build and installation directory can be | ||
39 | empty at first. | ||
40 | - Run the `./build.sh` script | ||
41 | - Run the `./run.sh` script | ||
42 | - In the now opened container shell, run `cmake -DCMAKE_INSTALL_PREFIX=/install /src` | ||
43 | - Run `make install` | ||
@@ -5,4 +5,5 @@ pages: | |||
5 | - Design: design.md | 5 | - Design: design.md |
6 | - Requirements: requirements.md | 6 | - Requirements: requirements.md |
7 | - Cryptography: cryptography.md | 7 | - Cryptography: cryptography.md |
8 | - Dev environment setup: setting-up-dev-env.md | ||
8 | theme: readthedocs | 9 | theme: readthedocs |