Visindigo::General::VIApplication Class

#include <General/VIApplication.h>
#include "MyApplicationMainClass.h"
int main(int argc, char* argv[]) {
        VIAppStatic::setEnvConfig(...); // 可选，如果需要变更相关配置

        Visindigo::General::VIApplication app(argc, argv, Visindigo::General::VIApplication::WidgetApp); // 以Widget为例
        app.setMainPlugin(new MyApplicationMainClass()); // 设置作为主插件的类
        app.setLoadingMessageHandler(new MyLoadingMessageHandlerClass()); // 可选，设置加载消息处理器
        int c = app.start(); // 启动应用程序
        return c;
}

成员函数文档

[since Visindigo 0.13.0] VIApplication::VIApplication(int &argc, char **argv, Visindigo::General::VIApplication::AppType appType = WidgetApp, bool changeWorkingDirToExeDir = true)

创建VIApplication类的新实例。 argc 和 argv 参数与Qt的QCoreApplication、QGuiApplication和QApplication类的构造函数参数相同。 appType 参数指定应用程序的类型，默认为WidgetApp。 changeWorkingDirToExeDir 参数指定是否将当前工作目录更改为可执行文件所在目录，默认为true。

这个function 从 Visindigo 0.13.0 开始支持。

[noexcept, since Visindigo 0.13.0] VIApplication::~VIApplication()

销毁VIApplication实例并释放相关资源。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void VIApplication::addDependencyPlugin(Visindigo::General::Plugin *plugin)

添加一个依赖插件。 plugin 指向依赖插件对象的指针。依赖插件必须继承自Visindigo::General::Plugin类。 依赖插件是主插件依赖的插件，VIApplication会在启动过程中先加载并启用这些依赖插件，然后再加载和启用主插件。 必须在调用start()函数之前添加依赖插件，如果在应用程序已经启动后调用此函数，将不会生效。 注意，添加依赖插件并不会自动将它们添加到主插件的依赖列表中，用户需要手动在主插件中调用Plugin::addDependency()函数来添加这些依赖关系。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] bool VIApplication::applicationStarted() const

检查应用程序是否已经启动。 return 为true表示应用程序已经启动，false表示尚未启动。

此函数允许用户检查应用程序的启动状态。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] QList<Visindigo::General::Plugin *> VIApplication::getDependencyPlugins() const

return 当前设置的全部依赖插件对象的指针列表。 如果尚未添加任何依赖插件，则返回一个空列表。

这个function 从 Visindigo 0.13.0 开始支持。

[static, since Visindigo 0.13.0] QVariant VIApplication::getEnvConfig(Visindigo::General::VIApplication::EnvKey key)

return 应用程序的环境配置参数。 key 环境配置键，参见EnvKey枚举。 return 为对应的环境配置值，类型为QVariant。如果键不存在，则返回一个默认构造的QVariant对象。

此函数允许用户获取应用程序的环境配置参数，如日志文件路径、插件文件路径等。

这个function 从 Visindigo 0.13.0 开始支持。

[static, since Visindigo 0.13.0] Visindigo::General::VIApplication *VIApplication::getInstance()

return VIApplication单例对象的指针。 虽然VIApplication是一个单例类，但此函数不会在实例不存在时创建它。请确保在调用此函数前已正确初始化VIApplication。

这是Visindigo单例类getInstance()函数的一个特例。其他单例类的getInstance()函数均会在实例不存在时创建它们。请注意区分。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] Visindigo::General::Plugin *VIApplication::getMainPlugin() const

return 当前设置的主插件对象的指针。 如果尚未设置主插件，则返回nullptr。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] Visindigo::Widgets::Terminal *VIApplication::getVirtualTerminal() const

return 应用程序的虚拟终端窗口。 return 为指向虚拟终端窗口对象的指针。如果未启用虚拟终端功能，则返回nullptr。 此函数允许用户获取应用程序的虚拟终端窗口，以便在其中执行命令行操作。

这个function 从 Visindigo 0.13.0 开始支持。

[static, since Visindigo 0.15.0] bool VIApplication::isWindows11()

return 系统是否为Windows11。

这个function 从 Visindigo 0.15.0 开始支持。

