Changeset 5626 for code/branches/libraries/cmake

Timestamp:

Aug 11, 2009, 10:22:55 PM (15 years ago)

Author:

landauf

Message:

Added a dynamic library loader (more or less a copy of Ogre::DynLibManager but with some adjustments for Orxonox). This allows us to load plugins at runtime. Plugin-libraries must be declared with the "PLUGIN" switch in ORXONOX_ADD_LIBRARY in CMake.

Location:

code/branches/libraries/cmake

Files:

• BuildConfig.cmake (modified) (1 diff)
• TargetUtilities.cmake (modified) (6 diffs)

code/branches/libraries/cmake/BuildConfig.cmake

@@ -172 +172 @@
 # when building, don't use the install RPATH already
 # (but later on when installing)
-SET(CMAKE_BUILD_WITH_INSTALL_RPATH FALSE) 
+SET(CMAKE_BUILD_WITH_INSTALL_RPATH FALSE)
 
 # the RPATH to be used when installing

code/branches/libraries/cmake/TargetUtilities.cmake

@@ -35 +35 @@
  #      NO_SOURCE_GROUPS:  Don't create msvc source groups
  #      STATIC/SHARED:     Inherited from ADD_LIBRARY
+ #      PLUGIN:            For dynamic plugin libraries
  #      WIN32:             Inherited from ADD_EXECUTABLE
  #      PCH_NO_DEFAULT:    Do not make precompiled header files default if
@@ -80 +81 @@
   SET(_switches   FIND_HEADER_FILES  EXCLUDE_FROM_ALL  ORXONOX_EXTERNAL
                   NO_DLL_INTERFACE   NO_SOURCE_GROUPS  ${_additional_switches}
-                  PCH_NO_DEFAULT NO_INSTALL)
+                  PCH_NO_DEFAULT     NO_INSTALL        PLUGIN)
   SET(_list_names LINK_LIBRARIES  VERSION   SOURCE_FILES  DEFINE_SYMBOL
                   TOLUA_FILES     PCH_FILE  PCH_EXCLUDE OUTPUT_NAME)
@@ -147 +148 @@
   ENDIF()
 
+  # PLUGIN A
+  IF(_arg_PLUGIN)
+    SET(_arg_PLUGIN MODULE)
+    SET(_arg_SHARED)
+    SET(_arg_STATIC)
+  ENDIF()
+
   # Add the library/executable
   IF("${_target_type}" STREQUAL "LIBRARY")
-    ADD_LIBRARY(${_target_name} ${_arg_STATIC} ${_arg_SHARED}
+    ADD_LIBRARY(${_target_name} ${_arg_STATIC} ${_arg_SHARED} ${_arg_PLUGIN}
                 ${_arg_EXCLUDE_FROM_ALL} ${_${_target_name}_files})
   ELSE()
     ADD_EXECUTABLE(${_target_name} ${_arg_WIN32} ${_arg_EXCLUDE_FROM_ALL}
                    ${_${_target_name}_files})
+  ENDIF()
+
+  # PLUGIN B
+  IF (_arg_PLUGIN)
+    SET_TARGET_PROPERTIES(${_target_name} PROPERTIES LIBRARY_OUTPUT_DIRECTORY ${CMAKE_PLUGIN_OUTPUT_DIRECTORY})
+    SET_TARGET_PROPERTIES(${_target_name} PROPERTIES RUNTIME_OUTPUT_DIRECTORY ${CMAKE_PLUGIN_OUTPUT_DIRECTORY})
+    ADD_PLUGIN(${_target_name})
   ENDIF()
 
@@ -174 +189 @@
 
   # OUTPUT_NAME
-  IF(_arg_OUTPUT_NAME )
+  IF(_arg_OUTPUT_NAME)
     SET_TARGET_PROPERTIES(${_target_name} PROPERTIES OUTPUT_NAME  ${_arg_OUTPUT_NAME})
   ENDIF()
@@ -184 +199 @@
 
   IF(NOT _arg_STATIC AND NOT _arg_NO_INSTALL)
+    SET(_library_destination ${ORXONOX_LIBRARY_INSTALL_PATH})
+    IF (_arg_PLUGIN)
+      SET(_library_destination ${ORXONOX_PLUGIN_INSTALL_PATH})
+    ENDIF()
+
     INSTALL(TARGETS ${_target_name}
       RUNTIME DESTINATION ${ORXONOX_RUNTIME_INSTALL_PATH}
-      LIBRARY DESTINATION ${ORXONOX_LIBRARY_INSTALL_PATH}
+      LIBRARY DESTINATION ${_library_destination}
       #ARCHIVE DESTINATION ${ORXONOX_ARCHIVE_INSTALL_PATH}
     )
@@ -192 +212 @@
 
 ENDFUNCTION(TU_ADD_TARGET)
+
+
+# Creates a helper file with name <name_of_the_library>.plugin
+# This helps finding dynamically loadable plugins at runtime
+
+FUNCTION(ADD_PLUGIN _name)
+  # We use the properties to get the name because the librarys name may differ from
+  # the targets name (for example orxonox <-> liborxonox)
+
+  GET_TARGET_PROPERTY(_target_loc ${_name} LOCATION)
+  GET_FILENAME_COMPONENT(_target_name ${_target_loc} NAME_WE)
+
+  SET(_plugin_filename "${CMAKE_PLUGIN_OUTPUT_DIRECTORY}/${_target_name}.plugin")
+
+  FILE(WRITE ${_plugin_filename})
+
+  INSTALL(
+    FILES ${_plugin_filename}
+    DESTINATION ${ORXONOX_PLUGIN_INSTALL_PATH}
+  )
+ENDFUNCTION(ADD_PLUGIN)