以下内容为本人的著作，如需要转载，请声明原文链接 微信公众号「englyf」https://www.cnblogs.com/englyf/p/16660252.html
最近在学习机器人相关的导航算法，为了方便于验证算法的效果，需要搭一个 ROS(Robot Operate System) 环境。特地写点笔记，这是这个机器人系列的首篇笔记。
虽然在网络上有很详细的教程，不过在对着教程一步步安装的过程中还是踩了不少坑。因为在墙内(你懂的)，会导致联网下载文件的时候老是失败。可能你会说不可以指定墙内的安装源吗？可以是可以，不过在安装完 ROS 包后还需要初始化一些环境，比如 rosdep 的初始化，这时候还是需要从 github 联网下载文件的，这时就算指定了墙内的安装源也不管事，因为这个 github 的域名被污染了。下面就记录一下解决的过程吧，回首往事真的一把心酸。。。
1.配置软件仓库
确保软件仓库里允许下载的资源类型包括 main, universe, restricted, multiverse。如下面图所示，
2.指定墙内的安装源
国内的安装源有好几个，还是觉得阿里的安装源比较快一些，直接拷贝下面的内容到 /etc/apt/sources.list 文件中替换原来的内容并且保存
deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
# deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
# deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
单独指定 ROS 包的安装源
sudo sh -c '. /etc/lsb-release && echo "deb http://mirrors.aliyun.com/ros/ubuntu/ `lsb_release -cs` main" > /etc/apt/sources.list.d/ros-latest.list'
3.指定密钥
sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654
到目前为止，以上的设置都很顺利。如果这一步你刚好出错了，可以到这里去看看处理方法。
4.安装 ROS 包
更新一下安装索引
sudo apt update
安装完整的桌面版
sudo apt install ros-melodic-desktop-full
中间会出现提示
Do you want to continue? [Y/n]
输入 Y 然后回车继续安装过程，花点时间休息一下再回来。。。
回来一看
E: Failed to fetch http://mirrors.aliyun.com/ros/ubuntu/pool/main/r/ros-melodic-rqt-moveit/ros-melodic-rqt-moveit_0.5.10-1bionic.20210505.031448_amd64.deb Undetermined Error [IP: 120.241.234.99 80]
E: Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?
出现了这一坨失败提示，后边还建议加个参数 --fix-missing 下载补漏，好的再来一次
sudo apt install ros-melodic-desktop-full --fix-missing
好了，安装完成
5.配置 ROS 环境变量
为了在每次启动 bash 时都自动载入 ROS 的环境变量，输入
echo "source /opt/ros/melodic/setup.bash" >> ~/.bashrc
source ~/.bashrc
配置完，重启一下 Terminal 窗口
6.安装一些关键的依赖包
sudo apt install python-rosdep python-rosinstall python-rosinstall-generator python-wstool build-essential
中间又会出现提示
Do you want to continue? [Y/n]
输入 Y 然后回车继续安装过程
7.初始化 ROS 的依赖安装管理包 rosdep
rosdep 是 ROS 安装管理包。使用 ROS 过程中如果需要安装被 ROS 要编译的源代码，或被某些 ROS 核心组件依赖的包，那么就可以用 rosdep 来安装。使用前，这个包需要被初始化一次
sudo rosdep init
但是，很多情况下你会碰到下面这些错误提示
ERROR: cannot download default sources list from:
https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/sources.list.d/20-default.list
Website may be down.
报错内容的意思说白了就是说域名 raw.githubusercontent.com/ros/rosdistro/master/rosdep/sources.list.d/20-default.list 的页面找不到了。真实情况其实是这个地址的域名因为众所周知的原因被污染了，并不是页面已经下架。
我是这么处理的，在网上搜一下关键词 域名查IP 找到可以查域名对应 IP 的网站，然后根据查到的 IP 来修改 主机名静态查询表 文件。如果网站告诉你 禁止查询该域名，那就再换一个网站再查，多大点事！
我这里页面返回的结果是
sudo gedit /etc/hosts
对应上边查到的 IP 地址，把下面的内容拷贝追加到 /etc/hosts 的尾部并保存
185.199.108.133 raw.githubusercontent.com
185.199.111.133 raw.githubusercontent.com
185.199.110.133 raw.githubusercontent.com
185.199.109.133 raw.githubusercontent.com
然后，再试一次
~$ sudo rosdep init
Wrote /etc/ros/rosdep/sources.list.d/20-default.list
Recommended: please run
rosdep update
成功通过这一关，接着执行更新一下
~$ rosdep update
reading in sources list data from /etc/ros/rosdep/sources.list.d
Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml
ERROR: error loading sources list:
('The read operation timed out',)
可惜又访问失败了，这会儿报的是读操作超时。重试了好几回，没办法了，看来要动用大招~
上面说白了就是读 github 网站的资源不稳定，那么我们就找一个 github 的代理资源吧。刚好我这认识一个 https://ghproxy.com/ 支持对 github 资源代理加速，速度非常好，目前是的。
打开文件，这里注意一下 ROS Melodic 用的是 python2
sudo gedit /usr/lib/python2.7/dist-packages/rosdep2/sources_list.py
找到函数 download_rosdep_data，把变量 url 赋值成
url = "https://ghproxy.com/" + url
修改后效果
def download_rosdep_data(url):
"""
:raises: :exc:`DownloadFailure` If data cannot be
retrieved (e.g. 404, bad YAML format, server down).
"""
try:
# http/https URLs need custom requests to specify the user-agent, since some repositories reject
# requests from the default user-agent.
url = "https://ghproxy.com/" + url
if url.startswith("http://") or url.startswith("https://"):
url_request = request.Request(url, headers={'User-Agent': 'rosdep/{version}'.format(version=__version__)})
else:
url_request = url
f = urlopen(url_request, timeout=DOWNLOAD_TIMEOUT)
text = f.read()
f.close()
data = yaml.safe_load(text)
if type(data) != dict:
raise DownloadFailure('rosdep data from [%s] is not a YAML dictionary' % (url))
return data
except (URLError, httplib.HTTPException) as e:
raise DownloadFailure(str(e) + ' (%s)' % url)
except yaml.YAMLError as e:
raise DownloadFailure(str(e))
打开下面的几个文件，在所有找到的 https://raw.githubusercontent.com 字符串前添加上 https://ghproxy.com/ 保存即可。
/usr/lib/python2.7/dist-packages/rosdistro/__init__.py
/usr/lib/python2.7/dist-packages/rosdep2/gbpdistro_support.py
/usr/lib/python2.7/dist-packages/rosdep2/sources_list.py
/usr/lib/python2.7/dist-packages/rosdep2/rep3.py
/usr/lib/python2.7/dist-packages/rosdistro/manifest_provider/github.py
不过，对于文件 /usr/lib/python2.7/dist-packages/rosdep2/gbpdistro_support.py 里函数 download_gbpdistro_as_rosdep_data 的输入参数 gbpdistro_url 在应用前也需要补上加速地址
def download_gbpdistro_as_rosdep_data(gbpdistro_url, targets_url=None):
"""
Download gbpdistro file from web and convert format to rosdep distro data.
DEPRECATED: see REP137. This function will output
(at least) one deprecation warning
:param gbpdistro_url: url of gbpdistro file, ``str``
:param target_url: override URL of platform targets file
:raises: :exc:`DownloadFailure`
:raises: :exc:`InvalidData` If targets file does not pass cursory
validation checks.
"""
# we can convert a gbpdistro file into rosdep data by following a
# couple rules
# will output a warning
targets_data = download_targets_data(targets_url=targets_url)
gbpdistro_url = "https://ghproxy.com/" + gbpdistro_url
try:
f = urlopen(gbpdistro_url, timeout=DOWNLOAD_TIMEOUT)
text = f.read()
f.close()
gbpdistro_data = yaml.safe_load(text)
# will output a warning
return gbprepo_to_rosdep_data(gbpdistro_data,
targets_data,
gbpdistro_url)
except Exception as e:
raise DownloadFailure('Failed to download target platform data '
'for gbpdistro:\n\t' + str(e))
好了，大招都使完了，看看效果
~$ rosdep update
reading in sources list data from /etc/ros/rosdep/sources.list.d
Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/osx-homebrew.yaml
Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/base.yaml
Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/python.yaml
Hit https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/ruby.yaml
Hit https://raw.githubusercontent.com/ros/rosdistro/master/releases/fuerte.yaml
Query rosdistro index https://ghproxy.com/https://raw.githubusercontent.com/ros/rosdistro/master/index-v4.yaml
Skip end-of-life distro "ardent"
Skip end-of-life distro "bouncy"
Skip end-of-life distro "crystal"
Skip end-of-life distro "dashing"
Skip end-of-life distro "eloquent"
Add distro "foxy"
Add distro "galactic"
Skip end-of-life distro "groovy"
Add distro "humble"
Skip end-of-life distro "hydro"
Skip end-of-life distro "indigo"
Skip end-of-life distro "jade"
Skip end-of-life distro "kinetic"
Skip end-of-life distro "lunar"
Add distro "melodic"
Add distro "noetic"
Add distro "rolling"
updated cache in /home/if/.ros/rosdep/sources.cache
8.测试一下环境
分别按顺序独立在各自的终端里执行下边的这几个指令
// 启动 ROS 核心
roscore
// 启动 ROS 仿真平台
rosrun turtlesim turtlesim_node
// 接收方向键按键信息
rosrun turtlesim turtle_teleop_key
在最后的终端里按着键盘方向键就可以控制仿真窗口里的小乌龟动起来了
如果你能顺利走到这里，说明 ROS 环境可以正常跑了。
后记：
其实写这篇笔记的过程中，除了首次配置环境，还穿插了很多任务，导致配置的过程一直停滞不前，笔记也落下那么久才发出来。如果你在对照这篇笔记来配置 ROS 环境的时候也碰到了其它的问题，欢迎留言提出来，或者添加我的微信公众号englyf给我留言？毕竟博客不一定一直在线。