警告

您正在阅读的 ROS 2 文档版本已达到 EOL（生命周期结束），不再受官方支持。如果您想了解最新信息，请访问 Jazzy.

在 macOS 上安装 ROS 2

本页介绍如何在 macOS 上通过预制二进制包安装 ROS 2。

系统要求 

我们支持 OS X El Capitan 和 macOS Sierra（10.11.x 和 10.12.x）。

安装先决条件 

在安装 ROS 2 之前，您需要安装以下设备。

酿 (需要安装更多东西；您可能已经有了这个）。:
- 请按照以下网址的安装说明进行操作 http://brew.sh/
- 可选:检查 酿 运行
```
  酿 医生修复 任何 问题 那 它 确定。
```

使用 酿 安装更多东西：

酿 安装 python3

# 为 Fast-RTPS 安装 asio 和 tinyxml2
酿 安装 秋叶 tinyxml2

# 为机器人状态发布器安装依赖项
酿 安装 tinyxml 本征 pcre poco

# OpenCV 不是 ROS 2 的依赖项，但某些演示会用到它。
酿 安装 opencv

# 为 DDS-Security 安装 OpenSSL
酿 安装 opensl

# 为 RViz 安装 Qt
酿 安装 qt 自由类型 屁股

# 为 rcl_logging_log4cxx 安装依赖项
酿 安装 log4cxx

安装 rqt 依赖项

酿安装啜饮 pyqt5

在安装过程中查找 sip 文件时，修正了一些路径名（请参阅 ROS 1 维基百科):

ln -s /usr/local/share/sip/Qt5 /usr/local/share/sip/PyQt5

酿安装图形化

python3 -m 核心安装 pygraphviz 嘟
安装 SROS2 依赖项

python3 -m 核心安装 lxml

为命令行工具安装额外的运行时依赖项：

python3 -m 核心 安装 catkin_pkg 空虚 云雀解析器 解析 pyyaml 设置工具 argcomplete

禁用系统完整性保护 (SIP)

macOS/OS X 版本 >=10.11 默认启用了系统完整性保护。这样，SIP 就不会阻止进程继承动态链接器环境变量，例如 dyld_library_path您需要禁用它根据这些说明.

下载 ROS 2 

转到发布页面： https://github.com/ros2/ros2/releases
下载 macOS 的最新软件包；假设其最终位置为 ~/Downloads/ros2-release-distro-date-macos-amd64.tar.bz2.
- 注意：可能有不止一个二进制下载选项，这可能会导致文件名不同。

打开包装：

mkdir -p ~/ros2_crystal
CD ~/ros2_crystal tar xf ~/Downloads/ros2-release-distro-date-macos-amd64.tar.bz2

安装其他 DDS 实现（可选）

除了默认的 eProsima 快速 RTPS 之外，如果您还想使用其他 DDS 或 RTPS 供应商，可以查看相关说明这里.

环境设置 

源 ROS 2 设置文件：

. ~/ros2_crystal/ros2-osx/setup.bash

举例说明 

在一个终端中，如上所述设置 ROS 2 环境，然后运行 C++ 话匣子:

玫瑰2 运行 演示节点 话匣子

在另一个终端设置 ROS 2 环境，然后运行 Python 听众:

玫瑰2 运行 演示节点 听众

您应该看到 话匣子 说它是 出版 信息和 听众 成语 I 听说 这些信息。这就验证了 C++ 和 Python API 都能正常工作。万岁

参见教程和演示其他尝试。

建立自己的软件包 

如果您想构建自己的软件包，请参阅教程使用 Colcon 构建软件包"；.

故障排除 

可以找到故障排除技术这里.

卸载 

如果您按照上述说明使用 colcon 安装了工作区，那么 "卸载 "可能只是打开一个新终端，而不是从工作区的 设置 文件。这样，您的环境就会像系统中没有安装 Crystal 软件一样运行。
如果你也想释放空间，可以用以下方法删除整个工作区目录：
```
rm -rf ~/ros2_crystal
```