Destroy

Destroy is the final virtual lifecycle method called on a LynxExtensionModule instance. It signals that the module is about to be permanently destroyed and all associated resources should be released.

This callback is always invoked on the BTS thread. It is guaranteed to be called after OnRuntimeDetach. This is the last opportunity to perform any cleanup for the entire module.

Method Signature

virtual void Destroy();

Usage

Override this method in your LynxExtensionModule subclass to release any global or long-lived resources that the module holds. After this method completes, the module's memory will be deallocated.

Example

#include "lynx_extension_module.h"

class MyExtensionModule : public lynx::pub::LynxExtensionModule {
private:
    SomeGlobalResource* _global_resource;

public:
    MyExtensionModule() {
        _global_resource = new SomeGlobalResource();
    }

    // Note: The virtual destructor is also a valid place for cleanup,
    // but Destroy() is the official lifecycle callback.
    ~MyExtensionModule() override = default;

    void Destroy() override {
        // This is the final cleanup point for the module.
        // It's called on the BTS thread.
        printf("MyExtensionModule: Destroying module and all global resources.\\n");

        if (_global_resource) {
            delete _global_resource;
            _global_resource = nullptr;
        }

        // It's good practice to call the base class implementation if it exists,
        // though in this case it's empty.
        // lynx::pub::LynxExtensionModule::Destroy();
    }

    // ... other lifecycle methods
};

Lifecycle Sequence

The Destroy method is the last step in the module's teardown process:

OnLynxViewDestroy (UI Thread)
OnRuntimeDetach (BTS Thread)
Destroy (BTS Thread)
The MyExtensionModule object is deleted.

Compatibility

LCD tables only load in the browser

#Destroy

#Method Signature

#Usage

#Example

#Lifecycle Sequence

#See Also