基于 Rcl.NET 框架接入 ROS2 生态

Rcl.NET 是专为 .NET 平台（C#/VB.NET 等）开发的 ROS2 官方标准客户端库，它基于 ROS2 核心底层的 RCL（ROS Client Library）C 语言层 举行原生封装，是 .NET 开发者接入 ROS2 生态的核心开发工具

第一部分：安装 ROS 2 环境（基于Linux体系）

1、docker 容器内安装 https://www.cnblogs.com/dosswy/p/19856550

2、Microsoft Store 安装 Ubuntu（WSL2 环境）

第二部分：基于 ros2cs 天生消息类

1. # 第一步骤：使用 NuGet 包管理器安装：ros2cs
2. dotnet tool install -g ros2cs
4. # 第二步骤：创建 ros2cs.spec 文件指令
5. echo "include std_msgs" > ros2cs.spec
7. # 第三步骤：确保 ROS2 环境完全生效
8. source /opt/ros/jazzy/setup.bash
9. # 验证环境变量，必须包含 /opt/ros/jazzy
10. echo $AMENT_PREFIX_PATH
11. # 验证 std_msgs 存在
12. ros2 pkg list | grep std_msgs
14. #第四步骤：执行正确的 ros2cs 生成命令
15. # 加 --from-ament-index 从 ROS2 环境读取包，-o 指定输出目录
16. ros2cs --from-ament-index -o Std_Messages  ros2cs.spec

复制代码

第三部分：Rcl.NET 示例代码

1. static async Task Main(string[] args)
2. {
3.             
4.     // 创建并初始化 ROS2 上下文（负责节点生命周期、参数解析）
5.     await using var ctx = new RclContext(args);
6.             
7.     // 创建 ROS2 节点，节点名称：rclnet_publisher
8.     using var node = ctx.CreateNode("rclnet_publisher");
9.             
10.     Console.WriteLine("RclContext 初始化 ROS2 上下文成功...");
12.     // 创建发布者，发布std_msgs/String类型的消息到指定话题
13.     using var pub = node.CreatePublisher<Rosidl.Messages.Std.String>("/chatter");
14.             
15.     Console.WriteLine("创建发布话题：/chatter 成功...");
17.     int count = 0;
18.     while (true)
19.     {
20.           // 构造消息
21.           var msg = new Rosidl.Messages.Std.String($"Hello ROS2 from C# rclnet! Count: {count}");
23.           // 发布消息
24.           pub.Publish(msg);
26.           Console.WriteLine($"已发布 /chatter: {msg}");
27.           count++;
28.           await Task.Delay(1000);
29.     }
30. }

复制代码

第四部分：运行 Rcl.NET 验证

1. # 运行项目
2. dotnet run
4. # 监听话题
5. ros2 topic echo /chatter

复制代码