3. 开发环境搭建：Ubuntu 22.04 + GCC/CMake + Wireshark + vSOMEIP库的安装与验证

好，咱们正式开始动手了。这一章我带你搭一套完整的开发环境。说白了，就是给你的电脑装上「武器」，后面写代码、抓包、调试全得靠它。

我个人习惯用 Ubuntu 22.04 LTS，稳定，社区活跃，踩坑了也好搜答案。你如果用的是其他 Linux 发行版，原理一样，包管理器换一下就行。

3.1 为什么选这套组合？

先聊聊我的选择逻辑。你想想看，做 SOME/IP 协议栈开发，你需要什么？

  • 操作系统：Ubuntu 22.04 LTS。我在项目里踩过 20.04 的坑，有些库版本太老，编译 vSOMEIP 得折腾半天。22.04 的 GCC 11 和 CMake 3.22 刚刚好，省心。
  • 编译器与构建工具：GCC + CMake。GCC 是 Linux 下的标配，CMake 管理跨平台项目。我建议你直接用 CMake，别手写 Makefile，后面加模块、调参数会方便很多。
  • 抓包工具：Wireshark。SOME/IP 的调试，一半时间在看日志，另一半时间在看报文。Wireshark 能解析 SOME/IP 协议，一眼看出问题在哪。
  • 协议栈库：vSOMEIP。这是 GENIVI 开源的 SOME/IP 实现，成熟、文档全。我自己做项目时也拿它当底层，省去重复造轮子的时间。

核心思路：这套环境不是随便凑的。每个工具都经过项目验证，能覆盖从编码、编译、运行到抓包分析的全流程。

3.2 安装 Ubuntu 22.04 LTS

如果你已经有 Ubuntu 22.04 了，直接跳过这节。没有的话，我推荐两种方式：

  • 物理机安装：性能最好，适合长期开发。去官网下载 ISO，用 Rufus 或 balenaEtcher 做启动盘。
  • 虚拟机安装：用 VirtualBox 或 VMware。我刚开始学 SOME/IP 时就用虚拟机，快照一打，随便折腾，坏了恢复就行。

安装时注意两点：

  1. 磁盘分区建议给 40GB 以上，后面装库、编译代码、存抓包文件，空间很快就用掉了。
  2. 网络选桥接模式（虚拟机的话），方便后面用 Wireshark 抓宿主机和虚拟机之间的 SOME/IP 报文。

小技巧：装完系统第一件事，跑 sudo apt update && sudo apt upgrade -y。把源更新到最新，避免后面装库时出现依赖冲突。

3.3 安装 GCC 和 CMake

Ubuntu 22.04 默认带了 GCC 11，但 CMake 可能不是最新版。咱们手动确认一下。

# 检查 GCC 版本
gcc --version
# 输出应该类似：gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0

# 安装 CMake（如果没装）
sudo apt install cmake -y
cmake --version
# 输出应该类似：cmake version 3.22.1

嗯，这里要注意。如果你发现 GCC 版本低于 10，或者 CMake 低于 3.20，编译 vSOMEIP 时可能会报错。我曾经在 Ubuntu 20.04 上遇到过 CMake 3.16 不支持某些特性，折腾了一下午才搞定。所以，版本不对就升级：

# 升级 GCC（如果需要）
sudo apt install gcc-11 g++-11 -y
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 100

# 升级 CMake（从源码安装）
wget https://github.com/Kitware/CMake/releases/download/v3.28.0/cmake-3.28.0.tar.gz
tar -xzf cmake-3.28.0.tar.gz
cd cmake-3.28.0
./bootstrap && make && sudo make install

避坑指南：我曾经在升级 CMake 时忘了卸载旧版，结果系统里同时存在两个版本，编译时链接错了库。建议先 sudo apt remove cmake 再装新版。

3.4 安装 Wireshark

Wireshark 是咱们的「眼睛」。SOME/IP 报文长什么样，服务发现怎么交互，全靠它看。

sudo apt install wireshark -y

安装过程中会弹出一个对话框，问你是否允许非 root 用户抓包。我建议选「是」，这样你就不用每次开 Wireshark 都加 sudo 了。

装完后，把当前用户加入 wireshark 组：

sudo usermod -aG wireshark $USER
# 然后注销重新登录，或者直接重启

验证一下：打开 Wireshark，在过滤栏输入 someip，如果能看到 SOME/IP 的过滤选项，说明装好了。

个人经验：我习惯在 Wireshark 里同时开两个过滤条件：someip 和 someip-sd。前者看所有 SOME/IP 报文，后者只看服务发现（Service Discovery）的交互，调试时特别有用。

3.5 安装 vSOMEIP 库

vSOMEIP 是咱们的核心依赖。它提供了 SOME/IP 协议的完整实现，包括序列化、反序列化、服务发现、远程调用等。咱们不需要从零写协议栈，直接用它就行。

3.5.1 安装依赖库

vSOMEIP 依赖 Boost 和 Google Test。先装好它们：

