mirror of
https://github.com/jkriege2/JKQtPlotter.git
synced 2024-11-15 18:15:52 +08:00
b0df7a1fd7
NEW/BREAKING: refactor CMake-Code, so static/dynamic switch is done via <code>BUILD_SHARED_LIBS</code>, which retires <code>JKQtPlotter_BUILD_STATIC_LIBS</code>, <code>JKQtPlotter_BUILD_SHARED_LIBS</code> and removes the capability to build static and shared libraries in one location (fixes issue #104) NEW: prepareed library for CMake's <a href="https://cmake.org/cmake/help/latest/module/FetchContent.html">FetchContent</a>-API NEW: the different sub-libraries JKQTPlotter, JKQTFastPlotter (DEPRECATED), JKQTMath, JKQTMathText can be activated/deactivated with CMake options JKQtPlotter_BUILD_LIB_JKQTPLOTTER, JKQtPlotter_BUILD_LIB_JKQTFASTPLOTTER, JKQtPlotter_BUILD_LIB_JKQTMATHTEXT, JKQtPlotter_BUILD_LIB_JKQTMATH
128 lines
6.9 KiB
Plaintext
128 lines
6.9 KiB
Plaintext
/*!
|
|
|
|
|
|
\page page_buildinstructions_QMAKE DEPRECATED: Build using QMake
|
|
|
|
\warning The <a href="https://doc.qt.io/qt-6/qmake-manual.html">QMake</a> build system is deprecated and will
|
|
not get the same love and atttention as the recommended CMake system, see \ref page_buildinstructions_CMAKE !
|
|
|
|
\tableofcontents
|
|
|
|
\section page_buildinstructions_QMAKEINCLUDE DEPRECATED: QMake Include Project
|
|
|
|
If you want to simply include the JKQTPlotter Source code into your projects, without build a shared or static library and linking against it, you can use one of these QMake-Include files:
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/lib/jkqtplotter.pri">lib/jkqtplotter.pri</a> includes the complete library (JKQTPlotter, JKQTFastPlotter, JKQTMathText)
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/lib/jkqtmathtext.pri">lib/jkqtmathtext.pri</a> includes only JKQTMathText
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/lib/jkqtfastplotter.pri">lib/jkqtfastplotter.pri</a> includes only JKQTFastPlotter
|
|
.
|
|
|
|
In your <a href="https://doc.qt.io/qt-6/qmake-manual.html">QMake</a>-projects it is then sufficient to add a line like:
|
|
\code{.qmake}
|
|
include(<PATHTOJKQTPLOTTERDIR>/lib/jkqtplotter.pri)
|
|
\endcode
|
|
|
|
\section page_buildinstructions_QMAKESTATIC DEPRECATED: QMake Static Library
|
|
|
|
There are several `.PRO`-files, that can be used to build the full library, or a limited subsets of it as static link library:
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/qmake/staticlib/jkqtplotterlib/jkqtplotterlib.pro">qmake/staticlib/jkqtplotterlib/jkqtplotterlib.pro</a> builds the complete library (JKQTPlotter, JKQTFastPlotter, JKQTMathText) as static link library
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/qmake/staticlib/jkqtmathtextlib/jkqtmathtextlib.pro">qmake/staticlib/jkqtmathtextlib/jkqtmathtextlib.pro</a> builds only JKQTMathText as static link library
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/qmake/staticlib/jkqtfastplotterlib/jkqtfastplotterlib.pro">qmake/staticlib/jkqtfastplotterlib/jkqtfastplotterlib.pro</a> builds only JKQTFastPlotter as static link library
|
|
.
|
|
They will produce a static link library that you can include into your projects, e.g. with the following QMake-snippet:
|
|
|
|
\code{.qmake}
|
|
# include JKQTPlotter library
|
|
DEPENDPATH += \
|
|
<PATHTOJKQTPLOTTERDIR>/lib \
|
|
<PATHTOJKQTPLOTTERDIR>/qmake/staticlib/jkqtplotterlib
|
|
INCLUDEPATH += <PATHTOJKQTPLOTTERDIR>/lib
|
|
CONFIG (debug, debug|release) {
|
|
DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/qmake/staticlib/jkqtplotterlib/debug
|
|
LIBS += -L<PATHTOJKQTPLOTTERDIR>/qmake/staticlib/jkqtplotterlib/debug -ljkqtplotterlib_debug
|
|
} else {
|
|
DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/qmake/staticlib/jkqtplotterlib/release
|
|
LIBS += -L<PATHTOJKQTPLOTTERDIR>/qmake/staticlib/jkqtplotterlib/release -ljkqtplotterlib
|
|
}
|
|
\endcode
|
|
|
|
This snippet assumes that you built the libraries with the provided <code>.PRO</code>-files. You can also add a second <code>.PRO</code> -file to your projects, which integrates both as subdirs. Such files are used for all examples in this project. Here is an example:
|
|
|
|
\code{.qmake}
|
|
TEMPLATE = subdirs
|
|
|
|
# the (static library version) of JKQTPlotter
|
|
jkqtplotterlib_static.file = ../../qmake/staticlib/jkqtplotterlib/jkqtplotterlib.pro
|
|
|
|
# your project file, with declared dependencies on jkqtplotterlib_static
|
|
test_styling.file=$$PWD/test_styling.pro
|
|
test_styling.depends = jkqtplotterlib_static
|
|
|
|
# add the two entries to SUBDIRS
|
|
SUBDIRS += jkqtplotterlib_static test_styling
|
|
|
|
\endcode
|
|
|
|
|
|
|
|
\section page_buildinstructions_QMAKEDYNAMIC DEPRECATED: QMake Dynamic Library
|
|
|
|
There are several `.PRO`-files, that can be used to build the full library, or a limited subsets of it as shred library:
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/qmake/sharedlib/jkqtplotterlib/jkqtplotterlib.pro">qmake/sharedlib/jkqtplotterlib/jkqtplotterlib.pro</a> builds the complete library (JKQTPlotter, JKQTFastPlotter, JKQTMathText) as shared library
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/qmake/sharedlib/jkqtmathtextlib/jkqtmathtextlib.pro">qmake/sharedlib/jkqtmathtextlib/jkqtmathtextlib.pro</a> builds only JKQTMathText as shared library
|
|
- <a href="https://github.com/jkriege2/JKQtPlotter/blob/master/qmake/sharedlib/jkqtfastplotterlib/jkqtfastplotterlib.pro">qmake/sharedlib/jkqtfastplotterlib/jkqtfastplotterlib.pro</a> builds only JKQTFastPlotter as shared library
|
|
.
|
|
They will produce a dynamic link library that you can include into your projects, e.g. with the following QMake-snippet:
|
|
|
|
\code{.qmake}
|
|
# include JKQTPlotter library
|
|
DEPENDPATH += \
|
|
<PATHTOJKQTPLOTTERDIR>/lib \
|
|
<PATHTOJKQTPLOTTERDIR>/qmake/sharedlib/jkqtplotterlib
|
|
INCLUDEPATH += <PATHTOJKQTPLOTTERDIR>/lib
|
|
DEFINES += JKQTCOMMON_LIB_IN_DLL JKQTFASTPLOTTER_LIB_IN_DLL JKQTMATHTEXT_LIB_IN_DLL JKQTPLOTTER_LIB_IN_DLL
|
|
CONFIG (debug, debug|release) {
|
|
# ensure that DLLs are copied to the output directory
|
|
install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/qmake/sharedlib/jkqtplotterlib/debug/jkqtplotterlib_debug.*
|
|
install_jkqtplotter_dll.path = $$OUT_PWD
|
|
INSTALLS += install_jkqtplotter_dll
|
|
# link agains DLLs
|
|
DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/qmake/sharedlib/jkqtplotterlib/debug
|
|
LIBS += -L<PATHTOJKQTPLOTTERDIR>/qmake/sharedlib/jkqtplotterlib/debug -ljkqtplotterlib_debug
|
|
} else {
|
|
# ensure that DLLs are copied to the output directory
|
|
install_jkqtplotter_dll.files = <PATHTOJKQTPLOTTERDIR>/qmake/sharedlib/jkqtplotterlib/release/jkqtplotterlib.*
|
|
install_jkqtplotter_dll.path = $$OUT_PWD
|
|
INSTALLS += install_jkqtplotter_dll
|
|
# link agains DLLs
|
|
DEPENDPATH += <PATHTOJKQTPLOTTERDIR>/qmake/sharedlib/jkqtplotterlib/release
|
|
LIBS += -L<PATHTOJKQTPLOTTERDIR>/qmake/sharedlib/jkqtplotterlib/release -ljkqtplotterlib
|
|
}
|
|
\endcode
|
|
|
|
This snippet assumes that you built the libraries with the provided `.PRO`-files. You can also add a second `.pro`-file to your projects, which integrates both as subdirs. Such files are used for all examples in this project. Here is an example:
|
|
\code{.qmake}
|
|
TEMPLATE = subdirs
|
|
|
|
# the (shared library version) of JKQTPlotter
|
|
jkqtplotterlib_shared.file = ../../qmake/sharedlib/jkqtplotterlib.pro
|
|
|
|
# your project file, with declared dependencies on jkqtplotterlib_shared
|
|
test_styling.file=$$PWD/test_styling.pro
|
|
test_styling.depends = jkqtplotterlib_shared
|
|
|
|
# add the two entries to SUBDIRS
|
|
SUBDIRS += jkqtplotterlib_shared test_styling
|
|
\endcode
|
|
|
|
\note You will have to run a deployment step `make install` before running your executable, so the shared libararies are actually copied to the output directory (see `INSTALLS + ...` above).
|
|
|
|
|
|
|
|
\section page_buildinstructions_QMAKEQTCREATOR DEPRECATED: QMake in QTCreator
|
|
|
|
You can load the file \c JKQtPlotterBuildAllExamples.pro in te base directory of the project directly in QtCreator and use it to build the library and the examples.
|
|
|
|
|
|
|
|
|
|
*/ |