# ranger_ros

> 权威词条地址：https://robotics.hellobike.com/sdks/agilexrobotics-ranger-ros
> 所属分类：sdks | 最近核验日期：2026-02-28 | 技术层级：L3, L5

## 核心摘要

agilexrobotics 在 GitHub 开源的框架，主要语言 C++。 ranger_ros

## 结构化工程参数

| 参数项 | 数值 / 配置 |
| :--- | :--- |
| `layers` | ["L3", "L5"] |
| `links` | [{"title": "GitHub", "url": "https://github.com/agilexrobotics/ranger_ros"}] |
| `updated` | 2026-02-28 |
| `vendor` | agilex |
| `repo` | https://github.com/agilexrobotics/ranger_ros |
| `language` | ["c++"] |
| `pinned_versions` | [{"version_or_sha": "main / 最新稳定分支，可按需选择对应ROS 1 Noetic或ROS 2 Humble的兼容版本", "tested_env": "Ubuntu 20.04 LTS + ROS 1 Noetic / Ubuntu 22.04 LTS + ROS 2 Humble，C++ 17及以上编译环境", "notes": "克隆至ROS工作空间src目录，执行rosdep安装依赖后编译，通过/cmd_vel话题发布控制指令，/odom等话题订阅底盘状态。"}] |
| `incompatible_envs` | ["不支持Ubuntu 18.04及更早版本，无法适配ROS 1 Melodic及以下旧版本ROS环境", "未适配Windows、macOS操作系统，仅可在原生Ubuntu或兼容Linux发行版运行"] |
| `robots` | ["agilex-ranger-mini"] |
| `repo_stats` | {"stars": 64, "forks": 18, "as_of": "2026-10-13"} |
| `tool_type` | framework |
| `source_kind` | vendor_org |
| `overview_sources` | ["https://github.com/agilexrobotics/ranger_ros"] |

## 技术详解与生态说明

ranger_ros是松灵机器人（AgileX）开源的ROS适配开发框架，工具类型为机器人开发框架，核心开发语言为C++，核心功能覆盖底盘硬件通信、运动指令解析、状态数据上报以及外设接口适配等模块，可快速完成移动底盘与ROS生态的对接。

该框架适配松灵Ranger Mini系列移动机器人本体，适配技术栈L3运动控制、L5上层应用部署层级，开发者可通过ROS工作空间克隆仓库编译，调用话题发布运动控制指令、订阅底盘里程计、电池状态等数据，快速接入导航、建图等上层ROS应用。

## 原始核验来源 (Sources)

- [GitHub agilexrobotics/ranger_ros](https://github.com/agilexrobotics/ranger_ros)