ObsPluginHelpers.cmake 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433
  1. if(POLICY CMP0087)
  2. cmake_policy(SET CMP0087 NEW)
  3. endif()
  4. set(OBS_STANDALONE_PLUGIN_DIR ${CMAKE_SOURCE_DIR}/release)
  5. set(INCLUDED_LIBOBS_CMAKE_MODULES ON)
  6. include(GNUInstallDirs)
  7. if(${CMAKE_SYSTEM_NAME} STREQUAL "Darwin")
  8. set(OS_MACOS ON)
  9. set(OS_POSIX ON)
  10. elseif(${CMAKE_SYSTEM_NAME} MATCHES "Linux|FreeBSD|OpenBSD")
  11. set(OS_POSIX ON)
  12. string(TOUPPER "${CMAKE_SYSTEM_NAME}" _SYSTEM_NAME_U)
  13. set(OS_${_SYSTEM_NAME_U} ON)
  14. elseif(${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
  15. set(OS_WINDOWS ON)
  16. set(OS_POSIX OFF)
  17. endif()
  18. # Old-Style plugin detected, find "modern" libobs variant instead and set global
  19. # include directories to fix "bad" plugin behaviour
  20. if(DEFINED LIBOBS_INCLUDE_DIR AND NOT TARGET OBS::libobs)
  21. message(
  22. DEPRECATION
  23. "You are using an outdated method of adding 'libobs' to your project. Refer to the updated wiki on how to build and export 'libobs' and use it in your plugin projects."
  24. )
  25. find_package(libobs REQUIRED)
  26. if(TARGET OBS::libobs)
  27. set_target_properties(OBS::libobs PROPERTIES IMPORTED_GLOBAL TRUE)
  28. message(STATUS "OBS: Using modern libobs target")
  29. add_library(libobs ALIAS OBS::libobs)
  30. if(OS_WINDOWS)
  31. add_library(w32-pthreads ALIAS OBS::w32-pthreads)
  32. endif()
  33. endif()
  34. endif()
  35. if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT AND (OS_WINDOWS OR OS_MACOS))
  36. set(CMAKE_INSTALL_PREFIX
  37. ${OBS_STANDALONE_PLUGIN_DIR}
  38. CACHE STRING "Directory to install OBS plugin after building" FORCE)
  39. endif()
  40. if(NOT CMAKE_BUILD_TYPE)
  41. set(CMAKE_BUILD_TYPE
  42. "RelWithDebInfo"
  43. CACHE STRING
  44. "OBS build type [Release, RelWithDebInfo, Debug, MinSizeRel]" FORCE)
  45. set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS Release RelWithDebInfo
  46. Debug MinSizeRel)
  47. endif()
  48. if(NOT QT_VERSION)
  49. set(QT_VERSION
  50. "5"
  51. CACHE STRING "OBS Qt version [5, 6]" FORCE)
  52. set_property(CACHE QT_VERSION PROPERTY STRINGS 5 6)
  53. endif()
  54. macro(find_qt)
  55. set(oneValueArgs VERSION)
  56. set(multiValueArgs COMPONENTS COMPONENTS_WIN COMPONENTS_MAC COMPONENTS_LINUX)
  57. cmake_parse_arguments(FIND_QT "" "${oneValueArgs}" "${multiValueArgs}"
  58. ${ARGN})
  59. if(OS_WINDOWS)
  60. find_package(
  61. Qt${FIND_QT_VERSION}
  62. COMPONENTS ${FIND_QT_COMPONENTS} ${FIND_QT_COMPONENTS_WIN}
  63. REQUIRED)
  64. elseif(OS_MACOS)
  65. find_package(
  66. Qt${FIND_QT_VERSION}
  67. COMPONENTS ${FIND_QT_COMPONENTS} ${FIND_QT_COMPONENTS_MAC}
  68. REQUIRED)
  69. else()
  70. find_package(
  71. Qt${FIND_QT_VERSION}
  72. COMPONENTS ${FIND_QT_COMPONENTS} ${FIND_QT_COMPONENTS_LINUX}
  73. REQUIRED)
  74. endif()
  75. foreach(_COMPONENT IN LISTS FIND_QT_COMPONENTS FIND_QT_COMPONENTS_WIN
  76. FIND_QT_COMPONENTS_MAC FIND_QT_COMPONENTS_LINUX)
  77. if(NOT TARGET Qt::${_COMPONENT} AND TARGET
  78. Qt${FIND_QT_VERSION}::${_COMPONENT})
  79. add_library(Qt::${_COMPONENT} INTERFACE IMPORTED)
  80. set_target_properties(
  81. Qt::${_COMPONENT} PROPERTIES INTERFACE_LINK_LIBRARIES
  82. "Qt${FIND_QT_VERSION}::${_COMPONENT}")
  83. endif()
  84. endforeach()
  85. endmacro()
  86. file(RELATIVE_PATH RELATIVE_INSTALL_PATH ${CMAKE_SOURCE_DIR}
  87. ${CMAKE_INSTALL_PREFIX})
  88. file(RELATIVE_PATH RELATIVE_BUILD_PATH ${CMAKE_SOURCE_DIR} ${CMAKE_BINARY_DIR})
  89. # Set up OS-specific environment and helper functions
  90. if(OS_POSIX)
  91. find_program(CCACHE_PROGRAM "ccache")
  92. set(CCACHE_SUPPORT
  93. ON
  94. CACHE BOOL "Enable ccache support")
  95. mark_as_advanced(CCACHE_PROGRAM)
  96. if(CCACHE_PROGRAM AND CCACHE_SUPPORT)
  97. set(CMAKE_CXX_COMPILER_LAUNCHER ${CCACHE_PROGRAM})
  98. set(CMAKE_C_COMPILER_LAUNCHER ${CCACHE_PROGRAM})
  99. set(CMAKE_OBJC_COMPILER_LAUNCHER ${CCACHE_PROGRAM})
  100. set(CMAKE_OBJCXX_COMPILER_LAUNCHER ${CCACHE_PROGRAM})
  101. set(CMAKE_CUDA_COMPILER_LAUNCHER ${CCACHE_PROGRAM}) # CMake 3.9+
  102. endif()
  103. endif()
  104. if(OS_MACOS)
  105. set(CMAKE_OSX_ARCHITECTURES
  106. "x86_64"
  107. CACHE STRING
  108. "OBS build architecture for macOS - x86_64 required at least")
  109. set_property(CACHE CMAKE_OSX_ARCHITECTURES PROPERTY STRINGS x86_64 arm64
  110. "x86_64;arm64")
  111. set(CMAKE_OSX_DEPLOYMENT_TARGET
  112. "10.13"
  113. CACHE STRING "OBS deployment target for macOS - 10.15+ required")
  114. set_property(CACHE CMAKE_OSX_DEPLOYMENT_TARGET PROPERTY STRINGS 10.15 11 12)
  115. set(OBS_BUNDLE_CODESIGN_IDENTITY
  116. "-"
  117. CACHE STRING "OBS code signing identity for macOS")
  118. set(OBS_CODESIGN_ENTITLEMENTS
  119. ${CMAKE_SOURCE_DIR}/cmake/bundle/macos/entitlements.plist
  120. CACHE INTERNAL "Path to codesign entitlements plist")
  121. set(OBS_CODESIGN_LINKER
  122. ON
  123. CACHE BOOL "Enable linker code-signing on macOS (macOS 11+ required)")
  124. # Xcode configuration
  125. if(XCODE)
  126. # Tell Xcode to pretend the linker signed binaries so that editing with
  127. # install_name_tool preserves ad-hoc signatures. This option is supported by
  128. # codesign on macOS 11 or higher. See CMake Issue 21854:
  129. # https://gitlab.kitware.com/cmake/cmake/-/issues/21854
  130. set(CMAKE_XCODE_GENERATE_SCHEME ON)
  131. if(OBS_CODESIGN_LINKER)
  132. set(CMAKE_XCODE_ATTRIBUTE_OTHER_CODE_SIGN_FLAGS "-o linker-signed")
  133. endif()
  134. endif()
  135. # Set default options for bundling on macOS
  136. set(CMAKE_MACOSX_RPATH ON)
  137. set(CMAKE_SKIP_BUILD_RPATH OFF)
  138. set(CMAKE_BUILD_WITH_INSTALL_RPATH OFF)
  139. set(CMAKE_INSTALL_RPATH "@executable_path/../Frameworks/")
  140. set(CMAKE_INSTALL_RPATH_USE_LINK_PATH OFF)
  141. function(setup_plugin_target target)
  142. if(NOT DEFINED MACOSX_PLUGIN_GUI_IDENTIFIER)
  143. message(
  144. FATAL_ERROR
  145. "No 'MACOSX_PLUGIN_GUI_IDENTIFIER' set, but is required to build plugin bundles on macOS - example: 'com.yourname.pluginname'"
  146. )
  147. endif()
  148. if(NOT DEFINED MACOSX_PLUGIN_BUNDLE_VERSION)
  149. message(
  150. FATAL_ERROR
  151. "No 'MACOSX_PLUGIN_BUNDLE_VERSION' set, but is required to build plugin bundles on macOS - example: '25'"
  152. )
  153. endif()
  154. if(NOT DEFINED MACOSX_PLUGIN_SHORT_VERSION_STRING)
  155. message(
  156. FATAL_ERROR
  157. "No 'MACOSX_PLUGIN_SHORT_VERSION_STRING' set, but is required to build plugin bundles on macOS - example: '1.0.2'"
  158. )
  159. endif()
  160. set(MACOSX_PLUGIN_BUNDLE_NAME
  161. "${target}"
  162. PARENT_SCOPE)
  163. set(MACOSX_PLUGIN_BUNDLE_VERSION
  164. "${MACOSX_BUNDLE_BUNDLE_VERSION}"
  165. PARENT_SCOPE)
  166. set(MACOSX_PLUGIN_SHORT_VERSION_STRING
  167. "${MACOSX_BUNDLE_SHORT_VERSION_STRING}"
  168. PARENT_SCOPE)
  169. set(MACOSX_PLUGIN_EXECUTABLE_NAME
  170. "${target}"
  171. PARENT_SCOPE)
  172. set(MACOSX_PLUGIN_BUNDLE_TYPE
  173. "BNDL"
  174. PARENT_SCOPE)
  175. install(
  176. TARGETS ${target}
  177. LIBRARY DESTINATION "."
  178. COMPONENT obs_plugins
  179. NAMELINK_COMPONENT ${target}_Development)
  180. set(_COMMAND
  181. "${CMAKE_INSTALL_NAME_TOOL} \\
  182. -change ${CMAKE_PREFIX_PATH}/lib/QtWidgets.framework/Versions/${QT_VERSION}/QtWidgets @rpath/QtWidgets.framework/Versions/${QT_VERSION}/QtWidgets \\
  183. -change ${CMAKE_PREFIX_PATH}/lib/QtCore.framework/Versions/${QT_VERSION}/QtCore @rpath/QtCore.framework/Versions/${QT_VERSION}/QtCore \\
  184. -change ${CMAKE_PREFIX_PATH}/lib/QtGui.framework/Versions/${QT_VERSION}/QtGui @rpath/QtGui.framework/Versions/${QT_VERSION}/QtGui \\
  185. \\\"\${CMAKE_INSTALL_PREFIX}/${target}.plugin/Contents/MacOS/${target}\\\""
  186. )
  187. install(CODE "execute_process(COMMAND /bin/sh -c \"${_COMMAND}\")"
  188. COMPONENT obs_plugins)
  189. if(NOT XCODE)
  190. set(_COMMAND
  191. "/usr/bin/codesign --force \\
  192. --sign \\\"${OBS_BUNDLE_CODESIGN_IDENTITY}\\\" \\
  193. --options runtime \\
  194. --entitlements \\\"${CMAKE_CURRENT_FUNCTION_LIST_DIR}/bundle/macOS/entitlements.plist\\\" \\
  195. \\\"${CMAKE_INSTALL_PREFIX}/${target}.plugin\\\"")
  196. install(CODE "execute_process(COMMAND /bin/sh -c \"${_COMMAND}\")"
  197. COMPONENT obs_plugins)
  198. endif()
  199. set_target_properties(
  200. ${target}
  201. PROPERTIES
  202. BUNDLE ON
  203. BUNDLE_EXTENSION "plugin"
  204. OUTPUT_NAME ${target}
  205. MACOSX_BUNDLE_INFO_PLIST
  206. "${CMAKE_CURRENT_FUNCTION_LIST_DIR}/bundle/macOS/Plugin-Info.plist.in"
  207. XCODE_ATTRIBUTE_PRODUCT_BUNDLE_IDENTIFIER
  208. "${MACOSX_PLUGIN_GUI_IDENTIFIER}"
  209. XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY "${OBS_BUNDLE_CODESIGN_IDENTITY}"
  210. XCODE_ATTRIBUTE_CODE_SIGN_ENTITLEMENTS
  211. "${CMAKE_CURRENT_FUNCTION_LIST_DIR}/bundle/macOS/entitlements.plist")
  212. add_custom_command(
  213. TARGET ${target}
  214. POST_BUILD
  215. COMMAND
  216. /bin/sh -c
  217. "codesign --force --sign \"-\" $<$<BOOL:${OBS_CODESIGN_LINKER}>:--options linker-signed >\"$<TARGET_BUNDLE_DIR:${target}>\""
  218. COMMENT "Codesigning ${target}"
  219. VERBATIM)
  220. install_bundle_resources(${target})
  221. endfunction()
  222. function(install_bundle_resources target)
  223. if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/data)
  224. file(GLOB_RECURSE _DATA_FILES "${CMAKE_CURRENT_SOURCE_DIR}/data/*")
  225. foreach(_DATA_FILE IN LISTS _DATA_FILES)
  226. file(RELATIVE_PATH _RELATIVE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/data/
  227. ${_DATA_FILE})
  228. get_filename_component(_RELATIVE_PATH ${_RELATIVE_PATH} PATH)
  229. target_sources(${target} PRIVATE ${_DATA_FILE})
  230. set_source_files_properties(
  231. ${_DATA_FILE} PROPERTIES MACOSX_PACKAGE_LOCATION
  232. Resources/${_RELATIVE_PATH})
  233. string(REPLACE "\\" "\\\\" _GROUP_NAME ${_RELATIVE_PATH})
  234. source_group("Resources\\${_GROUP_NAME}" FILES ${_DATA_FILE})
  235. endforeach()
  236. endif()
  237. endfunction()
  238. else()
  239. if(CMAKE_SIZEOF_VOID_P EQUAL 8)
  240. set(_ARCH_SUFFIX 64)
  241. else()
  242. set(_ARCH_SUFFIX 32)
  243. endif()
  244. set(OBS_OUTPUT_DIR ${CMAKE_BINARY_DIR}/rundir)
  245. if(OS_POSIX)
  246. option(LINUX_PORTABLE "Build portable version (Linux)" ON)
  247. if(NOT LINUX_PORTABLE)
  248. set(OBS_LIBRARY_DESTINATION ${CMAKE_INSTALL_LIBDIR})
  249. set(OBS_PLUGIN_DESTINATION ${OBS_LIBRARY_DESTINATION}/obs-plugins)
  250. set(CMAKE_INSTALL_RPATH ${CMAKE_INSTALL_PREFIX}/lib)
  251. set(OBS_DATA_DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/obs)
  252. else()
  253. set(OBS_LIBRARY_DESTINATION bin/${_ARCH_SUFFIX}bit)
  254. set(OBS_PLUGIN_DESTINATION obs-plugins/${_ARCH_SUFFIX}bit)
  255. set(CMAKE_INSTALL_RPATH
  256. "$ORIGIN/" "${CMAKE_INSTALL_PREFIX}/${OBS_LIBRARY_DESTINATION}")
  257. set(OBS_DATA_DESTINATION "data")
  258. endif()
  259. if(OS_LINUX)
  260. set(CPACK_PACKAGE_NAME "${CMAKE_PROJECT_NAME}")
  261. set(CPACK_DEBIAN_PACKAGE_MAINTAINER "${LINUX_MAINTAINER_EMAIL}")
  262. set(CPACK_PACKAGE_VERSION "${CMAKE_PROJECT_VERSION}")
  263. set(CPACK_PACKAGE_FILE_NAME
  264. "${CPACK_PACKAGE_NAME}-${CPACK_PACKAGE_VERSION}-linux-x86_64")
  265. set(CPACK_GENERATOR "DEB")
  266. set(CPACK_DEBIAN_PACKAGE_DEPENDS
  267. "obs-studio (>= 27.0.0), libqt5core5a (>= 5.9.0~beta), libqt5gui5 (>= 5.3.0), libqt5widgets5 (>= 5.7.0)"
  268. )
  269. set(CPACK_OUTPUT_FILE_PREFIX ${CMAKE_SOURCE_DIR}/release)
  270. if(NOT LINUX_PORTABLE)
  271. set(CPACK_SET_DESTDIR ON)
  272. endif()
  273. include(CPack)
  274. endif()
  275. else()
  276. set(OBS_LIBRARY_DESTINATION "bin/${_ARCH_SUFFIX}bit")
  277. set(OBS_LIBRARY32_DESTINATION "bin/32bit")
  278. set(OBS_LIBRARY64_DESTINATION "bin/64bit")
  279. set(OBS_PLUGIN_DESTINATION "obs-plugins/${_ARCH_SUFFIX}bit")
  280. set(OBS_PLUGIN32_DESTINATION "obs-plugins/32bit")
  281. set(OBS_PLUGIN64_DESTINATION "obs-plugins/64bit")
  282. set(OBS_DATA_DESTINATION "data")
  283. endif()
  284. function(setup_plugin_target target)
  285. set_target_properties(${target} PROPERTIES PREFIX "")
  286. install(
  287. TARGETS ${target}
  288. RUNTIME DESTINATION "${OBS_PLUGIN_DESTINATION}"
  289. COMPONENT ${target}_Runtime
  290. LIBRARY DESTINATION "${OBS_PLUGIN_DESTINATION}"
  291. COMPONENT ${target}_Runtime
  292. NAMELINK_COMPONENT ${target}_Development)
  293. install(
  294. FILES $<TARGET_FILE:${target}>
  295. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  296. COMPONENT obs_rundir
  297. EXCLUDE_FROM_ALL)
  298. if(OS_WINDOWS)
  299. install(
  300. FILES $<TARGET_PDB_FILE:${target}>
  301. CONFIGURATIONS "RelWithDebInfo" "Debug"
  302. DESTINATION ${OBS_PLUGIN_DESTINATION}
  303. COMPONENT ${target}_Runtime
  304. OPTIONAL)
  305. install(
  306. FILES $<TARGET_PDB_FILE:${target}>
  307. CONFIGURATIONS "RelWithDebInfo" "Debug"
  308. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  309. COMPONENT obs_rundir
  310. OPTIONAL EXCLUDE_FROM_ALL)
  311. endif()
  312. if(MSVC)
  313. target_link_options(
  314. ${target}
  315. PRIVATE
  316. "LINKER:/OPT:REF"
  317. "$<$<NOT:$<EQUAL:${CMAKE_SIZEOF_VOID_P},8>>:LINKER\:/SAFESEH\:NO>"
  318. "$<$<CONFIG:DEBUG>:LINKER\:/INCREMENTAL:NO>"
  319. "$<$<CONFIG:RELWITHDEBINFO>:LINKER\:/INCREMENTAL:NO>")
  320. endif()
  321. setup_target_resources(${target} obs-plugins/${target})
  322. if(OS_WINDOWS AND DEFINED OBS_BUILD_DIR)
  323. setup_target_for_testing(${target} obs-plugins/${target})
  324. endif()
  325. add_custom_command(
  326. TARGET ${target}
  327. POST_BUILD
  328. COMMAND
  329. "${CMAKE_COMMAND}" -DCMAKE_INSTALL_PREFIX=${OBS_OUTPUT_DIR}
  330. -DCMAKE_INSTALL_COMPONENT=obs_rundir
  331. -DCMAKE_INSTALL_CONFIG_NAME=$<CONFIG> -P
  332. ${CMAKE_CURRENT_BINARY_DIR}/cmake_install.cmake
  333. COMMENT "Installing to plugin rundir"
  334. VERBATIM)
  335. endfunction()
  336. function(setup_target_resources target destination)
  337. if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/data)
  338. install(
  339. DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/data/
  340. DESTINATION ${OBS_DATA_DESTINATION}/${destination}
  341. USE_SOURCE_PERMISSIONS
  342. COMPONENT obs_plugins)
  343. install(
  344. DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/data
  345. DESTINATION $<CONFIG>/${OBS_DATA_DESTINATION}/${destination}
  346. USE_SOURCE_PERMISSIONS
  347. COMPONENT obs_rundir
  348. EXCLUDE_FROM_ALL)
  349. endif()
  350. endfunction()
  351. if(OS_WINDOWS)
  352. function(setup_target_for_testing target destination)
  353. install(
  354. FILES $<TARGET_FILE:${target}>
  355. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  356. COMPONENT obs_testing
  357. EXCLUDE_FROM_ALL)
  358. install(
  359. FILES $<TARGET_PDB_FILE:${target}>
  360. CONFIGURATIONS "RelWithDebInfo" "Debug"
  361. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  362. COMPONENT obs_testing
  363. OPTIONAL EXCLUDE_FROM_ALL)
  364. install(
  365. DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/data/
  366. DESTINATION $<CONFIG>/${OBS_DATA_DESTINATION}/${destination}
  367. USE_SOURCE_PERMISSIONS
  368. COMPONENT obs_testing
  369. EXCLUDE_FROM_ALL)
  370. add_custom_command(
  371. TARGET ${target}
  372. POST_BUILD
  373. COMMAND
  374. "${CMAKE_COMMAND}" -DCMAKE_INSTALL_PREFIX=${OBS_BUILD_DIR}/rundir
  375. -DCMAKE_INSTALL_COMPONENT=obs_testing
  376. -DCMAKE_INSTALL_CONFIG_NAME=$<CONFIG> -P
  377. ${CMAKE_CURRENT_BINARY_DIR}/cmake_install.cmake
  378. COMMENT "Installing to OBS test directory"
  379. VERBATIM)
  380. endfunction()
  381. endif()
  382. endif()