2015-02-21 02:22:27 +01:00
|
|
|
### Calamares: Distribution-Independent Installer Framework
|
2015-02-21 02:10:09 +01:00
|
|
|
---------
|
2014-06-03 22:03:07 +02:00
|
|
|
|
2015-04-13 15:05:28 +02:00
|
|
|
| [](http://calamares.io/ci/job/calamares-master/) | [Report a Bug](http://calamares.io/bugs/) | [Contribute](https://github.com/calamares/calamares/blob/master/HACKING.md) | [Translate](https://www.transifex.com/projects/p/calamares/) | Freenode (IRC): #calamares |
|
|
|
|
|
|:-----------------------------------------:|:--------------------------:|:--------------------------:|:--------------------------:|:--------------------------:|
|
2014-10-29 11:57:19 +01:00
|
|
|
|
2014-06-04 16:47:55 +02:00
|
|
|
### Dependencies
|
2015-02-21 02:10:09 +01:00
|
|
|
| Main | Partitioning Module |
|
|
|
|
|
|:----:|:-------------------:|
|
|
|
|
|
| CMake >= 2.8.12 | extra-cmake-modules |
|
|
|
|
|
| Qt >= 5.3 | kconfig (part of KF5) |
|
|
|
|
|
| yaml-cpp >= 0.5.1 | solid (part of KF5) |
|
|
|
|
|
| Python >= 3.3 | kcoreaddons (part of KF5) |
|
|
|
|
|
| Boost.Python >= 1.55.0 | ki18n (part of KF5) |
|
2014-06-04 16:47:55 +02:00
|
|
|
|
2015-05-07 16:43:17 +02:00
|
|
|
### Deployment
|
2015-05-07 16:45:08 +02:00
|
|
|
[__Setting up branding__](https://github.com/calamares/calamares/blob/master/src/branding/README.md)
|
2015-05-07 16:43:17 +02:00
|
|
|
|
2015-05-07 16:45:08 +02:00
|
|
|
[__Working with modules__](https://github.com/calamares/calamares/blob/master/src/modules/README.md)
|
2015-05-07 16:43:17 +02:00
|
|
|
|
|
|
|
|
|
2014-06-04 16:47:55 +02:00
|
|
|
### Building
|
2015-04-01 17:05:18 +02:00
|
|
|
Clone Calamares from GitHub and `cd` into the calamares directory, then:
|
2014-06-04 16:47:55 +02:00
|
|
|
```
|
2014-06-26 16:46:06 +02:00
|
|
|
$ git submodule init
|
|
|
|
|
$ git submodule update
|
2014-06-04 16:47:55 +02:00
|
|
|
$ mkdir build
|
|
|
|
|
$ cd build
|
2015-04-01 17:05:18 +02:00
|
|
|
$ cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_PARTITIONMANAGER=1 ..
|
2014-06-04 16:47:55 +02:00
|
|
|
$ make
|
|
|
|
|
```
|
|
|
|
|
|
2015-02-21 02:10:09 +01:00
|
|
|
### Design Notes
|
2015-02-21 02:13:09 +01:00
|
|
|
Calamares is currently split as follows:
|
2015-02-21 02:12:00 +01:00
|
|
|
1. __libcalamares__ - The back-end library.
|
|
|
|
|
* Only depends on QtCore, yaml-cpp, Python and Boost.Python.
|
|
|
|
|
* Provides a job queue and generic jobs.
|
|
|
|
|
* Comes with 3 job interfaces: C++, Python and process (the latter is very limited).
|
|
|
|
|
2. __libcalamaresui__ - The front-end library.
|
|
|
|
|
* Same dependencies as libcalamares, plus QtWidgets and other Qt modules.
|
|
|
|
|
* Comes with a module loading system, for different kinds of plugins.
|
|
|
|
|
* Themeable, so branding can be done easily (plugin-based, TBD).
|
|
|
|
|
* Presents a bunch of pages in a scripted order, enqueues jobs in the back-end library.
|
|
|
|
|
3. __calamares__ - The main executable.
|
|
|
|
|
* A thin wrapper around libcalamaresui; starts up and plugs together all the parts.
|
