[u/mrichter/AliRoot.git] / cmake / CMakeLists.example

# **************************************************************************
# * Copyright(c) 1998-2015, ALICE Experiment at CERN, All rights reserved. *
# *                                                                        *
# * Author: The ALICE Off-line Project.                                    *
# * Contributors are mentioned in the code where appropriate.              *
# *                                                                        *
# * Permission to use, copy, modify and distribute this software and its   *
# * documentation strictly for non-commercial purposes is hereby granted   *
# * without fee, provided that the above copyright notice appears in all   *
# * copies and that both the copyright notice and this permission notice   *
# * appear in the supporting documentation. The authors make no claims     *
# * about the suitability of this software for any purpose. It is          *
# * provided "as is" without express or implied warranty.                  *
# **************************************************************************

############################################################################
# GENERAL SETTINGS                                                         #
############################################################################

# CMake configuration is controlled through CMakeLists files.
#   - Normally a single CMakeLists files should contain a single target/library.
#   - The file below tries to offer a standard format for generating libraries
#     but full access to cmake functions and utilities is possible.
#    - For any customization please use instructions provided by the minum cmake 
#     version 2.8.11
#     http://www.cmake.org/cmake/help/v2.8.11/cmake.html

# Module name
# Module name translates into library name
# Ex: set(MODULE ANALYSIS)
set(MODULE ModuleNameExample)

# Module include folder
#  - Add here all include folders containing headers that belong
#    to this module. 
#  - Do not add dependencies here
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
# For more information about include_directories please read 
# documentation for minimum required version:
# http://www.cmake.org/cmake/help/v2.8.11/cmake.html#command:include_directories
# Ex: include_directories(${AliRoot_SOURCE_DIR}/ANALYS/${MODULE})
include_directories()

# Additional include folders in alphabetical order except ROOT
#  - ROOT include folders are added by the FindROOT macro
#  - To remove compilation warnings related to dependencies headers
#    please add them as SYSTEM headers.
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
# For more information about include_directories please read 
# documentation for minimum required version:
# http://www.cmake.org/cmake/help/v2.8.11/cmake.html#command:include_directories
# Ex: include_directories(${AliRoot_SOURCE_DIR}/STEER/STEERBase
#                   )
include_directories(
                   )

# Library sources in alphabetical order
#  - Only these sources will be added to the library
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
# Ex:
#set(SRCS
#    AliAnalysisDataContainer.cxx
#    AliAnalysisDataSlot.cxx
#   )
set(SRCS
   )

# Headers generated from sources list
#  - This list is used mainly during dictionary generating and installation step,
#    all source headers will be installed into $CMAKE_INSTALL_PREFIX/include
#  - Note that it is possible to create your own custom list of headers, to add
#    to the existing one or to delete from it. Change this variable as it suits
#    the purpose of the library, but be sure you do not affect the dictionary 
#    generation
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
string(REPLACE ".cxx" ".h" HDRS "${SRCS}")

# Generating the dictionary
#  - The name of the LinkDef has to be "${MODULE}LinkDef.h"
#  - Using custom LinkDef names is for advanced users! If you are not sure
#    how to generate the dictionary please contact aliroot-git-admins@cern.ch
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
get_directory_property(incdirs INCLUDE_DIRECTORIES)
generate_dictionary("${MODULE}" "${MODULE}LinkDef.h" "${HDRS}" "${incdirs}")
# End Generation the dictionary

# Seting ROOT and AliRoot dependecies
#  - Any ROOT symbols used in the current sources has to be added to the list of 
#    dependecies. 
#  - The mapping between ROOT symbols and libraries can be found inside the ROOT
#    map files. If you are not sure which library contains a certain symbol grep
#    the rootmap files for the symbol:
# Ex:
#       $ cd $ROOTSYS/lib
#       $ grep TSelectorCint *.rootmap
#         libTree.rootmap:Library.TSelectorCint:                      libTree.so libNet.so libRIO.so libThread.so
#   TSelectorCint symbol belongs to Tree library and we add it to ROOT_DEPENDENCIES
# Ex: set(ROOT_DEPENDENCIES Core Gpad Hist Net RIO Tree XMLParser)
# Ex: set(ALIROOT_DEPENDENCIES STEERBase ANALYSIS)
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
set(ROOT_DEPENDENCIES)
set(ALIROOT_DEPENDENCIES)

