【MSVC】深度解析ChromiumBase库

Chromium的Base库是Chromium项目中的一个重要公共库，提供了线程、文件、时间、内存、字符串和进程等基础操作。本文详细介绍了如何将Chromium的Base库集成到自己的项目中，并特别针对MSVC编译环境进行了说明。需要注意的是，Chromium的Base库从78大版本开始不再支持MSVC编译，因此本文基于77大版本的最后一个子版本（Tag=77.0.3865.129）进行提取和演示。文章还提供了在Windows平台上使用Microsoft Visual C++ 2022进行编译的具体步骤和示例代码，涵盖了基本线程、异步任务和线程池的测试，旨在帮助以VS为主的C++开发者更好地理解和应用Base库。

前言：项目开源地址在Github上，欢迎大家多多支持，感谢！

介绍：Chromium的Base库是Chromium项目中一个公共库，包含了许多实用的基础操作，如线程、文件、时间、内存、字符串、进程等。本文旨在介绍如何将Chromium的Base库集成到自己的项目中，并支持MSVC编译。值得注意的是，Chromium的Base库从78大版本开始不再支持MSVC编译（具体查看tag=78.0.3905.58中的compiler_specific.h文件，line=12）。因此，本次提取基于Tag=77.0.3865.129，即77大版本的最后一个子版本，发布于2019年10月18日。

支持平台：主要针对Windows（其他平台理论上也可行）

软件需求：

• Microsoft Visual C++ 2022（64位）版本 17.8.4
• Windows SDK版本：10.0.22621.0
• 平台工具集：v143
• C++语言标准：ISO C++17标准（/std:c++17）
• 编译工具：MSVC 1938版本

使用步骤：

1. 首先，打开Project中的Base.sln文件，编译Base库的dll或lib文件。
2. 然后，打开Project中的Project.sln文件，测试是否能正常使用Base.dll和Base_static.lib。

示例代码片段：

基本线程测试代码语言：C++

{
    base::Thread* a = new base::Thread("StartNonJoinable");
    // 非可连接线程目前必须泄漏（参见 Thread::Options::joinable 的详细信息）。
    base::Thread::Options options;
    options.joinable = false;
    a->StartWithOptions(options);
    //L_TRACE(L"%s IsRunning=[%d]", __FUNCTIONW__, a->IsRunning());
    // 如果没有这个调用，这个测试就会有竞态条件。上面的 IsRunning() 成功是因为在 Start() 和 StopSoon() 之间有一个提前返回的条件，
    // 在调用 StopSoon() 之后，这个提前返回的条件不再满足，必须检查真正的 |is_running_| 位。
    // 如果消息循环实际上还没有真正启动，它仍然可能为 false。
    // 这只是这个测试的要求，因为非可连接属性强制它使用 StopSoon() 而不是等待完全的 Stop()。
    a->WaitUntilThreadStarted();
    // Make the thread block until |block_event| is signaled.
    base::WaitableEvent block_event(
        base::WaitableEvent::ResetPolicy::AUTOMATIC,
        base::WaitableEvent::InitialState::NOT_SIGNALED);
    // 卡住这个线程
    a->task_runner()->PostTask(FROM_HERE,
        base::BindOnce(&base::WaitableEvent::Wait,
            base::Unretained(&block_event)));
    // 在调用 StopSoon() 之后，这个提前返回的条件不再满足，必须检查真正的 | is_running_ | 位。
    a->StopSoon();
    //L_TRACE(L"%s IsRunning=[%d]", __FUNCTIONW__, a->IsRunning());
    // 解除任务的阻塞，并给予一些额外的时间来解开 QuitWhenIdle()。
    block_event.Signal();
    base::PlatformThread::Sleep(base::TimeDelta::FromMilliseconds(20));
    // 线程现在应该已经自行停止。
    //L_TRACE(L"%s IsRunning=[%d]", __FUNCTIONW__, a->IsRunning());
}

测试异步任务代码语言：C++

{
    std::string str = "fff123123123";
    base::Thread a(str);
    // 线程未启动，无影响，不执行任何操作
    a.FlushForTesting();
    a.Start();
    // 线程无Task，无影响，不执行任何操作
    a.FlushForTesting();
    constexpr base::TimeDelta kSleepPerTestTask =
        base::TimeDelta::FromMilliseconds(50);
    constexpr size_t kNumSleepTasks = 5;
    const base::TimeTicks ticks_before_post = base::TimeTicks::Now();
    for (size_t i = 0; i < kNumSleepTasks; ++i) {
        a.task_runner()->PostTask(
            FROM_HERE,
            base::BindOnce(&base::PlatformThread::Sleep, kSleepPerTestTask));
    }
    // 会阻塞，等待线程中所有Task完成
    a.FlushForTesting();
    a.Stop();
    // 线程已停止，无影响，不执行任何操作
    a.FlushForTesting();
}

测试线程池代码语言：C++

{
    // 测试ThreadPoolImpl
    int max_num_foreground_threads = kMaxNumForegroundThreads;
    base::ThreadPoolInstance::InitParams init_params(max_num_foreground_threads);
    std::unique_ptr<base::internal::ThreadPoolImpl> thread_pool_ = std::make_unique<base::internal::ThreadPoolImpl>("Test Thread Pool");
    // Register a worker thread observer.
    MyObserver observer;
    thread_pool_->Start(init_params, &observer);
    base::TaskTraits traits;
    for (int i = 0; i < 5; ++i) {
        thread_pool_->PostDelayedTask(FROM_HERE, traits, base::BindOnce(static_cast<void(*)(
            const base::TimeDelta&)>(&base::PlatformThread::Sleep),
            base::TimeDelta::FromMilliseconds(20)), base::TimeDelta::FromMilliseconds(20));
    }
    //L_TRACE(L"%s", __FUNCTIONW__);
    thread_pool_->FlushForTesting();
    thread_pool_->JoinForTesting();
    //L_TRACE(L"%s", __FUNCTIONW__);
}

优点：

1. 对以VS为主的C++开发者非常友好。
2. 去除了Chromium中代码冗余的问题，可以独立使用和学习。
3. 支持Debug和Release模式。
4. 支持动态库和静态链接。
5. 不需要使用ninja来编译。

注意事项：

1. 使用最新的VS和MSVC即可编译，理论上是向前兼容的。
2. demo中主要针对Base库的线程、线程池、异步任务做了简单的代码示例，还有其他很多模块可自行探索。

如果您对这个项目感兴趣或者觉得有用，请Star一下，谢谢?

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。