6.8 KiB
Dependencies
- C++17 compiler
- Latest QT6
- Various libraries for Linux & macOS, see below
- On Windows all the libraries are included in the repository
For debian/ubuntu, those packages are needed
libavformat-dev libavutil-dev libbz2-dev libeb16-dev libhunspell-dev \
liblzma-dev liblzo2-dev libopencc-dev libvorbis-dev \
libx11-dev libxtst-dev libzim-dev libzstd-dev qt6-5compat-dev \
qt6-base-dev qt6-multimedia-dev qt6-speech-dev qt6-svg-dev \
qt6-tools-dev qt6-tools-dev-tools qt6-webchannel-dev \
qt6-webengine-dev x11proto-record-dev zlib1g-dev
In other words, those libraries
- Qt6 (with webengine)
- ffmpeg
- libzim
- xapian
- hunspell
- opencc
- libeb
- libvorbis
- x11 (linux only)
And a few compression libraries:
- xz (lzma)
- bzip2
- lzo2
- zlib
CMake Build
Basically, you need those commands:
cd goldendict-ng && mkdir build_dir
# config step
cmake -S . -B build_dir \
--install-prefix=/usr/local/ \
-DCMAKE_BUILD_TYPE=Release
# actual build
cmake --build build_dir --parallel 7
cmake --install ./build_dir/
Feature flags
Append -D{flag_names}=ON/OFF to cmake's config step
Available flags can be found on the top of CMakeLists.txt
Windows
Install Qt6(msvc) through the standard installer and pass Qt's path to CMake
-DCMAKE_PREFIX_PATH=F:\Qt\6.4.1\msvc2019_64
The built artifacts will end up in build_dir/goldendict
Using pre-built winlibs
Use windeploy target to copy necessary runtime files.
cmake --build . --target windeploy
Or you can also manually run windeployqt.exe {your_build_dir}/goldendict.exe which will copy the qt related things to build_dir.
Using Vcpkg
The dependencies can be built via Vcpkg instead of using the pre-built ones.
Vcpkg CMake build utilize the "manifest mode", all you need to do is basically
set CMAKE_TOOLCHAIN_FILE as described here.
Add this to cmake command:
-DUSE_VCPKG=ON
Most .dll built by vcpkg will be automatically copied, but the Qt ones won't.
You can
- run
cmake --install .(recommended) - manually run windeployqt
- add
${Qt's install path}\Qt\6.5.2\msvc2019_64\binto your PATH environment variable
macOS
If you build in an IDE, then the created GoldenDict.app will be runnable from the IDE which set up necessary magics for you.
To make the .app runnable elsewhere, you can run cmake --install build_dir/ which will invoke macdeployqt, ad-hoc code signing and various other things. The produced app will end up in build_dir/redist/goldendict-ng.app
To create .dmg installer, you have to have create-dmg installed on your machine, then also cmake --install build_dir/.
Qmake
Build Steps
Notice: All additional configs for qmake that must be combined in one of pass config options to qmake:
qmake6 "CONFIG+=release"
make
For ARM macOS, QMAKE_APPLE_DEVICE_ARCHS="arm64" should be passed to qmake.
Building with Chinese conversion support
To add Chinese conversion support you need at first install libopencc-dev package, then pass "CONFIG+=chinese_conversion_support" to qmake.
sudo apt-get install libopencc-dev
Building with Zim dictionaries support
To add Zim formats support you need libzim, then pass "CONFIG+=zim_support" to qmake
Note: Some linux distros do not support latest zim version, so you need to compile from latest source. On Windows, you can use vcpkg to compile the libzim
vcpkg install libzim:x64-windows
and copy the corresponding(debug/release) library to the winlibs/lib folder. the zim's include directory to the winlibs/include directory.
Building without Epwing format support
If you have problem building with libeb-dev package, you can pass
"CONFIG+=no_epwing_support" to qmake in order to disable Epwing format support
Building without internal audio players
If you have problem building with FFmpeg (for example, very old linux distro), you can pass
"CONFIG+=no_ffmpeg_player" to qmake in order to disable FFmpeg internal audio player back end.
If you have problem building with Qt5 Multimedia or experience GStreamer run-time errors (for example, Ubuntu 14.04), you can pass
"CONFIG+=no_qtmultimedia_player" to qmake in order to disable Qt Multimedia internal audio player back end.
Building with xapian
build xapian from source, download and extract the xapian-core source code.
./configure
make
make install
On Windows, vcpkg install xapian:x64-windows and copy the libs/dlls into the winlibs
A precompiled version of xapian lib has provided in winlibs.
On Linux, install libxapian-dev package using package manager.
On Mac, use homebrew to install xapian brew install xapian
Goldendict-ng has used xapian as the default and the only one fulltext engine.
use iconv (recommend to enable)
use CONFIG+=use_iconv to enable this feature. when enabled ,iconv will be used to convert encoding other than the QTextCodec(which will be deprecated in future Qt version)
qmake "CONFIG+=use_iconv"
when enabled ,iconv should be installed on the platform at the same time.
use breakpad
use CONFIG+=use_breakpad to enable this crash dump. when enabled breakpad, goldendict will generate a crash dump alongside with Goldendict in the crash directory.
on Windows:
vcpkg install breakpad:x64-windows-release and copy the installed packages into thirdparty/breakpad directory.
with a structure like this:
├─breakpad
│ ├─include
│ │ ├─client
│ │ │ └─windows
│ │ │ ├─common
│ │ │ ├─crash_generation
│ │ │ ├─handler
│ │ │ └─sender
│ │ ├─common
│ │ │ └─windows
│ │ └─google_breakpad
│ │ ├─common
│ │ └─processor
│ └─lib
on Mac/Linux: vcpkg can also be used or you can just install breakpad from source or use precompiled packages.
Then enable google breakpad like this with qmake:
qmake "CONFIG+=use_breakpad"
build with tts disabled
CONFIG+=no_tts_support will disable the QTextToSpeech feature.
Build with VS2019
VS2019 support CMake project, open the source directory directly then you go.
build
After successful build, run windeployqt.exe(bundled with Qt installation) in the target folder (where GoldenDict.exe is located), which will copy all necessary files to this folder. You can click on the exe to verify that the application can be run.
After all this, you can debug the application normally.