1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175
|
Requirements
============
EDFbrowser is a GNU/Linux & GCC & GNU Make project. Other platforms, tools or compilers are not supported.
This is not going to change. I mean it.
EDFbrowser requires a little-endian system. EDFbrowser does not work with a CPU with a big-endian architecture.
This is also not going to change.
Introduction
============
EDFbrowser is a Qt application and uses qmake as part of the build process.
Qmake is part of your Qt installation.
One of the following Qt versions is needed in order to be able to compile EDFbrowser:
- Qt4 version 4.8.7
- Qt5 version 5.12.6 or later
- Qt6 version 6.4.2 or later
The recommended Qt version is the latest Qt5.
Compiling and installing on Debian Linux and derivatives (Ubuntu, Mint, Raspberry Pi OS, etc.)
===============================================================================================
sudo apt update
sudo apt install build-essential g++ make git qtbase5-dev-tools qtbase5-dev
git clone https://gitlab.com/Teuniz/EDFbrowser.git
cd EDFbrowser
qmake
make -j24 (change option -j according to number of available cpu cores/threads e.g -j4 or -j8)
sudo make install
edfbrowser
Compiling and installing on Fedora
====================================
sudo dnf update
sudo dnf group install "development-tools"
sudo dnf install g++ qt5-qtbase qt5-qtbase-devel
git clone https://gitlab.com/Teuniz/EDFbrowser.git
cd EDFbrowser
qmake-qt5
make -j8
sudo make install
edfbrowser
Compiling and installing on openSUSE
======================================
sudo zypper refresh
sudo zypper install -t pattern devel_basis devel_C_C++ devel_qt5
git clone https://gitlab.com/Teuniz/EDFbrowser.git
cd EDFbrowser
qmake-qt5
make -j8
sudo make install
edfbrowser
Advanced users (keep in mind, EDFbrowser is NOT a community project, pull/merge requests will be ignored)
=========================================================================================================
In case you want to compile EDFbrowser "static" with Qt5, here is a howto:
First, fulfill the requirements for Qt:
https://doc.qt.io/qt-5/linux.html
Debian/Ubuntu: sudo apt-get install build-essential libgl1-mesa-dev libcups2-dev libx11-dev
Fedora: sudo dnf groupinstall "C Development Tools and Libraries"
sudo dnf install mesa-libGL-devel cups-devel libx11-dev
openSUSE: sudo zypper install -t pattern devel_basis
sudo zypper install xorg-x11-devel cups-devel freetype-devel fontconfig-devel libxkbcommon-devel libxkbcommon-x11-devel
#############################################################################################
# #
# Compile a static version of the Qt5 libraries excluding all modules that are not needed. #
# #
# This will not mess with your system libraries. The new compiled libraries will be stored #
# #
# in a new and separate directory: /usr/local/Qt-5.12.10-static #
# #
# It will not interfere with other Qt programs. #
# #
#############################################################################################
mkdir Qt5-source
cd Qt5-source
wget https://ftp1.nluug.nl/languages/qt/official_releases/qt/5.12/5.12.10/single/qt-everywhere-src-5.12.10.tar.xz
here is a list of download mirrors: https://download.qt.io/static/mirrorlist/
The Qt source package you are going to need is: qt-everywhere-src-5.12.10.tar.xz
tar -xvf qt-everywhere-src-5.12.10.tar.xz
cd qt-everywhere-src-5.12.10
./configure -v -prefix /usr/local/Qt-5.12.10-static -release -opensource -confirm-license -c++std c++11 -static -accessibility -fontconfig -no-libudev -no-vulkan -skip qtdeclarative -skip qtconnectivity -skip qtmultimedia -qt-zlib -no-mtdev -no-journald -qt-libpng -qt-libjpeg -system-freetype -qt-harfbuzz -no-openssl -no-libproxy -no-glib -nomake examples -nomake tests -no-compile-examples -cups -no-evdev -no-dbus -no-egl -no-eglfs -qreal double -no-opengl -skip qtlocation -skip qtsensors -skip qtwayland -skip qtgamepad -skip qtserialbus -skip qt3d -skip qtpurchasing -skip qtquickcontrols -skip qtquickcontrols2 -skip qtspeech -skip qtwebengine
make -j24 (change option -j according to number of available cpu cores e.g -j4 or -j8)
(takes about 2.5 minutes on an AMD Ryzen 9 3900X)
sudo make install
Now go to the directory that contains the EDFbrowser sourcecode and enter the following commands:
/usr/local/Qt-5.12.10-static/bin/qmake
make -j24 (change option -j according to number of available cpu cores e.g -j4 or -j8)
sudo make install
Now you can run the program by typing: edfbrowser
Congratulations!
You have compiled a static version of EDFbrowser that can be deployed on other systems without the need
to install the Qt libraries.
In order to reduce the size of the executable, run the following commands:
strip -s edfbrowser
upx edfbrowser (if upx is not recognized as a command, install it using your package manager)
Requirements on macOS (warning, I don't have a Mac and thus I cannot support it!)
=================================================================================
Development tools from Apple: to get them, run
xcode-select --install
Qt >= 5.9.1: one method to get Qt on macOS is to install it via homebrew:
brew install qt
Note: after installing, qmake will likely not be in your $PATH, so you need to invoke it using its full path.
Build on macOS
==============
In the directory where you extracted sourcefile or cloned git repo, first run qmake, then make
(change option -j according to number of available cpu cores, get with 'sysctl -n hw.ncpu' command):
$(brew --prefix qt)/bin/qmake
make -j4
You can also build it in a dedicated subdirectory:
mkdir build
cd build
$(brew --prefix qt)/bin/qmake ..
make -j4
This will create the app bundle in the current directory, which you can then move to /Applications/ if desired.
|