ObsPluginHelpers.cmake 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443
  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
  98. ${CCACHE_PROGRAM}
  99. CACHE INTERNAL "")
  100. set(CMAKE_C_COMPILER_LAUNCHER
  101. ${CCACHE_PROGRAM}
  102. CACHE INTERNAL "")
  103. set(CMAKE_OBJC_COMPILER_LAUNCHER
  104. ${CCACHE_PROGRAM}
  105. CACHE INTERNAL "")
  106. set(CMAKE_OBJCXX_COMPILER_LAUNCHER
  107. ${CCACHE_PROGRAM}
  108. CACHE INTERNAL "")
  109. set(CMAKE_CUDA_COMPILER_LAUNCHER
  110. ${CCACHE_PROGRAM}
  111. CACHE INTERNAL "") # CMake 3.9+
  112. endif()
  113. endif()
  114. if(OS_MACOS)
  115. set(CMAKE_OSX_ARCHITECTURES
  116. "x86_64"
  117. CACHE STRING
  118. "OBS build architecture for macOS - x86_64 required at least")
  119. set_property(CACHE CMAKE_OSX_ARCHITECTURES PROPERTY STRINGS x86_64 arm64
  120. "x86_64;arm64")
  121. set(CMAKE_OSX_DEPLOYMENT_TARGET
  122. "10.13"
  123. CACHE STRING "OBS deployment target for macOS - 10.15+ required")
  124. set_property(CACHE CMAKE_OSX_DEPLOYMENT_TARGET PROPERTY STRINGS 10.15 11 12)
  125. set(OBS_BUNDLE_CODESIGN_IDENTITY
  126. "-"
  127. CACHE STRING "OBS code signing identity for macOS")
  128. set(OBS_CODESIGN_ENTITLEMENTS
  129. ${CMAKE_SOURCE_DIR}/cmake/bundle/macos/entitlements.plist
  130. CACHE INTERNAL "Path to codesign entitlements plist")
  131. set(OBS_CODESIGN_LINKER
  132. ON
  133. CACHE BOOL "Enable linker code-signing on macOS (macOS 11+ required)")
  134. # Xcode configuration
  135. if(XCODE)
  136. # Tell Xcode to pretend the linker signed binaries so that editing with
  137. # install_name_tool preserves ad-hoc signatures. This option is supported by
  138. # codesign on macOS 11 or higher. See CMake Issue 21854:
  139. # https://gitlab.kitware.com/cmake/cmake/-/issues/21854
  140. set(CMAKE_XCODE_GENERATE_SCHEME ON)
  141. if(OBS_CODESIGN_LINKER)
  142. set(CMAKE_XCODE_ATTRIBUTE_OTHER_CODE_SIGN_FLAGS "-o linker-signed")
  143. endif()
  144. endif()
  145. # Set default options for bundling on macOS
  146. set(CMAKE_MACOSX_RPATH ON)
  147. set(CMAKE_SKIP_BUILD_RPATH OFF)
  148. set(CMAKE_BUILD_WITH_INSTALL_RPATH OFF)
  149. set(CMAKE_INSTALL_RPATH "@executable_path/../Frameworks/")
  150. set(CMAKE_INSTALL_RPATH_USE_LINK_PATH OFF)
  151. function(setup_plugin_target target)
  152. if(NOT DEFINED MACOSX_PLUGIN_GUI_IDENTIFIER)
  153. message(
  154. FATAL_ERROR
  155. "No 'MACOSX_PLUGIN_GUI_IDENTIFIER' set, but is required to build plugin bundles on macOS - example: 'com.yourname.pluginname'"
  156. )
  157. endif()
  158. if(NOT DEFINED MACOSX_PLUGIN_BUNDLE_VERSION)
  159. message(
  160. FATAL_ERROR
  161. "No 'MACOSX_PLUGIN_BUNDLE_VERSION' set, but is required to build plugin bundles on macOS - example: '25'"
  162. )
  163. endif()
  164. if(NOT DEFINED MACOSX_PLUGIN_SHORT_VERSION_STRING)
  165. message(
  166. FATAL_ERROR
  167. "No 'MACOSX_PLUGIN_SHORT_VERSION_STRING' set, but is required to build plugin bundles on macOS - example: '1.0.2'"
  168. )
  169. endif()
  170. set(MACOSX_PLUGIN_BUNDLE_NAME
  171. "${target}"
  172. PARENT_SCOPE)
  173. set(MACOSX_PLUGIN_BUNDLE_VERSION
  174. "${MACOSX_BUNDLE_BUNDLE_VERSION}"
  175. PARENT_SCOPE)
  176. set(MACOSX_PLUGIN_SHORT_VERSION_STRING
  177. "${MACOSX_BUNDLE_SHORT_VERSION_STRING}"
  178. PARENT_SCOPE)
  179. set(MACOSX_PLUGIN_EXECUTABLE_NAME
  180. "${target}"
  181. PARENT_SCOPE)
  182. set(MACOSX_PLUGIN_BUNDLE_TYPE
  183. "BNDL"
  184. PARENT_SCOPE)
  185. install(
  186. TARGETS ${target}
  187. LIBRARY DESTINATION "."
  188. COMPONENT obs_plugins
  189. NAMELINK_COMPONENT ${target}_Development)
  190. set(_COMMAND
  191. "${CMAKE_INSTALL_NAME_TOOL} \\
  192. -change ${CMAKE_PREFIX_PATH}/lib/QtWidgets.framework/Versions/${QT_VERSION}/QtWidgets @rpath/QtWidgets.framework/Versions/${QT_VERSION}/QtWidgets \\
  193. -change ${CMAKE_PREFIX_PATH}/lib/QtCore.framework/Versions/${QT_VERSION}/QtCore @rpath/QtCore.framework/Versions/${QT_VERSION}/QtCore \\
  194. -change ${CMAKE_PREFIX_PATH}/lib/QtGui.framework/Versions/${QT_VERSION}/QtGui @rpath/QtGui.framework/Versions/${QT_VERSION}/QtGui \\
  195. \\\"\${CMAKE_INSTALL_PREFIX}/${target}.plugin/Contents/MacOS/${target}\\\""
  196. )
  197. install(CODE "execute_process(COMMAND /bin/sh -c \"${_COMMAND}\")"
  198. COMPONENT obs_plugins)
  199. if(NOT XCODE)
  200. set(_COMMAND
  201. "/usr/bin/codesign --force \\
  202. --sign \\\"${OBS_BUNDLE_CODESIGN_IDENTITY}\\\" \\
  203. --options runtime \\
  204. --entitlements \\\"${CMAKE_CURRENT_FUNCTION_LIST_DIR}/bundle/macOS/entitlements.plist\\\" \\
  205. \\\"${CMAKE_INSTALL_PREFIX}/${target}.plugin\\\"")
  206. install(CODE "execute_process(COMMAND /bin/sh -c \"${_COMMAND}\")"
  207. COMPONENT obs_plugins)
  208. endif()
  209. set_target_properties(
  210. ${target}
  211. PROPERTIES
  212. BUNDLE ON
  213. BUNDLE_EXTENSION "plugin"
  214. OUTPUT_NAME ${target}
  215. MACOSX_BUNDLE_INFO_PLIST
  216. "${CMAKE_CURRENT_FUNCTION_LIST_DIR}/bundle/macOS/Plugin-Info.plist.in"
  217. XCODE_ATTRIBUTE_PRODUCT_BUNDLE_IDENTIFIER
  218. "${MACOSX_PLUGIN_GUI_IDENTIFIER}"
  219. XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY "${OBS_BUNDLE_CODESIGN_IDENTITY}"
  220. XCODE_ATTRIBUTE_CODE_SIGN_ENTITLEMENTS
  221. "${CMAKE_CURRENT_FUNCTION_LIST_DIR}/bundle/macOS/entitlements.plist")
  222. add_custom_command(
  223. TARGET ${target}
  224. POST_BUILD
  225. COMMAND
  226. /bin/sh -c
  227. "codesign --force --sign \"-\" $<$<BOOL:${OBS_CODESIGN_LINKER}>:--options linker-signed >\"$<TARGET_BUNDLE_DIR:${target}>\""
  228. COMMENT "Codesigning ${target}"
  229. VERBATIM)
  230. install_bundle_resources(${target})
  231. endfunction()
  232. function(install_bundle_resources target)
  233. if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/data)
  234. file(GLOB_RECURSE _DATA_FILES "${CMAKE_CURRENT_SOURCE_DIR}/data/*")
  235. foreach(_DATA_FILE IN LISTS _DATA_FILES)
  236. file(RELATIVE_PATH _RELATIVE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/data/
  237. ${_DATA_FILE})
  238. get_filename_component(_RELATIVE_PATH ${_RELATIVE_PATH} PATH)
  239. target_sources(${target} PRIVATE ${_DATA_FILE})
  240. set_source_files_properties(
  241. ${_DATA_FILE} PROPERTIES MACOSX_PACKAGE_LOCATION
  242. Resources/${_RELATIVE_PATH})
  243. string(REPLACE "\\" "\\\\" _GROUP_NAME ${_RELATIVE_PATH})
  244. source_group("Resources\\${_GROUP_NAME}" FILES ${_DATA_FILE})
  245. endforeach()
  246. endif()
  247. endfunction()
  248. else()
  249. if(CMAKE_SIZEOF_VOID_P EQUAL 8)
  250. set(_ARCH_SUFFIX 64)
  251. else()
  252. set(_ARCH_SUFFIX 32)
  253. endif()
  254. set(OBS_OUTPUT_DIR ${CMAKE_BINARY_DIR}/rundir)
  255. if(OS_POSIX)
  256. option(LINUX_PORTABLE "Build portable version (Linux)" ON)
  257. if(NOT LINUX_PORTABLE)
  258. set(OBS_LIBRARY_DESTINATION ${CMAKE_INSTALL_LIBDIR})
  259. set(OBS_PLUGIN_DESTINATION ${OBS_LIBRARY_DESTINATION}/obs-plugins)
  260. set(CMAKE_INSTALL_RPATH ${CMAKE_INSTALL_PREFIX}/lib)
  261. set(OBS_DATA_DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/obs)
  262. else()
  263. set(OBS_LIBRARY_DESTINATION bin/${_ARCH_SUFFIX}bit)
  264. set(OBS_PLUGIN_DESTINATION obs-plugins/${_ARCH_SUFFIX}bit)
  265. set(CMAKE_INSTALL_RPATH
  266. "$ORIGIN/" "${CMAKE_INSTALL_PREFIX}/${OBS_LIBRARY_DESTINATION}")
  267. set(OBS_DATA_DESTINATION "data")
  268. endif()
  269. if(OS_LINUX)
  270. set(CPACK_PACKAGE_NAME "${CMAKE_PROJECT_NAME}")
  271. set(CPACK_DEBIAN_PACKAGE_MAINTAINER "${LINUX_MAINTAINER_EMAIL}")
  272. set(CPACK_PACKAGE_VERSION "${CMAKE_PROJECT_VERSION}")
  273. set(CPACK_PACKAGE_FILE_NAME
  274. "${CPACK_PACKAGE_NAME}-${CPACK_PACKAGE_VERSION}-linux-x86_64")
  275. set(CPACK_GENERATOR "DEB")
  276. set(CPACK_DEBIAN_PACKAGE_DEPENDS
  277. "obs-studio (>= 27.0.0), libqt5core5a (>= 5.9.0~beta), libqt5gui5 (>= 5.3.0), libqt5widgets5 (>= 5.7.0)"
  278. )
  279. set(CPACK_OUTPUT_FILE_PREFIX ${CMAKE_SOURCE_DIR}/release)
  280. if(NOT LINUX_PORTABLE)
  281. set(CPACK_SET_DESTDIR ON)
  282. endif()
  283. include(CPack)
  284. endif()
  285. else()
  286. set(OBS_LIBRARY_DESTINATION "bin/${_ARCH_SUFFIX}bit")
  287. set(OBS_LIBRARY32_DESTINATION "bin/32bit")
  288. set(OBS_LIBRARY64_DESTINATION "bin/64bit")
  289. set(OBS_PLUGIN_DESTINATION "obs-plugins/${_ARCH_SUFFIX}bit")
  290. set(OBS_PLUGIN32_DESTINATION "obs-plugins/32bit")
  291. set(OBS_PLUGIN64_DESTINATION "obs-plugins/64bit")
  292. set(OBS_DATA_DESTINATION "data")
  293. endif()
  294. function(setup_plugin_target target)
  295. set_target_properties(${target} PROPERTIES PREFIX "")
  296. install(
  297. TARGETS ${target}
  298. RUNTIME DESTINATION "${OBS_PLUGIN_DESTINATION}"
  299. COMPONENT ${target}_Runtime
  300. LIBRARY DESTINATION "${OBS_PLUGIN_DESTINATION}"
  301. COMPONENT ${target}_Runtime
  302. NAMELINK_COMPONENT ${target}_Development)
  303. install(
  304. FILES $<TARGET_FILE:${target}>
  305. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  306. COMPONENT obs_rundir
  307. EXCLUDE_FROM_ALL)
  308. if(OS_WINDOWS)
  309. install(
  310. FILES $<TARGET_PDB_FILE:${target}>
  311. CONFIGURATIONS "RelWithDebInfo" "Debug"
  312. DESTINATION ${OBS_PLUGIN_DESTINATION}
  313. COMPONENT ${target}_Runtime
  314. OPTIONAL)
  315. install(
  316. FILES $<TARGET_PDB_FILE:${target}>
  317. CONFIGURATIONS "RelWithDebInfo" "Debug"
  318. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  319. COMPONENT obs_rundir
  320. OPTIONAL EXCLUDE_FROM_ALL)
  321. endif()
  322. if(MSVC)
  323. target_link_options(
  324. ${target}
  325. PRIVATE
  326. "LINKER:/OPT:REF"
  327. "$<$<NOT:$<EQUAL:${CMAKE_SIZEOF_VOID_P},8>>:LINKER\:/SAFESEH\:NO>"
  328. "$<$<CONFIG:DEBUG>:LINKER\:/INCREMENTAL:NO>"
  329. "$<$<CONFIG:RELWITHDEBINFO>:LINKER\:/INCREMENTAL:NO>")
  330. endif()
  331. setup_target_resources(${target} obs-plugins/${target})
  332. if(OS_WINDOWS AND DEFINED OBS_BUILD_DIR)
  333. setup_target_for_testing(${target} obs-plugins/${target})
  334. endif()
  335. add_custom_command(
  336. TARGET ${target}
  337. POST_BUILD
  338. COMMAND
  339. "${CMAKE_COMMAND}" -DCMAKE_INSTALL_PREFIX=${OBS_OUTPUT_DIR}
  340. -DCMAKE_INSTALL_COMPONENT=obs_rundir
  341. -DCMAKE_INSTALL_CONFIG_NAME=$<CONFIG> -P
  342. ${CMAKE_CURRENT_BINARY_DIR}/cmake_install.cmake
  343. COMMENT "Installing to plugin rundir"
  344. VERBATIM)
  345. endfunction()
  346. function(setup_target_resources target destination)
  347. if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/data)
  348. install(
  349. DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/data/
  350. DESTINATION ${OBS_DATA_DESTINATION}/${destination}
  351. USE_SOURCE_PERMISSIONS
  352. COMPONENT obs_plugins)
  353. install(
  354. DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/data
  355. DESTINATION $<CONFIG>/${OBS_DATA_DESTINATION}/${destination}
  356. USE_SOURCE_PERMISSIONS
  357. COMPONENT obs_rundir
  358. EXCLUDE_FROM_ALL)
  359. endif()
  360. endfunction()
  361. if(OS_WINDOWS)
  362. function(setup_target_for_testing target destination)
  363. install(
  364. FILES $<TARGET_FILE:${target}>
  365. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  366. COMPONENT obs_testing
  367. EXCLUDE_FROM_ALL)
  368. install(
  369. FILES $<TARGET_PDB_FILE:${target}>
  370. CONFIGURATIONS "RelWithDebInfo" "Debug"
  371. DESTINATION $<CONFIG>/${OBS_PLUGIN_DESTINATION}
  372. COMPONENT obs_testing
  373. OPTIONAL EXCLUDE_FROM_ALL)
  374. install(
  375. DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/data/
  376. DESTINATION $<CONFIG>/${OBS_DATA_DESTINATION}/${destination}
  377. USE_SOURCE_PERMISSIONS
  378. COMPONENT obs_testing
  379. EXCLUDE_FROM_ALL)
  380. add_custom_command(
  381. TARGET ${target}
  382. POST_BUILD
  383. COMMAND
  384. "${CMAKE_COMMAND}" -DCMAKE_INSTALL_PREFIX=${OBS_BUILD_DIR}/rundir
  385. -DCMAKE_INSTALL_COMPONENT=obs_testing
  386. -DCMAKE_INSTALL_CONFIG_NAME=$<CONFIG> -P
  387. ${CMAKE_CURRENT_BINARY_DIR}/cmake_install.cmake
  388. COMMENT "Installing to OBS test directory"
  389. VERBATIM)
  390. endfunction()
  391. endif()
  392. endif()