sudo apt install libboost-system-dev libboost-thread-dev libboost-log-dev -y
sudo apt install libgtest-dev -y

Boost 的版本要注意。vSOMEIP 要求 Boost 1.55 以上，Ubuntu 22.04 自带的是 1.74，完全够用。

3.5.2 下载并编译 vSOMEIP

# 克隆源码
git clone https://github.com/COVESA/vsomeip.git
cd vsomeip

# 创建构建目录
mkdir build
cd build

# 配置 CMake
cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..

# 编译
make -j$(nproc)

# 安装
sudo make install

编译过程大概 5-10 分钟，取决于你的机器性能。如果一切顺利，你会看到类似这样的输出：

[100%] Built target vsomeip
Install the project...
-- Install configuration: "Release"
-- Installing: /usr/local/lib/libvsomeip.so.3.4.10

关键点：安装完成后，库文件在 /usr/local/lib，头文件在 /usr/local/include/vsomeip。后面写 CMakeLists.txt 时，需要指定这些路径。

3.5.3 配置动态库路径

为了让系统能找到 vSOMEIP 的动态库，需要更新 ldconfig：

sudo ldconfig
# 验证一下
ldconfig -p | grep vsomeip
# 输出应该类似：libvsomeip.so.3 (libc6,x86-64) => /usr/local/lib/libvsomeip.so.3

如果没看到输出，检查一下 /usr/local/lib 是否在 /etc/ld.so.conf 中。我遇到过几次这个问题，手动加一下就行：

echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/vsomeip.conf
sudo ldconfig

3.6 验证环境：跑一个简单的 SOME/IP 示例

环境搭好了，咱们跑个官方示例验证一下。vSOMEIP 源码里自带了一些示例程序，在 examples 目录下。

3.6.1 编译示例

cd vsomeip/examples
mkdir build && cd build
cmake ..
make -j$(nproc)

编译成功后，你会看到几个可执行文件，比如 sample-service 和 sample-client。

3.6.2 运行服务端和客户端

打开两个终端。第一个终端运行服务端：

./sample-service

第二个终端运行客户端：

./sample-client

如果一切正常，服务端会打印类似：

2024-01-15 10:30:00.123456 [info] Application/0x0001 is registered.
2024-01-15 10:30:00.234567 [info] Service [0x1234:0x0001] is offered.

客户端会打印：

2024-01-15 10:30:00.345678 [info] Application/0x0002 is registered.
2024-01-15 10:30:00.456789 [info] Service [0x1234:0x0001] is available.
2024-01-15 10:30:00.567890 [info] Received response: 5

看到 Received response: 5 了吗？这说明客户端成功调用了服务端的远程方法，返回了结果。环境验证通过！

调试技巧：如果客户端没收到响应，先检查防火墙。Ubuntu 22.04 默认开了 ufw，可能会阻止 SOME/IP 使用的 UDP 端口（默认 30490）。可以临时关掉测试：sudo ufw disable。

3.7 用 Wireshark 抓包验证

光看日志还不够，咱们用 Wireshark 看看真正的 SOME/IP 报文长什么样。

  1. 打开 Wireshark，选择你正在使用的网络接口（比如 eth0 或 ens33）。
  2. 在过滤栏输入 someip，回车。
  3. 重新运行 sample-service 和 sample-client。

你会看到类似这样的报文：

  • Service Discovery：服务端发送 Offer Service 报文，客户端回复 Subscribe Eventgroup。
  • Remote Procedure Call：客户端发送 Method Call 请求，服务端回复 Method Response。

点开一个 Method Call 报文，看看它的结构：

字段 值 说明
Message ID 0x1234 Service ID + Method ID
Length 16 报文总长度
Request ID 0x00000001 客户端生成的唯一标识
Protocol Version 0x01 固定为 1
Interface Version 0x01 服务接口版本
Message Type 0x00 0x00 表示 Request
Return Code 0x00 0x00 表示成功
Payload 05 00 00 00 实际数据（小端序）

嗯，看到这里，你应该对 SOME/IP 报文有了直观感受。后面咱们写自己的协议栈时，会频繁和这些字段打交道。

避坑指南：我曾经在 Wireshark 里看不到 SOME/IP 报文，折腾了半天才发现是网卡混杂模式没开。在 Wireshark 的 Capture Options 里勾上 "Enable promiscuous mode"，就能抓到所有经过网卡的报文了。

3.8 本章小结

到这，咱们的开发环境就搭好了。你有了：

  • Ubuntu 22.04 操作系统
  • GCC 11 + CMake 3.22 编译工具链
  • Wireshark 抓包工具
  • vSOMEIP 协议栈库

下一章，我会带你用 vSOMEIP 写第一个 SOME/IP 服务端和客户端程序。到时候咱们会深入代码，看看服务是怎么注册、怎么发现、怎么通信的。

记住，环境搭好了别急着关。后面调试时，随时可能回来重新编译或调整配置。

← 上一章 📖 返回目录 下一章 →