mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +08:00
[svn-r10893] Purpose:
Add short version instruction for Visual C++ .net 2003 Description: Short version instruction for building and testing HDF5 with Visual C++ .Net was added. Solution: Platforms tested: Misc. update:
This commit is contained in:
Fang Guo
parent
072c08b7af
commit
ae41553de2
212
release_docs/INSTALL_Windows_Short_NET.TXT
Executable file
212
release_docs/INSTALL_Windows_Short_NET.TXT
Executable file
@ -0,0 +1,212 @@
|
||||
HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003
|
||||
(Short Version)
|
||||
------------------------------------------------------------------------
|
||||
Note: This short instruction is written for users who want to quickly
|
||||
build HDF5 library and tools from the HDF5 source code package
|
||||
with Microsoft Visual Studio .NET 2003 but do not want to know HDF5
|
||||
building and installation details on Windows XP.
|
||||
|
||||
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
|
||||
INSATLL_Windows_From_Command_Line.txt.
|
||||
|
||||
***************************WARNINGS*************************************
|
||||
Please read CAREFULLY about HDF5 build and install preconditions and
|
||||
notes in INSTALL_Windows.txt before starting below procedures.
|
||||
************************************************************************
|
||||
|
||||
Preconditions:
|
||||
|
||||
a. Setup Szip Library for Visual Studio .Net 2003 Compiler.
|
||||
|
||||
Szip source codes or binaries can be downloaded
|
||||
from the following address:
|
||||
|
||||
ftp://ftp.ncsa.uiuc.edu/HDF/szip/bin/windows.
|
||||
|
||||
b. Set up path for external libraries and headers
|
||||
|
||||
Skip this part if you don't want to use ANY compression features
|
||||
provided by HDF5. Please do read section V.
|
||||
|
||||
You have to read this part even if you want to only use Zlib
|
||||
or Szip. You also need to read section V.
|
||||
|
||||
Invoke Microsoft Visual C++ .Net and go to "Tools" and select
|
||||
"Options". In the left pane of "Option" window poped up,
|
||||
choose and extend "Projects", Click on "VC++ Directories".
|
||||
In the right pane, Find the box "Show directories for", choose
|
||||
"Include files", if you can not find your Zlib and Szip
|
||||
header path
|
||||
(for example, c:\zlib122\include, c:\szip\include)
|
||||
from the directory list, add the header path
|
||||
(c:\zlib122\include, c:\szip\include) to the
|
||||
included directories.
|
||||
|
||||
Find the box "Show directories for", choose "Library files",
|
||||
If you cannot find your Zlib and Szip library path
|
||||
(for example, c:\zlib122\lib, c:\szip\dll)
|
||||
from the directory list, add the library path
|
||||
(c:\zlib122\lib, c:\szip\dll) to the library directories.
|
||||
|
||||
1. Open all.dsw workspace
|
||||
|
||||
Invoke Microsoft Visual C++ .Net 2003. From the main
|
||||
menu, go to "File" and select "Open Solution". In
|
||||
the "Open Solution" window, Change "Files of type" to
|
||||
"All Project Files". Choose "all.dsw" under the directory
|
||||
c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window,
|
||||
chooise "Yes To All" to convert all project files to Visual
|
||||
C++ .Net project format.
|
||||
|
||||
2. Building HDF5 C and C++ Libraries
|
||||
|
||||
Users can choose the desirable libraries to be built according
|
||||
to the following describtion.
|
||||
|
||||
2.1 If you don't want to build HDF5 C++ Libraries,
|
||||
Go to "Build" and select "Configuration Manager". Choose "Release"
|
||||
or "Debug" under "Active Solution Configuration"
|
||||
|
||||
Disable the following projects:
|
||||
|
||||
dsets_cpp
|
||||
dsets_cppdll
|
||||
hdf5_cpp
|
||||
hdf5_cppdll
|
||||
testhdf5_cpp
|
||||
testhdf5_cppdll
|
||||
hdf5_hl_cpp
|
||||
hl_test_table_cpp
|
||||
|
||||
Click on "OK", From the main menu, choose "Build"-> "Build" or
|
||||
"Rebuild ALL" to build both release and debug version of HDF5
|
||||
Libraries.
|
||||
|
||||
2.2 If you don't want to build HDF5 Fortran Libraries,
|
||||
Go to "Build" and select "Configuration Manager". Choose "Release"
|
||||
or "Debug" under "Active Solution Configuration"
|
||||
|
||||
Disable the following projects:
|
||||
|
||||
flush1_fortran
|
||||
flush1_fortrandll
|
||||
flush2_fortran
|
||||
flush2_fortrandll
|
||||
hdf5_f90cstub
|
||||
hdf5_f90cstubdll
|
||||
hdf5_fortran
|
||||
hdf5_fortrandll
|
||||
libtest_cstubdll
|
||||
libtest_fortran
|
||||
libtest_fortrandll
|
||||
testhdf5_fortran
|
||||
testhdf5_fortrandll
|
||||
hdf5_hl_fortran
|
||||
hl_test_image_fortran
|
||||
hl_test_lite_fortran
|
||||
hl_test_table_fortran
|
||||
|
||||
Click on "OK", From the main menu, choose "Build"-> "Build" or
|
||||
"Rebuild ALL" to build both release and debug version of HDF5
|
||||
Libraries.
|
||||
|
||||
2.3 If you don't want to build HDF5 High-Level Libraries,
|
||||
Go to "Build" and select "Configuration Manager". Choose "Release"
|
||||
or "Debug" under "Active Solution Configuration"
|
||||
|
||||
Disable the following projects:
|
||||
|
||||
hdf5_hl
|
||||
hl_test_image
|
||||
hl_test_lite
|
||||
hl_test_table
|
||||
hl_test_ds
|
||||
hl_test_packet
|
||||
|
||||
Click on "OK", From the main menu, choose "Build"-> "Build" or
|
||||
"Rebuild ALL" to build both release and debug version of HDF5
|
||||
Libraries.
|
||||
|
||||
2.4 If you don't want to build HDF5 C++ High-Level C++ Libraries,
|
||||
Go to "Build" and select "Configuration Manager".
|
||||
Choose "Release" or "Debug" under "Active Solution Configuration"
|
||||
|
||||
Disable the following projects:
|
||||
|
||||
hdf5_hl_cpp
|
||||
hl_test_table_cpp
|
||||
|
||||
Click on "OK", From the main menu, choose "Build"-> "Build" or
|
||||
"Rebuild ALL" to build both release and debug version of HDF5
|
||||
Libraries.
|
||||
|
||||
2.5 If you don't want to build HDF5 Fortran High-Level Libraries,
|
||||
Go to "Build" and select "Configuration Manager".
|
||||
Choose "Release" or "Debug" under "Active Solution Configuration".
|
||||
|
||||
Disable the following projects:
|
||||
|
||||
hdf5_hl_fortran
|
||||
hl_test_image_fortran
|
||||
hl_test_lite_fortran
|
||||
hl_test_table_fortran
|
||||
|
||||
Click on "OK", From the main menu, choose "Build"-> "Build" or
|
||||
"Rebuild ALL" to build both release and debug version of HDF5
|
||||
Libraries.
|
||||
|
||||
3. Testing HDF5 Libraries and Tools.
|
||||
|
||||
HDF5 libraries and tools should be tested to make sure that they were
|
||||
built correctly.
|
||||
|
||||
HDF5 libraries and tools can be tested with hdf5check.bat batch file
|
||||
in c:\MyHDFstuff\hdf5 directory.
|
||||
|
||||
hdf5check.bat has four options:
|
||||
|
||||
hdf5check test HDF5 C library and tools only
|
||||
|
||||
hdf5check enablecpp test HDF5 C/C++ libraries and tools
|
||||
|
||||
hdf5check enablefortran test HDF5 C/Fortran libraries
|
||||
and tools
|
||||
|
||||
hdf5check enableall test HDF5 C/C++/Fortran libraries
|
||||
and tools
|
||||
|
||||
|
||||
Invoke a command prompt window and run hdf5check with appropriate
|
||||
options.
|
||||
|
||||
Test results are saved in two files:
|
||||
|
||||
c:\MyHDFstuff\hdf5\tests_results.txt
|
||||
|
||||
c:\MyHDFstuff\hdf5\check_results.txt.
|
||||
|
||||
In general, you only need to check tests_results.txt. If all the
|
||||
tests passed, then you do not have to check check_results.txt.
|
||||
If some tests failed, check check_results.txt can help you
|
||||
figure out what was wrong.
|
||||
|
||||
If you want to test HDF5 libraries and tools one by one, please refer to
|
||||
section II, step 2 in INSTALL_Windows.txt.
|
||||
|
||||
|
||||
STEP 3: Installing HDF5 Libraries
|
||||
|
||||
Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install
|
||||
all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory.
|
||||
|
||||
|
||||
STEP 4: Building HDF5 Examples (Optional)
|
||||
|
||||
Please read section II, step 4 in INSTALL_Windows.txt.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user