[static, since Visindigo 0.15.0] bool VIApplication::isWindows()

return 系统是否为Windows。

这个function 从 Visindigo 0.15.0 开始支持。

[since Visindigo 0.13.0] void VIApplication::onException(const Visindigo::General::Exception &ex)

处理应用程序运行过程中捕获的异常。 ex 捕获的异常对象。

此函数由VIApplication内部调用，用于处理在应用程序运行过程中捕获的异常。 如果设置了异常消息处理器，将会调用其相关函数来处理异常消息。 如果异常是严重的且应用程序已经启动，将会退出应用程序。

如果用户有需要，也可以手动塞入一个异常对象来调用此函数，以便使用VIApplication的异常处理机制。

这个function 从 Visindigo 0.13.0 开始支持。

[static, since Visindigo 0.13.0] void VIApplication::setEnvConfig(Visindigo::General::VIApplication::EnvKey key, const QVariant &value)

设置应用程序的环境配置参数。 key 环境配置键，参见EnvKey枚举。 value 环境配置值，类型为QVariant。

此函数允许用户自定义应用程序的环境配置参数，如日志文件路径、插件文件路径等。 必须在创建VIApplication实例之前调用此函数，否则可能无法生效。

实际上在启动程序之后仍然会正确保存这些配置，但某些功能在启动后不会重新应用新的配置。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void VIApplication::setExceptionMessageHandler(Visindigo::General::ApplicationExceptionMessageHandler *handler)

设置应用程序的异常消息处理器。 handler 指向异常消息处理器对象的指针。异常消息处理器必须继承自Visindigo::General::ApplicationExceptionMessageHandler类。

异常消息处理器用于处理应用程序在运行过程中捕获的异常消息，例如在GUI界面中显示异常信息对话框等。 必须在调用start()函数之前设置异常消息处理器，如果在应用程序已经启动后调用此函数，将不会生效。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void VIApplication::setGlobalFont(const QString &fontPath, int fontID = 0)

设置应用程序的全局字体。 fontPath 字体文件的路径。 fontID 字体文件中字体的索引，默认为0。

此函数允许用户为整个应用程序设置统一的字体。字体文件可以是TTF、OTF等常见字体格式。 如果加载字体失败，将会抛出异常。

这是一个对Qt字体加载的简单封装。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void VIApplication::setLoadingMessageHandler(Visindigo::General::ApplicationLoadingMessageHandler *handler)

设置应用程序的加载消息处理器。 handler 指向加载消息处理器对象的指针。加载消息处理器必须继承自Visindigo::General::ApplicationLoadingMessageHandler类。

加载消息处理器用于处理应用程序在启动过程中产生的加载消息，例如在GUI界面中或在控制台中显示加载进度等。 必须在调用start()函数之前设置加载消息处理器，如果在应用程序已经启动后调用此函数，将不会生效。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] void VIApplication::setMainPlugin(Visindigo::General::Plugin *plugin)

设置应用程序的主插件。 plugin 指向主插件对象的指针。主插件必须继承自Visindigo::General::Plugin类。

主插件是应用程序的核心逻辑所在，VIApplication会在启动过程中调用主插件的相关函数以初始化应用程序。 必须在调用start()函数之前设置主插件，如果在应用程序已经启动后调用此函数，将不会生效。

Visindigo不允许用户不使用主插件，因为部分程序配置和功能是通过主插件来实现的， 如果没有主插件，应用程序将无法正常运行。所以，也不建议在main函数中额外编写其他涉及 资源加载或初始化的代码，应该把这些逻辑放在主插件中实现，避免破坏逻辑封装。

这个function 从 Visindigo 0.13.0 开始支持。

[since Visindigo 0.13.0] int VIApplication::start()

启动应用程序的主事件循环。 此函数会加载并启用所有插件，初始化应用程序，并进入主事件循环。 return 为应用程序退出时的返回码。

在调用此函数之前，应该先设置主插件和加载消息处理器（如果有的话）。 如果应用程序已经启动，将会抛出异常。

此函数是VIApplication类的核心功能，负责管理应用程序的生命周期。

这个function 从 Visindigo 0.13.0 开始支持。