aboutsummaryrefslogtreecommitdiff
path: root/README.cmake
diff options
context:
space:
mode:
Diffstat (limited to 'README.cmake')
-rw-r--r--README.cmake76
1 files changed, 0 insertions, 76 deletions
diff --git a/README.cmake b/README.cmake
deleted file mode 100644
index 96d492c..0000000
--- a/README.cmake
+++ /dev/null
@@ -1,76 +0,0 @@
1For building with cmake at least version 3.10 (minizip 3.12) is needed
2
3In most cases the usual "mkdir build && cd build && cmake .." will create everything you need, however
4if you want something off default you can adjust several options fit your needs. Every option is
5list below (excluding the cmake-standard options), they can be set via cmake-gui or on cmdline with
6
7 -D<option>=ON/OFF
8
9## ZLIB-options with defaults ##
10
11ZLIB_BUILD_TESTING=ON -- Enable Zlib Examples as tests
12
13ZLIB_BUILD_SHARED=ON -- Enable building zlib shared library
14
15ZLIB_BUILD_STATIC=ON -- Enable building zlib static library
16
17ZLIB_BUILD_MINIZIP=ON -- Enable building libminizip contrib library
18If this option is turned on, additional options are available from minizip (see below)
19
20ZLIB_INSTALL=ON -- Enable installation of zlib
21
22ZLIB_PREFIX=OFF -- prefix for all types and library functions, see zconf.h.in
23
24ZLIB_INSTALL_COMPAT_DLL=ON -- Install a copy as zlib1.dll
25This option is only on windows available and may/will be turned off and removed somewhen in the future.
26If you rely cmake for finding and using zlib, this can be turned off, as zlib1.dll will never be used.
27
28## minizip-options with defaults ##
29
30MINIZIP_BUILD_SHARED=ON Enable building minizip shared library
31
32MINIZIP_BUILD_STATIC=ON Enable building minizip static library
33
34MINIZIP_BUILD_TESTING=ON Enable testing of minizip
35
36MINIZIP_ENABLE_BZIP2=ON Build minizip withj bzip2 support
37A usable installation of bzip2 is needed or config will fail. Turn this option of in this case.
38
39MINIZIP_INSTALL=ON Enable installation of minizip
40
41MINIZIP_INSTALL_COMPAT_DLL=ON Install a copy as libminizip-1.dll
42This option is only available on mingw as they tend to name this lib different. Maybe this will also be
43removed in the future as. If you rely cmake for finding and using zlib, this can be turned off, as
44the other file will never be used.
45
46## Using the libs ##
47
48To pull in what you need it's enough to just write
49
50 find_package(ZLIB CONFIG)
51or
52 find_package(minizip CONFIG)
53
54in your CMakeLists.txt, however it is advised to specify what you really want via:
55
56 find_package(ZLIB CONFIG COMPONENTS shared static REQUIRED)
57or
58 find_package(minizip CONFIG COMPONENTS shared static REQUIRED)
59
60As it's possible to only build the shared or the static lib, you can make sure that everything you need
61is found. If no COMPONENTS are requested, everything that is found will satisfy your request. If the
62libraries are optional in you project, you can omit the REQUIRED and check yourself if the targets you
63want to link against are created.
64
65When you search for minizip, it will search zlib for you, so only one of both is needed.
66
67## Imported targets ##
68When found the following targets are created for you:
69
70ZLIB::ZLIB and ZLIB:ZLIBSTATIC for zlib
71MINIZIP::minizip and MINIZIP::minizipstatic for minizip
72
73In addition a var called MINIZIP_ENABLE_BZIP2 is exported so you can check if you got a bzip2 enabled
74version of the lib. As linking against libbz2 is only needed if you use functions from that set, it's
75no hard dep and you have to make sure a working bzip2-installation is found and linked in your binary.
76