关于“开发者社区”中“任务栏插件”文档的错误- Community

关于“开发者社区”中“任务栏插件”文档的错误

Apps Section 1224 views · 8 replies ·

176******11

deepin

2018-01-08 02:27

Author

今天想写一个dde dock的插件，然后按照官方的插件开发文档和样例，发现完全无法使用，经过对比官方插件代码和dde-dock启动日志，存在以下问题：

json文件内需要添加api字段，官方曾经发帖指出，但不知为何一直不更新文档，
demo中HelloWorldPlugin类中方法const QString itemCommand(const QString &itemKey) override;未实现，导致加载出错，严重怀疑这个demo压根没经过测试就直接扔上来了
文档中并没有说明插件的大小如何控制，导致样例运行后特别宽，尝试多次后发现是由QWidget *itemWidget(const QString &itemKey);方法返回的QWidget的sizeHint决定的。这个属性不受resize控制，只能通过继承重写，估计是使用了布局。
代码中不存在任何注释。个人认为作为一个样例，必要添加注释说明，即使有额外的文档，或者请把pdf文档附加到代码文件中。
虽然很明显插件是通过Qt的插件机制使用的，但在官方的文档中并没有对此有任何提及，也没有对相关的代码做解释，如json文件的作用等等，如果是一个未接触过Qt插件机制的开发者，根本不知道该去何处了解。我认为很有必要提一下诸如“使用了Qt插件机制，相关知识请查阅相关文档”的提示。