INSTALL

Installing QCA
--------------

QCA requires Qt 5.5 or greater.

For Unix/Linux/Mac/Windows:

  cmake .
  make
  make install
  /sbin/ldconfig, if necessary

Notes
-----

  Use cmake cache entries

  CMAKE_INSTALL_PREFIX - must be defined otherwise QCA will be installed
                         in Qt prefix (by default: "")
  BUILD_TESTS - build unittests (by default: ON)
  BUILD_TOOLS - build mozcerts and qcatool (by default: ON)
  QCA_SUFFIX - suffix will be used for library, qcatool binary,
               qcatool manpage and qca pkg-config file (by default: "")
  LIB_SUFFIX - library directory suffix (by default: "")
  LIB_INSTALL_DIR - path to library directory
                    (by default: ${CMAKE_INSTALL_PREFIX}/lib${LIB_SUFFIX})
  BUILD_PLUGINS - list plugins to build (botan;ossl;gnupg for example).
                  Also possible values is none, auto or all
                  (by default: "auto")
  WITH_${PLUGIN}_PLUGIN - to build particular plugin. Can be no, yes or
                          auto (WITH_ossl_PLUGIN=auto for example)
  DEVELOPER_MODE - mode to enable features for developers. If ON
                   will be used hardcoded path to 'crypto'
                   (by default: OFF)
  OSX_FRAMEWORK - build an OS X framework (by default: ON)
  USE_RELATIVE_PATHS - make relocatable package if possible (by default: OFF)

  Finally install paths can be override with:

  QCA_PREFIX_INSTALL_DIR - qca prefix, just a origin to make other paths
  QCA_PLUGINS_INSTALL_DIR - qt plugins path
  QCA_BINARY_INSTALL_DIR - qcatool will be installed to
  QCA_LIBRARY_INSTALL_DIR - qca library will be installed to
  QCA_FEATURE_INSTALL_DIR - path to qt mkspecs dir
  QCA_INCLUDE_INSTALL_DIR - path for QtCrypto dir with includes
  QCA_PRIVATE_INCLUDE_INSTALL_DIR - for future implementation
  QCA_DOC_INSTALL_DIR - for html documentation
  QCA_MAN_INSTALL_DIR - for qcatool manpage
  PKGCONFIG_INSTALL_PREFIX - path to install pkg config file

Please report problems to:
  http://bugs.kde.org

Official git repo:
  https://invent.kde.org/kde/qca