PrecompiledHeader.cmake 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214
  1. # Function for setting up precompiled headers. Usage:
  2. #
  3. # add_library/executable(target
  4. # pchheader.c pchheader.cpp pchheader.h)
  5. #
  6. # add_precompiled_header(target pchheader.h
  7. # [FORCEINCLUDE]
  8. # [SOURCE_C pchheader.c]
  9. # [SOURCE_CXX pchheader.cpp])
  10. #
  11. # Options:
  12. #
  13. # FORCEINCLUDE: Add compiler flags to automatically include the
  14. # pchheader.h from every source file. Works with both GCC and
  15. # MSVC. This is recommended.
  16. #
  17. # SOURCE_C/CXX: Specifies the .c/.cpp source file that includes
  18. # pchheader.h for generating the pre-compiled header
  19. # output. Defaults to pchheader.c. Only required for MSVC.
  20. #
  21. # Caveats:
  22. #
  23. # * Its not currently possible to use the same precompiled-header in
  24. # more than a single target in the same directory (No way to set
  25. # the source file properties differently for each target).
  26. #
  27. # * MSVC: A source file with the same name as the header must exist
  28. # and be included in the target (E.g. header.cpp). Name of file
  29. # can be changed using the SOURCE_CXX/SOURCE_C options.
  30. #
  31. # License:
  32. #
  33. # Copyright (C) 2009-2017 Lars Christensen <larsch@belunktum.dk>
  34. #
  35. # Permission is hereby granted, free of charge, to any person
  36. # obtaining a copy of this software and associated documentation files
  37. # (the 'Software') deal in the Software without restriction,
  38. # including without limitation the rights to use, copy, modify, merge,
  39. # publish, distribute, sublicense, and/or sell copies of the Software,
  40. # and to permit persons to whom the Software is furnished to do so,
  41. # subject to the following conditions:
  42. #
  43. # The above copyright notice and this permission notice shall be
  44. # included in all copies or substantial portions of the Software.
  45. #
  46. # THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
  47. # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  48. # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  49. # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
  50. # BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
  51. # ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  52. # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  53. # SOFTWARE.
  54. include(CMakeParseArguments)
  55. macro(combine_arguments _variable)
  56. set(_result "")
  57. foreach(_element ${${_variable}})
  58. set(_result "${_result} \"${_element}\"")
  59. endforeach()
  60. string(STRIP "${_result}" _result)
  61. set(${_variable} "${_result}")
  62. endmacro()
  63. function(export_all_flags _filename)
  64. set(_include_directories "$<TARGET_PROPERTY:${_target},INCLUDE_DIRECTORIES>")
  65. set(_compile_definitions "$<TARGET_PROPERTY:${_target},COMPILE_DEFINITIONS>")
  66. set(_compile_flags "$<TARGET_PROPERTY:${_target},COMPILE_FLAGS>")
  67. set(_compile_options "$<TARGET_PROPERTY:${_target},COMPILE_OPTIONS>")
  68. set(_include_directories "$<$<BOOL:${_include_directories}>:-I$<JOIN:${_include_directories},\n-I>\n>")
  69. set(_compile_definitions "$<$<BOOL:${_compile_definitions}>:-D$<JOIN:${_compile_definitions},\n-D>\n>")
  70. set(_compile_flags "$<$<BOOL:${_compile_flags}>:$<JOIN:${_compile_flags},\n>\n>")
  71. set(_compile_options "$<$<BOOL:${_compile_options}>:$<JOIN:${_compile_options},\n>\n>")
  72. file(GENERATE OUTPUT "${_filename}" CONTENT "${_compile_definitions}${_include_directories}${_compile_flags}${_compile_options}\n")
  73. endfunction()
  74. function(add_precompiled_header _target _input)
  75. cmake_parse_arguments(_PCH "FORCEINCLUDE" "SOURCE_CXX;SOURCE_C" "" ${ARGN})
  76. get_filename_component(_input_we ${_input} NAME_WE)
  77. if(NOT _PCH_SOURCE_CXX)
  78. set(_PCH_SOURCE_CXX "${_input_we}.cpp")
  79. endif()
  80. if(NOT _PCH_SOURCE_C)
  81. set(_PCH_SOURCE_C "${_input_we}.c")
  82. endif()
  83. if(MSVC)
  84. set(_pch_cxx_pch "${CMAKE_CFG_INTDIR}/cxx_${_input_we}.pch")
  85. set(_pch_c_pch "${CMAKE_CFG_INTDIR}/c_${_input_we}.pch")
  86. get_target_property(sources ${_target} SOURCES)
  87. foreach(_source ${sources})
  88. set(_pch_compile_flags "")
  89. if(_source MATCHES \\.\(cc|cxx|cpp|c\)$)
  90. if(_source MATCHES \\.\(cpp|cxx|cc\)$)
  91. set(_pch_header "${_input}")
  92. set(_pch "${_pch_cxx_pch}")
  93. else()
  94. set(_pch_header "${_input}")
  95. set(_pch "${_pch_c_pch}")
  96. endif()
  97. if(_source STREQUAL "${_PCH_SOURCE_CXX}")
  98. set(_pch_compile_flags "${_pch_compile_flags} \"/Fp${_pch_cxx_pch}\" \"/Yc${_input}\"")
  99. set(_pch_source_cxx_found TRUE)
  100. set_source_files_properties("${_source}" PROPERTIES OBJECT_OUTPUTS "${_pch_cxx_pch}")
  101. elseif(_source STREQUAL "${_PCH_SOURCE_C}")
  102. set(_pch_compile_flags "${_pch_compile_flags} \"/Fp${_pch_c_pch}\" \"/Yc${_input}\"")
  103. set(_pch_source_c_found TRUE)
  104. set_source_files_properties("${_source}" PROPERTIES OBJECT_OUTPUTS "${_pch_c_pch}")
  105. else()
  106. if(_source MATCHES \\.\(cpp|cxx|cc\)$)
  107. set(_pch_compile_flags "${_pch_compile_flags} \"/Fp${_pch_cxx_pch}\" \"/Yu${_input}\"")
  108. set(_pch_source_cxx_needed TRUE)
  109. set_source_files_properties("${_source}" PROPERTIES OBJECT_DEPENDS "${_pch_cxx_pch}")
  110. else()
  111. set(_pch_compile_flags "${_pch_compile_flags} \"/Fp${_pch_c_pch}\" \"/Yu${_input}\"")
  112. set(_pch_source_c_needed TRUE)
  113. set_source_files_properties("${_source}" PROPERTIES OBJECT_DEPENDS "${_pch_c_pch}")
  114. endif()
  115. if(_PCH_FORCEINCLUDE)
  116. set(_pch_compile_flags "${_pch_compile_flags} /FI${_input}")
  117. endif(_PCH_FORCEINCLUDE)
  118. endif()
  119. get_source_file_property(_object_depends "${_source}" OBJECT_DEPENDS)
  120. if(NOT _object_depends)
  121. set(_object_depends)
  122. endif()
  123. if(_PCH_FORCEINCLUDE)
  124. list(APPEND _object_depends "${CMAKE_CURRENT_SOURCE_DIR}/${_pch_header}")
  125. endif()
  126. set_source_files_properties(${_source} PROPERTIES
  127. COMPILE_FLAGS "${_pch_compile_flags}"
  128. OBJECT_DEPENDS "${_object_depends}")
  129. endif()
  130. endforeach()
  131. if(_pch_source_cxx_needed AND NOT _pch_source_cxx_found)
  132. message(FATAL_ERROR "A source file ${_PCH_SOURCE_CXX} for ${_input} is required for MSVC builds. Can be set with the SOURCE_CXX option.")
  133. endif()
  134. if(_pch_source_c_needed AND NOT _pch_source_c_found)
  135. message(FATAL_ERROR "A source file ${_PCH_SOURCE_C} for ${_input} is required for MSVC builds. Can be set with the SOURCE_C option.")
  136. endif()
  137. endif(MSVC)
  138. if(CMAKE_COMPILER_IS_GNUCXX)
  139. get_filename_component(_name ${_input} NAME)
  140. set(_pch_header "${CMAKE_CURRENT_SOURCE_DIR}/${_input}")
  141. set(_pch_binary_dir "${CMAKE_CURRENT_BINARY_DIR}/${_target}_pch")
  142. set(_pchfile "${_pch_binary_dir}/${_input}")
  143. set(_outdir "${CMAKE_CURRENT_BINARY_DIR}/${_target}_pch/${_name}.gch")
  144. file(MAKE_DIRECTORY "${_outdir}")
  145. set(_output_cxx "${_outdir}/.c++")
  146. set(_output_c "${_outdir}/.c")
  147. set(_pch_flags_file "${_pch_binary_dir}/compile_flags.rsp")
  148. export_all_flags("${_pch_flags_file}")
  149. set(_compiler_FLAGS "@${_pch_flags_file}")
  150. add_custom_command(
  151. OUTPUT "${_pchfile}"
  152. COMMAND "${CMAKE_COMMAND}" -E copy "${_pch_header}" "${_pchfile}"
  153. DEPENDS "${_pch_header}"
  154. COMMENT "Updating ${_name}")
  155. add_custom_command(
  156. OUTPUT "${_output_cxx}"
  157. COMMAND "${CMAKE_CXX_COMPILER}" ${_compiler_FLAGS} -x c++-header -o "${_output_cxx}" "${_pchfile}"
  158. DEPENDS "${_pchfile}" "${_pch_flags_file}"
  159. COMMENT "Precompiling ${_name} for ${_target} (C++)")
  160. add_custom_command(
  161. OUTPUT "${_output_c}"
  162. COMMAND "${CMAKE_C_COMPILER}" ${_compiler_FLAGS} -x c-header -o "${_output_c}" "${_pchfile}"
  163. DEPENDS "${_pchfile}" "${_pch_flags_file}"
  164. COMMENT "Precompiling ${_name} for ${_target} (C)")
  165. get_property(_sources TARGET ${_target} PROPERTY SOURCES)
  166. foreach(_source ${_sources})
  167. set(_pch_compile_flags "")
  168. if(_source MATCHES \\.\(cc|cxx|cpp|c\)$)
  169. get_source_file_property(_pch_compile_flags "${_source}" COMPILE_FLAGS)
  170. if(NOT _pch_compile_flags)
  171. set(_pch_compile_flags)
  172. endif()
  173. separate_arguments(_pch_compile_flags)
  174. list(APPEND _pch_compile_flags -Winvalid-pch)
  175. if(_PCH_FORCEINCLUDE)
  176. list(APPEND _pch_compile_flags -include "${_pchfile}")
  177. else(_PCH_FORCEINCLUDE)
  178. list(APPEND _pch_compile_flags "-I${_pch_binary_dir}")
  179. endif(_PCH_FORCEINCLUDE)
  180. get_source_file_property(_object_depends "${_source}" OBJECT_DEPENDS)
  181. if(NOT _object_depends)
  182. set(_object_depends)
  183. endif()
  184. list(APPEND _object_depends "${_pchfile}")
  185. if(_source MATCHES \\.\(cc|cxx|cpp\)$)
  186. list(APPEND _object_depends "${_output_cxx}")
  187. else()
  188. list(APPEND _object_depends "${_output_c}")
  189. endif()
  190. combine_arguments(_pch_compile_flags)
  191. set_source_files_properties(${_source} PROPERTIES
  192. COMPILE_FLAGS "${_pch_compile_flags}"
  193. OBJECT_DEPENDS "${_object_depends}")
  194. endif()
  195. endforeach()
  196. endif(CMAKE_COMPILER_IS_GNUCXX)
  197. endfunction()