Setup: agent_qt - nomovok-opensource/cutedriver-agent_qt GitHub Wiki

Setting up and running agent_qt

General Requirements:

  • Qt 5.4 development environment with development headers
  • Additional packages may be needed depending on platform (especially on Linux).

Linux (X11)

  1. Clone repository: https://github.com/nomovok-opensource/cutedriver-agent_qt
  2. In folder run:
    qmake CONFIG+=no_mobility
    make
    sudo make install

Running and testing: Run executable qttas_ui for graphical frontend. Start server via UI and check that plugins and traversers load correctly. If you want logs, you need to create the folder /logs/testability/. Logs will be created there when running.

Possible configuration options to use with qmake (not comprehensive):

  • CONFIG+=no_webkit (if you have Qt without WebKit, or do not want to build WebKit support)
  • CONFIG+=RELEASE (for agent_qt built as a release)
  • CONFIG+=DEVEL (for agent_qt built as a devel)
  • CONFIG+=RPM (when using build-system for creating .rpm)
  • If you have mobility setup, you can try compiling without the no_mobility flag, but this has not been tested.

Packages that may be required (not comprehensive):

  • Qt dev headers
  • X11: x11,xext,xi,xtst

NOTE: DEB and RPM packagings may be outdated, but should be easy to fix. RPM packaging for X11 is in qttas-server.spec.

Linux (Wayland)

  1. Clone repository: https://github.com/nomovok-opensource/cutedriver-agent_qt
  2. In folder run:
    qmake CONFIG+=no_mobility CONFIG+=wayland
    make
    sudo make install

Running and testing: Run executable qttas_ui for graphical frontend. Start server via UI and check that plugins and traversers load correctly. If you want logs, you need to create the folder /logs/testability/. Logs will be created there when running.

Possible configuration options to use with qmake (not comprehensive):

  • CONFIG+=no_webkit (if you have Qt without WebKit, or do not want to build WebKit support)
  • CONFIG+=RELEASE (for agent_qt built as a release)
  • CONFIG+=DEVEL (for agent_qt built as a devel)
  • CONFIG+=RPM (when using build-system for creating .rpm)
  • If you have mobility setup, you can try compiling without the no_mobility flag, but this has not been tested.

Packages that may be required (not comprehensive):

  • Qt dev headers

NOTE: Existing DEB packaging is for X11 not Wayland, so will need adapting. RPM for Wayland is in qttas-server_skytree.spec.

Windows

  1. Clone repository: https://github.com/nomovok-opensource/cutedriver-agent_qt
  2. In folder run:
    qmake CONFIG+=no_mobility
    make (depending on your compiler may be mingw32-make.exe, nmake...)
    make install (again, depending on your compiler may be mingw32-make.exe, nmake...)

Running and testing: Installation creates /qttas/ folder on the root of the compilation drive. The binary for qttas_ui is at /qttas/bin/qttas_ui.exe. Run the executable qttas_ui.exe for graphical frontend. Start server via UI and check that plugins and traversers load correctly. If you want logs, you need to create the folder /logs/testability/ on the drive where qttas_ui is being run. Logs will be created there when running.

Possible configuration options to use with qmake (not comprehensive):

  • CONFIG+=no_webkit (if you have Qt without WebKit, or do not want to build WebKit support)
  • CONFIG+=RELEASE (for agent_qt built as a release)
  • CONFIG+=DEVEL (for agent_qt built as a devel)

NOTE: A working Qt setup with a correctly configured command line environment (or a suitably setup Qt Creator, which makes install builds) needs to be available.

OS X/Mac

  1. Clone repository: https://github.com/nomovok-opensource/cutedriver-agent_qt
  2. In folder run:
    qmake CONFIG+=no_mobility
    make
    sudo make install

Running and testing: Run executable qttas_ui for graphical frontend. Start server via UI and check that plugins and traversers load correctly. If you want logs, you need to create the folder /logs/testability/. Logs will be created there when running.