1 Experimental cmake-based build support for APR on Microsoft Windows
6 This build support is currently intended only for Microsoft Windows.
8 This build support is experimental. Specifically,
10 * It does not support all features of APR.
11 * Some components may not be built correctly and/or in a manner
12 compatible with the previous Windows build support.
13 * Build interfaces, such as the mechanisms which are used to enable
14 optional functionality or specify prerequisites, may change from
15 release to release as feedback is received from users and bugs and
16 limitations are resolved.
18 Important: Refer to the "Known Bugs and Limitations" section for further
21 It is beyond the scope of this document to document or explain
22 how to utilize the various cmake features, such as different
23 build backends or provisions for finding support libraries.
25 Please refer to the cmake documentation for additional information
26 that applies to building any project with cmake.
31 The following tools must be in PATH:
33 * cmake, version 2.8 or later
34 * If using a command-line compiler: compiler and linker and related tools
35 (Refer to the cmake documentation for more information.)
40 1. cd to a clean directory for building (i.e., don't build in your
43 2. Some cmake backends may want your compile tools in PATH. (Hint: "Visual
44 Studio Command Prompt")
46 3. cmake -G "some backend, like 'NMake Makefiles'"
47 -DCMAKE_INSTALL_PREFIX=d:/path/to/aprinst
51 Alternately, use cmake-gui and update settings in the GUI.
55 APR_INSTALL_PRIVATE_H Install extra .h files which are required when
56 building httpd and Subversion but which aren't
57 intended for use by applications.
59 APR_HAVE_IPV6 Enable IPv6 support
61 APR_BUILD_TESTAPR Build APR test suite
63 TEST_STATIC_LIBS Build the test suite to test the APR static
64 library instead of the APR dynamic library.
66 In order to build the test suite against both
67 static and dynamic libraries, separate builds
68 will be required, one with TEST_STATIC_LIBS
70 MIN_WINDOWS_VER Minimum Windows version supported by this build
71 (This controls the setting of _WIN32_WINNT.)
72 "Vista" or "Windows7" or a numeric value like
75 For desktop/server equivalence or other values,
77 http://msdn.microsoft.com/en-us/library/windows/
78 desktop/aa383745(v=vs.85).aspx
79 INSTALL_PDB Install .pdb files if generated.
82 CMAKE_C_FLAGS_RELEASE, _DEBUG, _RELWITHDEBINFO, _MINSIZEREL
86 For NMake Makefiles the choices are at least DEBUG, RELEASE,
87 RELWITHDEBINFO, and MINSIZEREL
88 Other backends make have other selections.
90 4. build using chosen backend (e.g., "nmake install")
92 Known Bugs and Limitations
93 --------------------------
95 * If include/apr.h or other generated files have been created in the source
96 directory by another build system, they will be used unexpectedly and
97 cause the build to fail.
98 * Options should be provided for remaining features:
100 * APR-CHANGES.txt, APR-LICENSE.txt, and APR-NOTICE.txt are not installed,
101 though perhaps that is a job for a higher-level script.
105 * Many APR features have not been tested with this build.
106 * Developers need to examine the existing Windows build in great detail and see
107 what is missing from the cmake-based build, whether a feature or some build
109 * Any feedback you can provide on your experiences with this build will be