diff options
Diffstat (limited to 'release_docs/CMake_Windows.TXT')
| -rwxr-xr-x | release_docs/CMake_Windows.TXT | 95 |
1 files changed, 95 insertions, 0 deletions
diff --git a/release_docs/CMake_Windows.TXT b/release_docs/CMake_Windows.TXT new file mode 100755 index 0000000..c6ec38e --- /dev/null +++ b/release_docs/CMake_Windows.TXT @@ -0,0 +1,95 @@ +************************************************************************ +* Build and Install HDF5 C/C++ Library with CMake on Windows * +************************************************************************ + +Notes: This short instruction is written for users who want to quickly build + HDF5 library and tools from the HDF5 source code package using the CMake + tools on Windows with the Visual Studio product. + + For detailed HDF5 build and install information, or if you have trouble + following any steps in the instructions, please refer to + INSTALL_Windows.txt for further information. + + For users who would like to build and test HDF5 package from the + command line, please refer to INSTALL_Windows_From_Command_Line.txt. + + Notes: + + 1. CMake is being introduced in this release as early-access. While we + have attempted to provide error-free files, please understand that + this development with CMake has just began. + + 2. Testing of some tools have issues. + The following are failing sometimes on windows + hl_test_ds + + +======================================================================== + Preconditions +======================================================================== + + 1. We suggest you obtain the latest CMake for windows from the Kitware + web site. The HDF5 1.8.x product requires CMake version 2.8. + + If you plan to use Zlib or Szip, download the packages and install them + in a central location. For example, create a folder extlibs and install + the packages there. You should also read Section V in INSTALL_Windows.txt. + +======================================================================== + Building HDF5 C/C++ Libraries with CMake +======================================================================== + + 1. Run CMake + + The CMake executable is name "cmake-gui.exe" and should be available in + your Start menu. Specify the source and build directories. It is + recommemded that you choose a build directory different then the source + directory (for example, if the source is at c:\MyHDFstuff\hdf5, then + use c:\MyHDFstuff\hdf5\build or c:\MyHDFstuff\build\hdf5). + + 2. Configure the cache settings + + Click the Configure button. If this is the first time you are + running cmake-gui in this directory, you will be prompted for the + generator you wish to use (for example, Visual Studio 9 2008). CMake + will read in the CMakeLists.txt files from the source directory and + display options for the HDF5 project. After the first configure you + can adjust the cache settings and/or specify locations of other programs. + Any conflicts or new values will be highlighted by the configure + process in red. Once you are happy with all the settings, click the + Generate button to produce the appropriate build files (if you are using + a Visual Studio generator, solution and project files will be created). + + + 3. Build HDF5 + + You can build HDF5 using either the Visual Studio Environment or the command line. + + 3.1 If you wish to use the Visual Studio environment, open the solution file + in your build directory. + + 3.2 To build from the command line, navigate to your build directory and + execute the following; + + cmake --build . --config {Debug | Release} + + + 4. Test HDF5. + + To test the build, navigate to your build directory and execute; + + ctest . + + 5. The files that support building HDF5 with CMake are all the files in the Resources + folder, the CMakeLists.txt files in each source folder, and two additional files, + ConfigureChecks.cmake and CTestConfig.cmake. The CTestConfig.cmake is specific to + the internal testing performed by The HDF Group. It should be altered for the users + installation and needs. + + 6. More information about using CMake can be found at the KitWare site, www.cmake.org. + + +************************************************************************ + +Need further assistance, send email to help@hdfgroup.org + |