# Generating the ROOT map
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
set(LIBDEPS ${ROOT_DEPENDENCIES} ${ALIROOT_DEPENDENCIES})
generate_rootmap("${MODULE}" "${LIBDEPS}" "${CMAKE_CURRENT_SOURCE_DIR}/${MODULE}LinkDef.h")
# End Generating the ROOT map

############################################################################
# END GENERAL SETTINGS                                                     #
############################################################################


############################################################################
# COMPILATION AND LINKING CUSTOM FLAGS                                    #
############################################################################

# Setting custom compilation and linking flags
# Ex system dependent: Modify the way the library is build
#       if(${CMAKE_SYSTEM} MATCHES Darwin)
#               set(MODULE_LINK_FLAGS "-undefined dynamic_lookup")
#       endif(${CMAKE_SYSTEM} MATCHES Darwin)
#  - MODULE_COMPILE_FLAGS and MODULE_LINK_FLAGS will be used later for library
#    generation
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
set(MODULE_COMPILE_FLAGS )
set(MODULE_LINK_FLAGS )

############################################################################
# END COMPILATION AND LINKING  CUSTOM FLAGS                                #
############################################################################


############################################################################
# LIBRARY CREATION                                                         #
############################################################################

# Two options are availabe when creating the libraries:
#       - dynamic only libraries
#       - dinamic and static libraries
#         Static libraries are by used the DAs. If you are sure the library will 
#         be used by the DAs it is mandatory to create the static version.
#  - Use only one of the options at a time, DO NOT FORGET to delete the content
#    that is not used

############################################################################
## 1. DYNAMIC LIBRARY CREATION - NO STATIC LIBRARY NEEDED                  #
############################################################################

# Create the dynamic library
#  - DELETE if static libraries are neded and follow Dynamic/Static libraries 
#    instructions
#  - DELETE the dynamic/static block if only dynamic libraries are needed
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
add_library(${MODULE} SHARED ${SRCS} G__${MODULE}.cxx)

# Additional compilation flags
set_target_properties(${MODULE} PROPERTIES COMPILE_FLAGS ${MODULE_COMPILE_FLAGS})

# Additional linking flags
set_target_properties(${MODULE} PROPERTIES LINK_FLAGS ${MODULE_LINK_FLAGS})

# Link library to dependecies
target_link_libraries(${MODULE} ${LIBDEPS})

############################################################################
## END DYNAMIC LIBRARY CREATION - NO STATIC LIBRARY NEEDED                 #
############################################################################


############################################################################
## 2. DYNAMIC/STATIC LIBRARY CREATION                                      #
############################################################################

#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
#  - DELETE if no static libraries are needed
#  - Create an object to be reused in case of static libraries 
#    otherwise the sources will be compiled twice
add_library(${MODULE}-object OBJECT ${SRCS} G__${MODULE}.cxx)

#  - Add a library to the project using the object
add_library(${MODULE} SHARED $<TARGET_OBJECTS:${MODULE}-object>)

# Setting the correct headers for the object as gathered from the dependencies
target_include_directories(${MODULE}-object PUBLIC $<TARGET_PROPERTY:${MODULE},INCLUDE_DIRECTORIES>)
set_target_properties(${MODULE}-object PROPERTIES COMPILE_DEFINITIONS $<TARGET_PROPERTY:${MODULE},COMPILE_DEFINITIONS>)

# Additional compilation flags
set_target_properties(${MODULE}-object PROPERTIES COMPILE_FLAGS "")

# Additional linking flags
set_target_properties(${MODULE} PROPERTIES LINK_FLAGS ${MODULE_LINK_FLAGS})

# Link library to dependecies
target_link_libraries(${MODULE} ${LIBDEPS})

