Help improve the quality of CMake by running a
nightly dashboard build on your machine. If you would like to contribute
to the CMake project by building a
nightly dashboard build, you can follow these instructions:
- Install CMake 2.4.6 or greater
- Checkout CMake from cvs:
cvs -d :pserver:anonymous@www.cmake.org:/cvsroot/CMake login
(password is cmake)
cvs -d :pserver:anonymous@www.cmake.org:/cvsroot/CMake co CMake
- Configure your CMake source tree with binary cmake
- Test your setup by typing make Experimental, then check the CMake dashboard in the next hour to see if your results are available.
Once you are able to submit experimental builds, the next step is setting up a nightly build. The nightly build works in almost the same way, but
needs to be run each night by crontab or some other scheduling program.
- Create a ctest -S script for your machine
Example ctest -S script
SET (CTEST_SOURCE_DIRECTORY "C:/Hoffman/My Builds/CMake")
SET (CTEST_BINARY_DIRECTORY "C:/Hoffman/My Builds/CMakeVSNMake71")
SET (CTEST_CVS_COMMAND "C:/cygwin/bin/cvs.exe")
SET (CTEST_CVS_CHECKOUT "${CTEST_CVS_COMMAND} -d :pserver:hoffman@www.cmake.org:/cvsroot/CMake co -d
\"${CTEST_SOURCE_DIRECTORY}\" CMake")
# which ctest command to use for running the dashboard
SET (CTEST_COMMAND
"C:/Program Files/CMake/bin/ctest.exe -D Nightly"
)
# what cmake command to use for configuring this dashboard
SET (CTEST_CMAKE_COMMAND
"C:/Program Files/CMake/bin/cmake.exe"
)
####################################################################
# The values in this section are optional you can either
# have them or leave them commented out
####################################################################
# should ctest wipe the binary tree before running
SET (CTEST_START_WITH_EMPTY_BINARY_DIRECTORY TRUE)
# this is the initial cache to use for the binary tree, be careful to escape
# any quotes inside of this string if you use it
SET (CTEST_INITIAL_CACHE "
MAKECOMMAND:STRING=nmake -i
CMAKE_MAKE_PROGRAM:FILEPATH=nmake
CMAKE_GENERATOR:INTERNAL=NMake Makefiles
BUILDNAME:STRING=Win32-nmake71
SITE:STRING=VOGON.kitware
CVSCOMMAND:FILEPATH=C:/cygwin/bin/cvs.exe
")
# set any extra envionment varibles here
SET (CTEST_ENVIRONMENT
)
Once you have a ctest -S script, try running it with ctest.
/full/path/to/ctest -S /full/path/to/script.cmake
Once that is working, then add that command as a crontab entry on unix, or
to the windows scheduler program on windows.