NotepadPluginConfig.cmake.in 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  1. # NotepadPluginConfig.cmake
  2. # 用于 Notepad-- 插件实现的 CMake 模块初级定义
  3. # 在 Linux 中,它的布局应该如下:
  4. # /usr/lib/x86_64-linux-gnu/cmake/NotepadPlugin/NotepadPluginConfig.cmake
  5. # 在 插件开发层中,它的使用如下:
  6. # 1. 查找 NotepadPlugin 模块
  7. # find_package(NotepadPlugin)
  8. # 2. 使用 add_notepad_plugin(<模块名称> <源代码、资源文件> [...])
  9. # add_notepad_plugin(<plugin_name> <plugin_srcs> ...)
  10. # 一些无关紧要的部分,如果需要实现插件安装操作时,即可进行使用
  11. # include(CMakePackageConfigHelpers)
  12. # include(GNUInstallDirs)
  13. # 主要内容,在构建时的填充
  14. set(NOTEPAD_PLUGIN @NOTEPAD_PLUGIN@)
  15. set(NOTEPAD_BUILD_BY_QT5 @NOTEPAD_BUILD_BY_QT5@)
  16. set(NOTEPAD_BUILD_BY_QT6 @NOTEPAD_BUILD_BY_QT6@)
  17. set(NOTEPAD_BUILD_BY_SHARED FALSE)
  18. set(NOTEPAD_PLUGIN_CORELIB @NOTEPAD_PLUGIN_CORELIB@)
  19. # 由插件开发者进行参考的 "Notepad 提供的插件安装目录(位置)"
  20. set(NOTEPAD_PLUGIN_EXTERNAL_PLUGIN_INSTALL_DIRECTORY
  21. @NOTEPAD_PLUGIN_EXTERNAL_PLUGIN_DIRECTORY@)
  22. # 这些是被废除的内容
  23. # set(NOTEPAD_PLUGIN_INCLUDEDIR @NOTEPAD_PLUGIN_INCLUDEDIR@)
  24. # set(NOTEPAD_PLUGIN_LIBDIR @NOTEPAD_PLUGIN_LIBDIR@)
  25. # 一些核心位置设定参考
  26. # ./usr/bin/
  27. # ./usr/bin/notepad--
  28. # ./usr/include/
  29. # ./usr/include/NotepadPlugin/
  30. # ./usr/include/NotepadPlugin/Qsci/
  31. # ./usr/include/NotepadPlugin/Qsci/...
  32. # ./usr/include/NotepadPlugin/qscint/
  33. # ./usr/include/NotepadPlugin/qscint/scintilla/src/XPM.cp
  34. # ./usr/lib/
  35. # ./usr/lib/NotepadPlugin/
  36. # ./usr/lib/NotepadPlugin/libQSci.a
  37. # ./usr/lib/cmake/
  38. # ./usr/lib/cmake/NotepadPlugin/
  39. # ./usr/lib/cmake/NotepadPlugin/NotepadPluginConfig.cmake
  40. # ^ 以此文件目录位置开始,Linux/Windows中都相同,但不是写死路径
  41. # ../ 为 /usr/lib/cmake 目录
  42. # ../../ 为 /usr/lib 目录
  43. # ../../../ 为 /usr 目录
  44. # ../../../include 为 /usr/include 目录
  45. # ../../../lib 为 /usr/lib 目录
  46. # ../../../include/NotepadPlugin # (/usr)头文件目录(NOTEPAD_PLUGIN_INCLUDEDIR)
  47. # ../../NotepadPlugin # (/usr/lib)库文件目录(NOTEPAD_PLUGIN_LIBDIR)
  48. # ../../cmake # (/usr/lib)cmake文件目录(无需关心)
  49. set(NOTEPAD_PLUGIN_INCLUDEDIR
  50. ${CMAKE_CURRENT_LIST_DIR}/../../../include/${NOTEPAD_PLUGIN}
  51. ${CMAKE_CURRENT_LIST_DIR}/../../../include/${NOTEPAD_PLUGIN}/Qsci)
  52. set(NOTEPAD_PLUGIN_LIBDIR
  53. ${CMAKE_CURRENT_LIST_DIR}/../../${NOTEPAD_PLUGIN})
  54. if(NOTEPAD_BUILD_BY_QT5)
  55. set(CMAKE_AUTOMOC ON)
  56. set(CMAKE_AUTOUIC ON)
  57. find_package(Qt5 COMPONENTS Core Widgets REQUIRED)
  58. endif(NOTEPAD_BUILD_BY_QT5)
  59. if(NOTEPAD_BUILD_BY_QT6)
  60. set(CMAKE_AUTOMOC ON)
  61. set(CMAKE_AUTOUIC ON)
  62. find_package(Qt6 COMPONENTS Core Widgets REQUIRED)
  63. endif(NOTEPAD_BUILD_BY_QT6)
  64. if(NOTEPAD_BUILD_BY_SHARED)
  65. set(NOTEPAD_IMPORTED_CORELIB_PATH ${NOTEPAD_PLUGIN_LIBDIR}/lib${NOTEPAD_PLUGIN_CORELIB}.so)
  66. add_library(${NOTEPAD_PLUGIN} SHARED IMPORTED)
  67. set_target_properties(${${NOTEPAD_PLUGIN}} PROPERTIES
  68. IMPORTED_LOCATION
  69. ${NOTEPAD_IMPORTED_CORELIB_PATH}
  70. INCLUDE_DIRECTORIES
  71. "${NOTEPAD_PLUGIN_INCLUDEDIR}"
  72. )
  73. else()
  74. set(NOTEPAD_IMPORTED_CORELIB_PATH ${NOTEPAD_PLUGIN_LIBDIR}/lib${NOTEPAD_PLUGIN_CORELIB}.a)
  75. add_library(${NOTEPAD_PLUGIN} STATIC IMPORTED)
  76. set_target_properties(${${NOTEPAD_PLUGIN}} PROPERTIES
  77. IMPORTED_LOCATION
  78. ${NOTEPAD_IMPORTED_CORELIB_PATH}
  79. INCLUDE_DIRECTORIES
  80. "${NOTEPAD_PLUGIN_INCLUDEDIR}"
  81. )
  82. endif()
  83. if(CMAKE_HOST_UNIX)
  84. # 在 Linux 中开启 compile_commands.json 文件输出,增强 clangd 能力
  85. set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
  86. endif(CMAKE_HOST_UNIX)
  87. # add_notepad_plugin(<PLUGIN_VAR> <PLUGIN_SRC> [...])
  88. # 此宏定义了,基于源代码文件构建 Notepad-- 插件时所需要的一系列流程内容
  89. macro(add_notepad_plugin PLUGIN_VAR PLUGIN_SRC)
  90. # aux_source_directory(${PLUGIN_VAR}_SOURCES ${ARGN})
  91. add_library(${PLUGIN_VAR} SHARED ${PLUGIN_SRC} ${ARGN})
  92. if(CMAKE_HOST_WIN32)
  93. # Win32 已提供宏判断
  94. # target_compile_definitions(${PLUGIN_VAR} PUBLIC NDD_EXPORT=export)
  95. endif(CMAKE_HOST_WIN32)
  96. if(CMAKE_HOST_UNIX)
  97. target_compile_definitions(${PLUGIN_VAR} PUBLIC NDD_EXPORT=export)
  98. endif(CMAKE_HOST_UNIX)
  99. # Notepad-- 插件开发时应该使用的 头文件安装目录、库文件安装目录
  100. target_include_directories(${PLUGIN_VAR} PUBLIC
  101. ${NOTEPAD_PLUGIN_INCLUDEDIR})
  102. target_link_directories(${PLUGIN_VAR} PUBLIC
  103. ${NOTEPAD_PLUGIN_LIBDIR})
  104. target_link_libraries(${PLUGIN_VAR} ${NOTEPAD_PLUGIN_CORELIB})
  105. if(NOTEPAD_BUILD_BY_QT5)
  106. target_link_libraries(${PLUGIN_VAR} Qt5::Core Qt5::Widgets)
  107. endif(NOTEPAD_BUILD_BY_QT5)
  108. if(NOTEPAD_BUILD_BY_QT6)
  109. target_link_libraries(${PLUGIN_VAR} Qt6::Core Qt6::Widgets)
  110. endif(NOTEPAD_BUILD_BY_QT6)
  111. # 这是插件实现接口中增加的 NOTEPAD_PLUGIN_MANAGER 宏开关
  112. # 来处理减少 Notepad-- 在编译时不需要,但在插件编译时所需要的模板内容
  113. target_compile_definitions(${PLUGIN_VAR} PUBLIC NOTEPAD_PLUGIN_MANAGER=)
  114. endmacro(add_notepad_plugin PLUGIN_VAR PLUGIN_SRC)
  115. # support git plugin
  116. # add_notepad_plugin_with_git <plugin_name> <git_repo_url> <plugin_sources_path>
  117. # 该宏定义了从指定的 git 仓库中获取插件源代码,并进行简单的构建
  118. macro(add_notepad_plugin_with_git PLUGIN_VAR GIT_REPO_URL GIT_REPO_PLUGIN_PATH)
  119. execute_process(COMMAND git clone ${GIT_REPO_URL} ${PLUGIN_VAR}_git
  120. WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
  121. aux_source_directory(${CMAKE_BINARY_DIR}/${PLUGIN_VAR}_git/${GIT_REPO_PLUGIN_PATH} ${PLUGIN_VAR}_RESOURCES)
  122. add_notepad_plugin(${PLUGIN_VAR} ${${PLUGIN_VAR}_RESOURCES})
  123. endmacro(add_notepad_plugin_with_git PLUGIN_VAR GIT_REPO_URL GIT_REPO_PLUGIN_PATH)
  124. message("- >>>>>>>>>>>>>>>>>> NotepadPlugin: <<<<<<<<<<<<<<<<<<")
  125. message(" - ${CMAKE_CURRENT_LIST_FILE}")
  126. message(" - ${NOTEPAD_PLUGIN_INCLUDEDIR}")
  127. message(" - ${NOTEPAD_PLUGIN_LIBDIR}")
  128. message(" - ${NOTEPAD_PLUGIN_CORELIB}")
  129. message(" - ${NOTEPAD_IMPORTED_CORELIB_PATH}")
  130. message("- >>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<")