<think>我们被要求提供ROS launch文件的书写格式范例。根据引用内容，ROS launch文件使用XML格式，并且有不同的版本（ROS1和ROS2）。引用中提到了ROS1的launch文件（.launch扩展名）和ROS2的三种格式（XML、YAML、Python）。由于用户没有明确指定ROS版本，我们将分别提供ROS1和ROS2的范例，并注明区别。 注意：引用[2]和[5]是关于ROS1的launch文件，引用[3]是关于ROS2的launch文件。 ### 一、ROS1 launch文件范例（XML格式） #### 基本结构 ```xml <launch> <!-- 这是一个注释 --> <!-- 启动一个节点 --> <node pkg="包名" type="节点可执行文件" name="节点名称" output="screen"> <!-- 参数设置 --> <param name="参数名" value="参数值" /> <!-- 重映射 --> <remap from="原始话题" to="新话题" /> <!-- 加载参数文件 --> <rosparam file="$(find 包名)/路径/参数文件.yaml" command="load" /> </node> <!-- 启动另一个节点 --> <node ... /> <!-- 包含其他launch文件 --> <include file="$(find 包名)/launch/其他launch文件.launch" /> <!-- 设置环境变量（可选） --> <env name="环境变量名" value="值" /> </launch> ``` #### 详细说明： 1. **`<launch>` 标签**：根元素，所有内容都包含在其中。 2. **`<node>` 标签**：用于启动节点。 - `pkg`：节点所在的包名。 - `type`：节点的可执行文件名（通常是C++编译出的二进制文件或Python脚本）。 - `name`：为节点指定一个名称（覆盖`ros::init`中设置的名称）。 - `output`：控制节点输出位置，`output="screen"`将输出显示在终端（默认是日志文件）。 - 其他属性：`respawn="true"`（节点退出后自动重启）、`required="true"`（该节点退出则关闭整个launch）等。 3. **`<param>` 标签**：设置参数服务器的参数。 4. **`<remap>` 标签**：重映射话题、服务等名称。 5. **`<rosparam>` 标签**：从YAML文件加载多个参数。 6. **`<include>` 标签**：包含另一个launch文件，可嵌套使用。 7. **`<arg>` 标签**：定义参数（类似变量），可在launch文件内部或外部传入值。 - 定义：`<arg name="arg_name" default="默认值" />` - 使用：`$(arg arg_name)` #### 示例：启动两个turtle节点（引用[4]） ```xml <launch> <!-- 启动第一个turtle节点，并设置命名空间为test1 --> <include file="$(find launch01_basic)/launch/start_turtle.launch" ns="test1"/> <!-- 启动第二个turtle节点，并设置命名空间为test2 --> <include file="$(find launch01_basic)/launch/start_turtle.launch" ns="test2"/> </launch> ``` ### 二、ROS2 launch文件范例 ROS2支持三种格式的launch文件：XML、YAML和Python。其中Python launch文件是最强大且推荐的方式。 #### 1. XML格式（类似ROS1但不同） ```xml <launch> <node pkg="demo_nodes_cpp" exec="talker" name="my_talker" output="screen"> <param name="some_param" value="42" /> <remap from="chatter" to="my_chatter" /> </node> </launch> ``` 注意：ROS2中节点属性用`exec`（ROS1用`type`），且根标签仍为`<launch>`。 #### 2. YAML格式（用于描述节点集合） ```yaml launch: - node: pkg: "demo_nodes_cpp" exec: "talker" name: "my_talker" output: "screen" parameters: - {name: "some_param", value: "42"} remappings: - ["chatter", "my_chatter"] ``` #### 3. Python格式（最灵活） ```python from launch import LaunchDescription from launch_ros.actions import Node def generate_launch_description(): return LaunchDescription([ Node( package='demo_nodes_cpp', executable='talker', name='my_talker', output='screen', parameters=[{'some_param': 42}], remappings=[('chatter', 'my_chatter')] ), # 可以添加更多节点 ]) ``` ### 三、关键区别（ROS1 vs ROS2） 1. **文件扩展名**： - ROS1: `.launch` - ROS2: `.launch.py`（Python）、`.launch.xml`（XML）、`.launch.yaml`（YAML） 2. **节点属性**： - ROS1: `type`指定可执行文件 - ROS2: `exec`（XML）或`executable`（Python）指定可执行文件 3. **参数设置**： - ROS2支持直接传递参数字典（Python格式）或YAML描述。 4. **功能**： - ROS2的Python launch文件支持条件判断、循环等复杂逻辑。 ### 四、建议 - **ROS1**：使用XML格式，语法简单。 - **ROS2**：优先使用Python格式，功能更强大。 ### 五、参考 - ROS1官方文档：http://wiki.ros.org/roslaunch/XML - ROS2官方文档：https://docs.ros.org/en/humble/Tutorials/Intermediate/Launch/Creating-Launch-Files.html §§相关问题§§ 1. ROS1和ROS2的launch文件在语法上有哪些主要区别？ 2. 如何在ROS2的Python launch文件中使用条件判断？ 3. 如何向launch文件传递参数？ </think> ### ROS Launch 文件书写格式范例 以下是 ROS 1 和 ROS 2 的 launch 文件书写格式范例，基于 XML 和 Python 两种主流格式： --- #### **一、ROS 1 Launch 文件（XML 格式）** ```xml <!-- 基础结构 [^5] --> <launch> <!-- 1. 启动节点 --> <node pkg="package_name" <!-- 节点所在包名 --> type="executable_name" <!-- 可执行文件名 --> name="node_name" <!-- 自定义节点名称 --> output="screen" <!-- 输出到终端 --> respawn="true" <!-- 崩溃后自动重启 --> > <!-- 参数设置 --> <param name="param1" value="10" /> <param name="param2" value="$(arg user_arg)" /> <!-- 话题重映射 --> <remap from="original_topic" to="new_topic" /> </node> <!-- 2. 包含其他launch文件 [^4] --> <include file="$(find package_name)/launch/sub.launch" ns="namespace" /> <!-- 3. 加载参数文件 --> <rosparam file="$(find package_name)/config/params.yaml" command="load" /> <!-- 4. 定义参数（可在命令行覆盖） --> <arg name="user_arg" default="default_value" /> </launch> ``` --- #### **二、ROS 2 Launch 文件（Python 格式）** ```python from launch import LaunchDescription from launch_ros.actions import Node from launch.actions import IncludeLaunchDescription from launch.substitutions import PathJoinSubstitution from launch_ros.substitutions import FindPackageShare def generate_launch_description(): return LaunchDescription([ # 1. 启动节点 [^3] Node( package='package_name', executable='executable_name', name='node_name', output='screen', parameters=[{'param1': 10}], remappings=[('original_topic', 'new_topic')] ), # 2. 包含其他launch文件 IncludeLaunchDescription( PathJoinSubstitution([ FindPackageShare('package_name'), 'launch', 'sub_launch.py' ]), launch_arguments={'arg_name': 'value'}.items() ) ]) ``` --- #### **三、关键语法说明** 1. **节点启动 (`<node>`/`Node()`)** - `pkg`：ROS 包名 - `type`/`executable`：编译后的可执行文件名 - `name`：覆盖节点默认名称 - `ns`：命名空间（避免节点名冲突） 2. **参数传递** ```xml <!-- ROS 1 --> <param name="max_speed" value="5.0" /> ``` ```python # ROS 2 parameters=[{'max_speed': 5.0}] ``` 3. **话题重映射** ```xml <!-- ROS 1 --> <remap from="/camera/image" to="/robot/cam" /> ``` ```python # ROS 2 remappings=[('/camera/image', '/robot/cam')] ``` 4. **启动多个相同节点（带命名空间）[^1][^4]** ```xml <!-- ROS 1 --> <group ns="robot1"> <node pkg="turtlesim" type="turtle_node" name="turtle"/> </group> <group ns="robot2"> <node pkg="turtlesim" type="turtle_node" name="turtle"/> </group> ``` --- #### **四、最佳实践** 1. **文件结构** ``` package_name/ ├── launch/ │ ├── main.launch # ROS 1 (XML) │ └── main_launch.py # ROS 2 (Python) ├── config/ │ └── params.yaml # 参数文件 └── src/ # 源代码 ``` 2. **参数分离** - 将参数存储在 `config/params.yaml` 中： ```yaml # params.yaml controller: max_speed: 2.0 min_speed: 0.1 ``` - 在 launch 文件中加载： ```xml <!-- ROS 1 --> <rosparam file="$(find package_name)/config/params.yaml" command="load" /> ``` 3. **命令行传参** ```bash # ROS 1 roslaunch package_name main.launch user_arg:=custom_value # ROS 2 ros2 launch package_name main_launch.py user_arg:=custom_value ``` --- ### 五、完整示例（ROS 1） 启动两个 turtlesim 节点并设置不同命名空间： ```xml <launch> <!-- 节点1 --> <node pkg="turtlesim" type="turtlesim_node" name="turtle1" ns="robot1" output="screen"> <param name="background_r" value="100" /> </node> <!-- 节点2 --> <node pkg="turtlesim" type="turtlesim_node" name="turtle2" ns="robot2" output="screen"> <remap from="/turtle1/cmd_vel" to="/robot2_vel" /> </node> </launch> ``` > 参考文档： > ROS 1: [roslaunch XML](http://wiki.ros.org/roslaunch/XML) > ROS 2: [Launch System](https://docs.ros.org/en/humble/Tutorials/Intermediate/Launch/Creating-Launch-Files.html)