# Create the static library only if ALIROOT_STATIC variable is set
# ALIROOT_STATIC is automatically set by the DA flag
if(ALIROOT_STATIC)
    add_library(${MODULE}-static STATIC $<TARGET_OBJECTS:${MODULE}-object>)
    set_target_properties(${MODULE}-static PROPERTIES OUTPUT_NAME ${MODULE})

    # list of shared dependencies / the name of the variable containing the list of static ones
    generate_static_dependencies("${ALIROOT_DEPENDENCIES}" "STATIC_ALIROOT_DEPENDENCIES")
    target_link_libraries(${MODULE}-static ${STATIC_ALIROOT_DEPENDENCIES} Root RootExtra)

    # Public include folders that will be propagated to the dependecies
    target_include_directories(${MODULE}-static PUBLIC ${incdirs})
    
    set_target_properties(${MODULE}-static PROPERTIES LINK_FLAGS "-Wl,--whole-archive")

    # Installation
    install(TARGETS ${MODULE}-static
            ARCHIVE DESTINATION lib
            LIBRARY DESTINATION lib)
endif(ALIROOT_STATIC)

############################################################################
## END DYNAMIC/STATIC LIBRARY CREATION                                     #
############################################################################

############################################################################
# END LIBRARY CREATION                                                     #
############################################################################

############################################################################
# INSTALLATION                                                             #
############################################################################

# The installation step is copying files needed at runtime into CMAKE_INSTALL_PREFIX
# DO NOT forget to install all macros needed to run Grid jobs or any files that are
# needed as input.
#  - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch

# Library installation into $CMAKE_INSTALL_PREFIX/lib
install(TARGETS ${MODULE}
        ARCHIVE DESTINATION lib
        LIBRARY DESTINATION lib)

# Header installation into $CMAKE_INSTALL_PREFIX/include
install(FILES ${HDRS} DESTINATION include)

# Macros installation
install(DIRECTORY macros DESTINATION ${MODULE})
Commit	Line	Data
6cb9cec0	1	# **************************************************************************
	2	# * Copyright(c) 1998-2015, ALICE Experiment at CERN, All rights reserved. *
	3	# * *
	4	# * Author: The ALICE Off-line Project. *
	5	# * Contributors are mentioned in the code where appropriate. *
	6	# * *
	7	# * Permission to use, copy, modify and distribute this software and its *
	8	# * documentation strictly for non-commercial purposes is hereby granted *
	9	# * without fee, provided that the above copyright notice appears in all *
	10	# * copies and that both the copyright notice and this permission notice *
	11	# * appear in the supporting documentation. The authors make no claims *
	12	# * about the suitability of this software for any purpose. It is *
	13	# * provided "as is" without express or implied warranty. *
	14	# **************************************************************************
	15
	16	############################################################################
	17	# GENERAL SETTINGS #
	18	############################################################################
	19
	20	# CMake configuration is controlled through CMakeLists files.
	21	# - Normally a single CMakeLists files should contain a single target/library.
	22	# - The file below tries to offer a standard format for generating libraries
	23	# but full access to cmake functions and utilities is possible.
	24	# - For any customization please use instructions provided by the minum cmake
	25	# version 2.8.11
	26	# http://www.cmake.org/cmake/help/v2.8.11/cmake.html
	27
	28	# Module name
	29	# Module name translates into library name
	30	# Ex: set(MODULE ANALYSIS)
	31	set(MODULE ModuleNameExample)
	32
	33	# Module include folder
	34	# - Add here all include folders containing headers that belong
	35	# to this module.
	36	# - Do not add dependencies here
	37	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
	38	# For more information about include_directories please read
	39	# documentation for minimum required version:
	40	# http://www.cmake.org/cmake/help/v2.8.11/cmake.html#command:include_directories
	41	# Ex: include_directories(${AliRoot_SOURCE_DIR}/ANALYS/${MODULE})
	42	include_directories()
	43
	44	# Additional include folders in alphabetical order except ROOT
	45	# - ROOT include folders are added by the FindROOT macro
	46	# - To remove compilation warnings related to dependencies headers
	47	# please add them as SYSTEM headers.
	48	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
	49	# For more information about include_directories please read
	50	# documentation for minimum required version:
	51	# http://www.cmake.org/cmake/help/v2.8.11/cmake.html#command:include_directories
	52	# Ex: include_directories(${AliRoot_SOURCE_DIR}/STEER/STEERBase
	53	# )
	54	include_directories(
	55	)
	56
	57	# Library sources in alphabetical order
	58	# - Only these sources will be added to the library
	59	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
	60	# Ex:
	61	#set(SRCS
	62	# AliAnalysisDataContainer.cxx
	63	# AliAnalysisDataSlot.cxx
	64	# )
