Library

Wrapper for dynamically loaded modules.

Wrapper for dynamically loaded modules. Loads a module from a shared library and manages its lifecycle. Supports hot-reloading: when the library file changes, the module can be unloaded and reloaded without restarting the application.

The dynamic library must export:

• A creation function (default: "helios_create_module") that returns Module*
• A module ID function (default: "helios_module_id") that returns ModuleTypeId
• A module name function (default: "helios_module_name") that returns const char*

Note

Not thread-safe. External synchronization required for concurrent access.

implementation:

// In my_module.cpp (compiled as shared library)
class MyModule : public helios::app::Module {
public:
  static constexpr std::string_view GetName() noexcept { return "MyModule"; }
  void Build(App& app) override { ... }
  void Destroy(App& app) override { ... }
};
 
extern "C" {
  HELIOS_EXPORT helios::app::Module* helios_create_module() {
    return new MyModule();
  }
  HELIOS_EXPORT helios::app::ModuleTypeId helios_module_id() {
    return helios::app::ModuleTypeIdOf<MyModule>();
  }
  HELIOS_EXPORT const char* helios_module_name() {
    return "MyModule";
  }
}