HDF5® Source Code
The source code distributions for Unix and Windows are identical except for the line endings.
Applications that were created with earlier HDF5 releases may not compile with 1.12 by default.
The API Compatibility Macros in HDF5 allow users to work around this issue. Users can specify a compatibility macro mapping for the version of HDF5 that an application was built with. For example, a 1.10 application can be built with 1.12 using either an application or library mapping as follows:
- To compile an application built with a version of HDF5 that includes deprecated symbols (the default), specify:
-DH5_USE_110_API (autotools) or
- To build an HDF5 library with the 1.10 APIs specify
--with-default-api-version=v110 (Autotools) or
However, users will not be able to take advantage of some of the new features in 1.12 if using these compatibility mappings.
See the Migrating from HDF5 1.10 to HDF5 1.12 page for details on upgrading an application.
Instructions for building HDF5 can be found in the
release_docs/ directory in the source code.
CMake is required for building HDF5 on Windows. Please see the CMake Versions provided below for a simplified method of building HDF5 with CMake.
Please see the instructions below for additional information.
Building HDF5 with CMake
CMake is required to build HDF5 on Windows. It can optionally be used for Unix platforms. To simplify building HDF5 with CMake, a CTest script and platform configuration file are packaged with the HDF5 library. Download the file for Unix or Windows above as needed, and follow the Building With CMake installation instructions.