65	set(SRCS
66	)
67
68	# Headers generated from sources list
69	# - This list is used mainly during dictionary generating and installation step,
70	# all source headers will be installed into $CMAKE_INSTALL_PREFIX/include
71	# - Note that it is possible to create your own custom list of headers, to add
72	# to the existing one or to delete from it. Change this variable as it suits
73	# the purpose of the library, but be sure you do not affect the dictionary
74	# generation
75	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
76	string(REPLACE ".cxx" ".h" HDRS "${SRCS}")
77
78	# Generating the dictionary
79	# - The name of the LinkDef has to be "${MODULE}LinkDef.h"
80	# - Using custom LinkDef names is for advanced users! If you are not sure
81	# how to generate the dictionary please contact aliroot-git-admins@cern.ch
82	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
83	get_directory_property(incdirs INCLUDE_DIRECTORIES)
84	generate_dictionary("${MODULE}" "${MODULE}LinkDef.h" "${HDRS}" "${incdirs}")
85	# End Generation the dictionary
86
87	# Seting ROOT and AliRoot dependecies
88	# - Any ROOT symbols used in the current sources has to be added to the list of
89	# dependecies.
90	# - The mapping between ROOT symbols and libraries can be found inside the ROOT
91	# map files. If you are not sure which library contains a certain symbol grep
92	# the rootmap files for the symbol:
93	# Ex:
94	# $ cd $ROOTSYS/lib
95	# $ grep TSelectorCint *.rootmap
96	# libTree.rootmap:Library.TSelectorCint: libTree.so libNet.so libRIO.so libThread.so
97	# TSelectorCint symbol belongs to Tree library and we add it to ROOT_DEPENDENCIES
98	# Ex: set(ROOT_DEPENDENCIES Core Gpad Hist Net RIO Tree XMLParser)
99	# Ex: set(ALIROOT_DEPENDENCIES STEERBase ANALYSIS)
100	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
101	set(ROOT_DEPENDENCIES)
102	set(ALIROOT_DEPENDENCIES)
103
104	# Generating the ROOT map
105	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
106	set(LIBDEPS ${ROOT_DEPENDENCIES} ${ALIROOT_DEPENDENCIES})
107	generate_rootmap("${MODULE}" "${LIBDEPS}" "${CMAKE_CURRENT_SOURCE_DIR}/${MODULE}LinkDef.h")
108	# End Generating the ROOT map
109
110	############################################################################
111	# END GENERAL SETTINGS #
112	############################################################################
113
114
115	############################################################################
116	# COMPILATION AND LINKING CUSTOM FLAGS #
117	############################################################################
118
119	# Setting custom compilation and linking flags
120	# Ex system dependent: Modify the way the library is build
121	# if(${CMAKE_SYSTEM} MATCHES Darwin)
122	# set(MODULE_LINK_FLAGS "-undefined dynamic_lookup")
123	# endif(${CMAKE_SYSTEM} MATCHES Darwin)
124	# - MODULE_COMPILE_FLAGS and MODULE_LINK_FLAGS will be used later for library
125	# generation
126	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
127	set(MODULE_COMPILE_FLAGS )
128	set(MODULE_LINK_FLAGS )
129
130	############################################################################
131	# END COMPILATION AND LINKING CUSTOM FLAGS #
132	############################################################################
133
134
135	############################################################################
136	# LIBRARY CREATION #
137	############################################################################
138
139	# Two options are availabe when creating the libraries:
140	# - dynamic only libraries
141	# - dinamic and static libraries
142	# Static libraries are by used the DAs. If you are sure the library will
143	# be used by the DAs it is mandatory to create the static version.
144	# - Use only one of the options at a time, DO NOT FORGET to delete the content
145	# that is not used
146
147	############################################################################
148	## 1. DYNAMIC LIBRARY CREATION - NO STATIC LIBRARY NEEDED #
149	############################################################################
150
151	# Create the dynamic library
152	# - DELETE if static libraries are neded and follow Dynamic/Static libraries
153	# instructions
154	# - DELETE the dynamic/static block if only dynamic libraries are needed
155	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
156	add_library(${MODULE} SHARED ${SRCS} G__${MODULE}.cxx)
157
158	# Additional compilation flags
159	set_target_properties(${MODULE} PROPERTIES COMPILE_FLAGS ${MODULE_COMPILE_FLAGS})
160
161	# Additional linking flags
162	set_target_properties(${MODULE} PROPERTIES LINK_FLAGS ${MODULE_LINK_FLAGS})
163
164	# Link library to dependecies
165	target_link_libraries(${MODULE} ${LIBDEPS})
166
167	############################################################################
168	## END DYNAMIC LIBRARY CREATION - NO STATIC LIBRARY NEEDED #
169	############################################################################
170
171
172	############################################################################
173	## 2. DYNAMIC/STATIC LIBRARY CREATION #
174	############################################################################
175
176	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
177	# - DELETE if no static libraries are needed
178	# - Create an object to be reused in case of static libraries
179	# otherwise the sources will be compiled twice
180	add_library(${MODULE}-object OBJECT ${SRCS} G__${MODULE}.cxx)
181
182	# - Add a library to the project using the object
183	add_library(${MODULE} SHARED $<TARGET_OBJECTS:${MODULE}-object>)
184
185	# Setting the correct headers for the object as gathered from the dependencies
186	target_include_directories(${MODULE}-object PUBLIC $<TARGET_PROPERTY:${MODULE},INCLUDE_DIRECTORIES>)
187	set_target_properties(${MODULE}-object PROPERTIES COMPILE_DEFINITIONS $<TARGET_PROPERTY:${MODULE},COMPILE_DEFINITIONS>)
188
189	# Additional compilation flags
190	set_target_properties(${MODULE}-object PROPERTIES COMPILE_FLAGS "")
191
192	# Additional linking flags
193	set_target_properties(${MODULE} PROPERTIES LINK_FLAGS ${MODULE_LINK_FLAGS})
194
195	# Link library to dependecies
196	target_link_libraries(${MODULE} ${LIBDEPS})
197
198	# Create the static library only if ALIROOT_STATIC variable is set
199	# ALIROOT_STATIC is automatically set by the DA flag
200	if(ALIROOT_STATIC)
201	add_library(${MODULE}-static STATIC $<TARGET_OBJECTS:${MODULE}-object>)
202	set_target_properties(${MODULE}-static PROPERTIES OUTPUT_NAME ${MODULE})
203
204	# list of shared dependencies / the name of the variable containing the list of static ones
205	generate_static_dependencies("${ALIROOT_DEPENDENCIES}" "STATIC_ALIROOT_DEPENDENCIES")
206	target_link_libraries(${MODULE}-static ${STATIC_ALIROOT_DEPENDENCIES} Root RootExtra)
207
208	# Public include folders that will be propagated to the dependecies
209	target_include_directories(${MODULE}-static PUBLIC ${incdirs})
210
211	set_target_properties(${MODULE}-static PROPERTIES LINK_FLAGS "-Wl,--whole-archive")
212
213	# Installation
214	install(TARGETS ${MODULE}-static
215	ARCHIVE DESTINATION lib
216	LIBRARY DESTINATION lib)
217	endif(ALIROOT_STATIC)
218
219	############################################################################
220	## END DYNAMIC/STATIC LIBRARY CREATION #
221	############################################################################
222
223	############################################################################
224	# END LIBRARY CREATION #
225	############################################################################
226
227	############################################################################
228	# INSTALLATION #
229	############################################################################
230
231	# The installation step is copying files needed at runtime into CMAKE_INSTALL_PREFIX
232	# DO NOT forget to install all macros needed to run Grid jobs or any files that are
233	# needed as input.
234	# - If you are not sure how to proceed please contact aliroot-git-admins@cern.ch
235
236	# Library installation into $CMAKE_INSTALL_PREFIX/lib
237	install(TARGETS ${MODULE}
238	ARCHIVE DESTINATION lib
239	LIBRARY DESTINATION lib)
240
241	# Header installation into $CMAKE_INSTALL_PREFIX/include
242	install(FILES ${HDRS} DESTINATION include)
243
244	# Macros installation
245	install(DIRECTORY macros DESTINATION ${MODULE})