napcok/calamares
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Distribution-independent installer framework
2,122 Commits 8 Branches 95 Tags 88 MiB
C++ 73.3%
Python 8.5%
QML 8.1%
CMake 4.7%
Roff 3.3%
Other 2.1%
c7aa427451
Go to file
demmm c7aa427451 port the webview page away from QtWebkit 
it is no longer maintained upstream
this change is tested with QtWebEngine 5.6.0, it builds and runs
displays the webview page correctly, clicking next however does not refresh that new page completely
2016-03-23 18:17:09 -04:00
.tx Add Transifex repo config. 2014-10-09 16:27:20 +02:00
ci Fix permissions. 2015-09-29 11:33:52 +02:00
CMakeModules Make Boost.Python3 cmake script work properly on Debian again 2015-06-10 21:07:46 +02:00
data/images New icon, PNG. 2016-01-21 17:12:38 +01:00
hacking Update RELEASE.md 2015-06-20 20:46:45 +02:00
lang Automatic merge of Transifex translations 2016-03-21 00:31:00 +00:00
src port the webview page away from QtWebkit 2016-03-23 18:17:09 -04:00
thirdparty Update submodule. 2016-03-23 18:48:08 +01:00
.editorconfig Added .editorconfig 2015-06-13 21:56:21 -04:00
.gitattributes Add testmodule.py and globalStorage.yaml to export-ignore for tarballs. 2015-07-20 17:26:53 +02:00
.gitignore Update .gitignore. 2015-06-10 02:09:18 +02:00
.gitmodules Add libcrashreporter-qt submodule. 2016-03-23 18:48:08 +01:00
AUTHORS AUTHORS file. 2014-06-11 13:39:44 +02:00
calamares.desktop Use pkexec to execute calamares with the right permissions 2014-11-04 17:59:31 +01:00
CalamaresAddBrandingSubdirectory.cmake Rely on CMake if the branding component has a CMakeLists.txt. 2015-05-13 12:32:14 +02:00
CalamaresAddLibrary.cmake Add proper QResrouce system to libcalamaresui, finish up prepare checks 2014-08-26 18:24:51 +02:00
CalamaresAddModuleSubdirectory.cmake Allow and glob multiple .conf files in module subdirectory. 2015-09-15 16:48:42 +02:00
CalamaresAddPlugin.cmake Allow and glob multiple .conf files in module subdirectory. 2015-09-15 16:48:42 +02:00
CalamaresBuildTreeSettings.cmake.in CMake skeleton. 2014-06-04 16:35:26 +02:00
CalamaresConfig.cmake.in We have a Python API for jobmodules! 2014-07-17 19:42:16 +02:00
CalamaresConfigVersion.cmake.in CMake skeleton. 2014-06-04 16:35:26 +02:00
CalamaresUse.cmake.in New CalamaresAddBrandingSubdirectory macro. 2014-10-10 18:07:41 +02:00
cmake_uninstall.cmake.in CMake skeleton. 2014-06-04 16:35:26 +02:00
CMakeLists.txt Set THIRDPARTY_DIR 2016-03-23 18:48:08 +01:00
com.github.calamares.calamares.policy Rename pkexec policy file to .policy extension. 2014-11-05 23:34:03 +01:00
HACKING.md Update HACKING.md 2015-06-13 21:55:31 -04:00
LICENSE Update LICENSE 2014-06-03 22:32:42 +02:00
README.md Update README.md 2016-03-11 17:00:40 +01:00
settings.conf Update settings defaults. 2016-02-24 15:40:40 +01:00

README.md

Calamares: Distribution-Independent Installer Framework

GitHub release Build Status Coverity Scan Build Status GitHub license

Report a Bug Contribute Translate Freenode (IRC): #calamares

Dependencies

Main:

  • Compiler with C++11 support: GCC >= 4.9.0 or Clang >= 3.5.1
  • CMake >= 2.8.12
  • Qt >= 5.3
  • yaml-cpp >= 0.5.1
  • Python >= 3.3
  • Boost.Python >= 1.55.0
  • dmidecode

Modules:

  • welcome:
  • NetworkManager
  • UPower
  • partition:
  • extra-cmake-modules
  • KF5: KCoreAddons, KConfig, KI18n, KIconThemes, KIO, KService
  • KPMcore >= 2.1
  • sgdisk
  • bootloader:
  • systemd-boot or GRUB
  • sgdisk
  • unpackfs:
  • squashfs-tools
  • rsync

Deployment

Setting up branding

Working with modules

Building

Clone Calamares from GitHub and cd into the calamares directory, then:

$ git submodule init
$ git submodule update
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Debug ..
$ make

Supported variables for CMake

  • WITH_PYTHON - if this is set to false, the Python module interface will not be built. Default is true.
  • SKIP_MODULES - takes a space-separated list of module names that should not be built even if present in src/modules (e.g. cmake -DSKIP_MODULES="partition mount umount welcome" ..). Default is empty.

Design Notes

Calamares is currently split as follows:

  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).
  1. 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.
  • Supports branding components.
  • Presents a bunch of pages in a scripted order, enqueues jobs in the back-end library.
  1. calamares - The main executable.
  • A thin wrapper around libcalamaresui; starts up and plugs together all the parts.