apollo_logo
23
0

Apollo 9.0 PnC工程安装指南

为了便于初学者学习,本实践项目基于Apollo 9.0版发布了PnC示例工程,工程内已经编写好了PnC相关的依赖包(cyberfile.xml),安装更便捷。本版本对电脑最低要求4核 16G以上,GPU无要求。

1.1 安装基础软件

4.1.1 安装Linux - Ubuntu

安装 Ubuntu 操作系统,请参见官方安装指南

注意:推荐您使用 Ubuntu 18.04.5 或以上的版本作为您主机的操作系统,若采用18.04版本可使用:Ubuntu 18.04.5 LTS (Bionic Beaver)

Ubuntu系统安装完成请更新相关软件:

sudo apt-get update
sudo apt-get upgrade

注意:更新过程中请务必保持网络链接畅通。

4.1.2 安装 Docker Engine

Apollo 依赖于 Docker 19.03+。安装 Docker 引擎,您可以根据官方文档进行安装:

  • 您还可以者通过 Apollo 提供的安装脚本直接安装:这个过程可能会运行多次脚本,根据脚本提示执行即可。
wget http://apollo-pkg-beta.bj.bcebos.com/docker_install.sh
bash docker_install.sh

1.2 安装 Apollo 环境管理工具

1.2.1 基础环境准备

4.2.1 基础环境准备4.2.1 基础环境准备

# 添加 gpg key
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://apollo-pkg-beta.cdn.bcebos.com/neo/beta/key/deb.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/apolloauto.gpg
sudo chmod a+r /etc/apt/keyrings/apolloauto.gpg
# 设置源并更新【注意】:这条指令一定要复制全,这是一条长指令,从echo一直到apolloauto.list
echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/apolloauto.gpg] https://apollo-pkg-beta.cdn.bcebos.com/apollo/core"\
$(. /etc/os-release && echo "$VERSION_CODENAME") "main" | \
sudo tee /etc/apt/sources.list.d/apolloauto.list
sudo apt-get update

‍注:如果之前已经安装过8.0版本的apollo的话,在宿主机上的/etc/apt/sources.list文件中会有形如 deb https://apollo-pkg-beta.cdn.bcebos.com/neo/beta bionic main的配置,可以直接删除,宿主机上的apollo源配置仅用于安 装aem工具

1.2.2 安装aem工具

apollo 9.0.0版本的aem兼容apollo 8.0aem,请使用以下指令进行更新。

sudo apt install apollo-neo-env-manager-dev --reinstall

安装成功后,可以使用以下指令进行查看aem工具功能。

aem -h

1.3 下载 PnC工程

1.3.1 下载工程代码

git clone https://github.com/ApolloAuto/application-pnc.git

如果出现无法clone

1.3.2 进入工程目录

cd application-pnc
  • 目录结构说明
  • core目录,系统依赖包,里面cyberfile.xml描述了使用
  • WORKSPACE:与bazel相关的一些配置信息,一般不需要用户关注。

检查工作目录

cat .workspace.json

【注意】如果"version"后的版本号不为"9.0.0-rc-r10"版本,请手动修改版本号

查看Apollo镜像是否为cpu镜像【可以降低占用内存】

【注意】如若,APOLLO_ENV_CONTAINER_REPO为'registry.baidubce.com/apollo/apollo-env-gpu',可手动修改gpu为cpu

1.4 调试pnc工程

1.4.1 进入Docker环境

# 拉取并启动docker容器
aem start_cpu
# 进入容器
aem enter

检查buildtool版本

检查进入工作空间是否正确

检查工作目录

cat .workspace.json

检查buildtool版本

检查buildtool版本

检查buildtool版本

buildtool -v

如若buildtool版本小于9.0.0-rc1-r12版本【大于r12版本的可忽略】,请使用以下指令更新:

sudo apt update && sudo apt install --only-upgrade apollo-neo-buildtool

# 下载安装依赖包: 会拉取安装core目录下的cyberfile.xml里面所有的依赖包
buildtool build -p core
#需要执行两次
buildtool build -p core

下载地图

buildtool map get 0
buildtool map get 8

1.4.2 启动Dreamview

aem bootstrap start --plus

成功启动显示:

如出现报错:

截图

问题分析

解决方法

部分文件夹没权限

当出现permission denied的时候,就需要给相应的文件夹赋予权限了

如图所示:

在permission denied 前为/opt/apollo/neo/data/log/dreamview_plus.log路径没权限

sudo chown 用户名:用户名 -R 路径

如图所示

sudo chown 用户名:用户名 -R /opt/apollo/neo/data/log/dreamview_plus.log

一般这个情况是,电脑性能问题导致的,如果输入指令后出现这个情况,是因为后台有些服务没有打开,所以会有个报错,一般需要等个几十秒

重复执行几次启动指令:

aem bootstrap start --plus

存在部分依赖没完全下载

重新执行遍:

buildtool build -p core


进入浏览器输入:http://localhost:8888/

选择红框内容,启动仿真

怎么下载代码?

如需下载其他planning代码包

可以在该链接中查看

https://apollo.baidu.com/docs/apollo/latest/md_collection_2planning_2README__cn.html

例如下载crosswalk的包

buildtool install planning-traffic-rules-crosswalk

此刻我们在planning/traffic的目录下找到crosswalk的源码

怎么编译代码?

以planning为例

buildtool build -p modules/planning

其他模块:

buildtool build -p modules/其他

下一步安装profile插件:

详见以下链接:

https://apollo.baidu.com/community/article/1031

附件下载:
原创声明,本文由作者授权发布于Apollo开发者社区,未经许可,不得转载。
发表评论已发表 0 条评论
登录后可评论,请前往 登录
暂无评论~快去发表自己的独特见解吧!
目录
1.1 安装基础软件
1.2 安装 Apollo 环境管理工具
1.3 下载 PnC工程
1.4 调试pnc工程
怎么下载代码?
怎么编译代码?