pluginspec.h 中所有公共函数的主要作用

// 插件名字。当状态达到 PluginSpec::Read 时才可用。
QString name() const;
// 插件版本。当状态达到 PluginSpec::Read 时才可用。
QString version() const;
// 插件兼容版本。当状态达到 PluginSpec::Read 时才可用。
QString compatVersion() const;
// 插件提供者。当状态达到 PluginSpec::Read 时才可用。
QString vendor() const;
// 插件版权。当状态达到 PluginSpec::Read 时才可用。
QString copyright() const;
// 插件协议。当状态达到 PluginSpec::Read 时才可用。
QString license() const;
// 插件描述。当状态达到 PluginSpec::Read 时才可用。
QString description() const;
// 插件主页 URL。当状态达到 PluginSpec::Read 时才可用。
QString url() const;
// 插件类别，用于在界面分组显示插件信息。如果插件不属于任何类别，直接返回空字符串。
QString category() const;
// 插件兼容的平台版本的正则表达式。如果兼容所有平台，则返回空。
QRegExp platformSpecification() const;
// 对于宿主平台是否可用。该函数用使用 platformSpecification() 的返回值对平台名字进行匹配。
bool isAvailableForHostPlatform() const;
// 是否必须。
bool isRequired() const;
// 是否实验性质的插件。
bool isExperimental() const;
// 默认启用。实验性质的插件可能会被禁用。
bool isEnabledByDefault() const;
// 因配置信息启动。
bool isEnabledBySettings() const;
// 是否在启动时已经加载。
bool isEffectivelyEnabled() const;
// 因为用户取消或者因其依赖项被取消而导致该插件无法加载时，返回 true。
bool isEnabledIndirectly() const;
// 是否通过命令行参数 -load 加载。
bool isForceEnabled() const;
// 是否通过命令行参数 -noload 禁用。
bool isForceDisabled() const;
// 插件依赖列表。当状态达到 PluginSpec::Read 时才可用。
QVector dependencies() const;

typedef QVector PluginArgumentDescriptions;
// 插件处理的命令行参数描述符列表。
PluginArgumentDescriptions argumentDescriptions() const;

// 其它信息，当状态达到 PluginSpec::Read 时才可用。
// 该 PluginSpec 实例对应的插件 XML 描述文件所在目录的绝对位置。
QString location() const;
// 该 PluginSpec 实例对应的插件 XML 描述文件的绝对位置（包含文件名）。
QString filePath() const;

// 插件命令行参数。启动时设置。
QStringList arguments() const;
// 设置插件命令行参数为 arguments。
void setArguments(const QStringList &arguments);
// 将 argument 添加到插件的命令行参数。
void addArgument(const QString &argument);

// 当一个依赖需要插件名为 pluginName、版本为 version 时，返回该插件是否满足。
bool provides(const QString &pluginName, const QString &version) const;

// 插件的依赖。当状态达到 PluginSpec::Resolved 时才可用。
QHash<PluginDependency, PluginSpec *> dependencySpecs() const;
// 否则依赖 plugins 集合中的任一插件。
bool requiresAny(const QSet &plugins) const;

// PluginSpec 实例对应的 IPlugin 实例。当状态达到 PluginSpec::Loaded 时才可用。
IPlugin *plugin() const;

// 当前状态。
State state() const;
// 是否发生错误。
bool hasError() const;
// 错误信息。
QString errorString() const;