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

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

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

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

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

 

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

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

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

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

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

生成结果如下

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

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

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

至此,基于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")

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

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

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

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

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

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

至此,插件更新完成

 

参考

《Kanzi官方文档》

上一篇:skills_linux


下一篇:skills_maven