
前言:项目开源地址在Github上,欢迎大家多多支持,感谢!
介绍:Chromium的Base库是Chromium项目中一个公共库,包含了许多实用的基础操作,如线程、文件、时间、内存、字符串、进程等。本文旨在介绍如何将Chromium的Base库集成到自己的项目中,并支持MSVC编译。值得注意的是,Chromium的Base库从78大版本开始不再支持MSVC编译(具体查看tag=78.0.3905.58中的c++ompiler_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版本
使用步骤:
- 首先,打开Project中的Base.sln文件,编译Base库的dll或lib文件。
- 然后,打开Project中的Project.sln文件,测试是否能正常使用Base.dll和Base_static.lib。
示例代码片段:
基本线程测试代码语言:C++
phpMyAdmin是一个以PHP为基础,以Web-Base方式架构在网站主机上的MySQL的资料库管理工具。phpMyAdmin可以管理整个MySQL服务器(需要超级用户),也可以管理单个数据库。
{
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 thread_pool_ = std::make_unique("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(&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__);
} 优点:
- 对以VS为主的C++开发者非常友好。
- 去除了Chromium中代码冗余的问题,可以独立使用和学习。
- 支持Debug和Release模式。
- 支持动态库和静态链接。
- 不需要使用ninja来编译。
注意事项:
- 使用最新的VS和MSVC即可编译,理论上是向前兼容的。
- demo中主要针对Base库的线程、线程池、异步任务做了简单的代码示例,还有其他很多模块可自行探索。
如果您对这个项目感兴趣或者觉得有用,请Star一下,谢谢?









