第4章开发环境搭建

第4章：开发环境搭建

好，咱们正式开始动手了。这一章我带你搭好开发环境。说实话，很多新手在这一步就卡住了——不是装不上库，就是编译报错。别急，我踩过的坑都帮你填平了。

4.1 Ubuntu系统准备

我个人习惯用Ubuntu 22.04 LTS。为什么选这个版本？因为它的软件源稳定，open62541的依赖包都能直接apt-get装上，省心。

如果你用的是虚拟机，记得给Ubuntu分配至少2核CPU、4GB内存。我在项目中遇到过有人只给1GB内存，编译open62541时直接OOM（内存溢出）了，那叫一个尴尬。

小提示： 如果你用的是Windows，建议装WSL2（Windows Subsystem for Linux 2）。性能比虚拟机好，而且文件共享方便。我最近几个项目都在WSL2上开发，体验不错。

4.2 CMake与GCC安装

这两个是编译工具链的核心。说白了，GCC负责把C代码变成机器码，CMake负责管理整个编译流程。

安装命令很简单，一行搞定：

sudo apt update
sudo apt install build-essential cmake git -y

验证一下版本：

gcc --version
cmake --version

嗯，这里要注意：GCC版本最好在9.0以上。我曾经在Ubuntu 18.04上用过GCC 7.5，编译open62541时遇到一个奇怪的链接错误，折腾了两天才发现是编译器版本太旧。升级到GCC 9就没事了。

工具	最低版本	推荐版本
GCC	7.0	9.0+
CMake	3.10	3.20+
Git	2.0	2.30+

4.3 open62541库编译

open62541是目前最流行的开源OPC UA实现。它支持UA Binary和UA TCP，而且能生成单文件版本，特别适合嵌入式环境。

先下载源码：

git clone https://github.com/open62541/open62541.git
cd open62541
git checkout v1.3

我建议用v1.3这个稳定版本。v1.4虽然新，但有些API还在调整。做产品嘛，稳定第一。

接下来编译。这里有两种方式：

方式一：单文件编译（推荐）

mkdir build && cd build
cmake -DBUILD_SHARED_LIBS=OFF -DUA_ENABLE_AMALGAMATION=ON ..
make -j4

编译完成后，你会得到两个文件：open62541.h 和 open62541.c。直接复制到你的项目里就能用，非常方便。

  重点： -DUA_ENABLE_AMALGAMATION=ON 这个选项就是生成单文件的关键。我第一次用open62541时没加这个参数，结果项目里要包含几十个头文件，头都大了。

方式二：动态库编译

mkdir build && cd build
cmake -DBUILD_SHARED_LIBS=ON ..
make -j4
sudo make install

这种方式适合多个项目共用同一个库。不过嵌入式场景下，我更喜欢单文件方式，部署起来简单。

避坑指南： 我曾经在交叉编译时忘了设置 CMAKE_TOOLCHAIN_FILE，结果编译出来的库在ARM板上跑不起来。如果你要交叉编译，记得加上：
cmake -DCMAKE_TOOLCHAIN_FILE=your_toolchain.cmake ..

4.4 VS Code配置

编辑器我推荐VS Code。免费、插件丰富、对C/C++支持好。你想想看，一个IDE要花钱买license，VS Code完全免费，不香吗？

安装必要的插件：

C/C++（微软官方）——提供代码补全、跳转、调试
CMake Tools——让你在VS Code里直接运行CMake命令
GitLens——查看代码历史，方便回溯

配置 c_cpp_properties.json：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                "/path/to/open62541"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/gcc",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "linux-gcc-x64"
        }
    ],
    "version": 4
}

这里有个小技巧：把open62541的头文件路径加到 includePath 里，VS Code就能自动补全OPC UA的API了。写代码时敲 UA_ 就能看到所有函数，效率翻倍。

调试配置： 按F5启动调试时，VS Code会问你要不要创建 launch.json。选「C++ (GDB/LLDB)」，然后设置 program 为你编译好的可执行文件路径。这样就能断点调试了。

4.5 验证环境

写个简单的测试程序，确认一切正常：

#include <open62541.h>
#include <stdio.h>

int main() {
    UA_Client *client = UA_Client_new();
    UA_ClientConfig_setDefault(UA_Client_getConfig(client));
    
    printf("open62541 version: %s\n", UA_STRING_TO_CSTRING(UA_STRING_ALLOC("1.3")));
    printf("Environment setup successful!\n");
    
    UA_Client_delete(client);
    return 0;
}

编译运行：

gcc -o test test.c open62541.c -lm
./test

如果看到「Environment setup successful!」，恭喜你，环境搭好了。接下来就可以正式开发OPC UA工业网关了。

嗯，这一章内容不少，但每一步都很关键。环境搭好了，后面写代码才顺畅。下一章我们开始写第一个OPC UA服务器，到时候你会觉得——原来这么简单。

📚 课程目录