04 vSomeIP核心对象：Runtime与Application的创建与生命周期

⭐Runtime单例与Application生命周期：从启动到停止的工程链路

在vSomeIP框架开发中，Runtime（运行时）与Application（应用）是所有通信服务的基石。初学者最容易犯的错误是将两者混为一谈，或忽略其严格的单例与生命周期约束。本节的核心目标是：掌握Runtime单例模式的获取方式，以及Application从创建、启动到停止的完整流程，并能在调试阶段通过交付物验证每一步的正确性

⭐vSomeIP核心对象

vSomeIP框架采用单例模式管理Runtime，这意味着整个进程中只能存在一个Runtime（vSomeIP Runtime）实例。如果多次调用Runtime::get()，返回的始终是同一个对象。这种设计是为了统一管理内部线程池、路由表和配置加载。而Application（vSomeIP Application）则代表一个具体的服务节点，每个Application拥有独立的服务ID、实例ID和事件组。在实际项目中，一个进程可能包含多个Application，但Runtime只有一个

工程中常见的错误包括：在未初始化Runtime的情况下直接创建Application，或在Application停止后未释放资源就尝试重启。这些问题的根源在于对生命周期边界认知不清。本节的目标就是通过明确的启动/停止流程，消除这类隐患

💻对象配置与验证链路：Runtime单例获取与Application启停

Runtime单例的获取与交付物

获取Runtime的唯一方式是调用静态方法Runtime::get()。该方法的实现内部使用了线程安全的双重检查锁定（Double-Checked Locking），确保多线程环境下也只会构造一次。调用后返回的std::shared_ptr<Runtime>即为Runtime交付物，它持有全局配置（如网络端点、日志级别）和内部调度器

// 获取Runtime单例
std::shared_ptr<vsomeip::Runtime> runtime = vsomeip::Runtime::get();
if (!runtime) {
    // 处理获取失败的情况，通常是因为配置加载异常
    错误<< "Runtime获取失败，请检查vsomeip.json配置路径";
    return -1;
}

这段配置属于“问题代码/原始配置”，核对键名、默认值、取值范围和修改后影响的行为。

关键字段说明：Runtime::get()的返回值必须判空，因为当配置文件缺失或格式错误时，Runtime可能构造失败。交付物runtime对象在进程生命周期内有效，不应手动释放

Application的创建、启动与停止

通过Runtime创建Application的接口为runtime->createApplication("app_name")，参数为应用名称，用于日志和调试标识。创建后，Application处于“未初始化”状态，必须调用app->init()完成配置加载和服务注册，再调用app->start()进入事件循环。停止时，应调用app->stop()，而非直接销毁对象

// 创建并启动Application
std::shared_ptr<vsomeip::Application> app = runtime->createApplication("my_service");
if (!app->init()) {
    错误 << "Application初始化失败，请检查服务配置";
    return -1;
}
app->start(); // 阻塞调用，内部启动IO线程
// 停止Application（通常在信号处理或析构时调用）
app->stop()

这段配置属于“推荐实现/重构后接口”，核对键名、默认值、取值范围和修改后影响的行为。

验证信号：app->init()返回true表示配置加载成功，app->start()后日志应输出Application my_service is running。停止后，可通过app->is_running()确认状态