12、Kanzi插件——创建Kanzi Engine插件的方法

可以使用模板自动创建Kanzi Engine插件

模板选为含有Kanzi Engine插件的应用

注意：工程名不能叫plugin，因为VS工程会根据该工程名设置定义具体的类，如果命名为plugin，那么会和kanzi中自带的Plugin命名冲突，导致VS工程无法编译通过

 

创建完工程之后，可以到下图中的路径看下生成的VS工程

其中，kanzi engine插件的工程名为plugindemo（用来创建插件），C++应用程序的工程是plugindemo_executable（在该工程中构建应用程序的逻辑）

一般kanzi engine插件最后生成的是一个dll文件。需要配置DLL解决方案，调试阶段，选择debug_dll即可

生成结果如下

注意：kanzi studio和VS不能同时打开，当Kanzi studio打开时，会加载对应插件，因此会使用dll，如果此时用VS重新编译生成插件的dll，因为dll正在被kanzi studio使用，所以会出现无法访问路径中的文件的错误，如下图

至此，基于Kanzi studio模板自动创建Kanzi Engine插件的流程结束

 

2、如何更新插件

当插件中的元数据有变化时，更新插件会出现元数据变更的提示

示例

//plugindemo.hpp
class PLUGINDEMO_API Plugindemo : public kanzi::Node3D
{
public:

    KZ_METACLASS_BEGIN(Plugindemo, Node3D, "CustomComponentType")
    KZ_METACLASS_END()

    // Creates a Plugindemo.
    static PlugindemoSharedPtr create(kanzi::Domain* domain, kanzi::string_view name);

protected:

    // Constructor.
    explicit Plugindemo(kanzi::Domain* domain, kanzi::string_view name):
        kanzi::Node3D(domain, name)
    {
    }

    // Initializes the created Kanzi Engine plugin.
    // Kanzi node classes typically have a static create() member function, which creates the instance of a node,
    // initializes it, and returns a shared pointer to the instance. To initialize the instance, the initialize()
    // function is called on it. You must initialize a node in the initialize() function, not in the constructor.
    void initialize();
};

比如更改上述代码中的最后一个参数

KZ_METACLASS_BEGIN(Plugindemo, Node3D, "qweasdzxc")

此时重新编译，然后更新插件，更新插件操作如下图

更新时，就会出现如下提示，点击确定即可

更新完之后，再添加3d节点时节点的名字如下图

至此，插件更新完成

 

参考

《Kanzi官方文档》