本手册安装环境为win10 x64
请确保已在系统路径中安装PowerShell。
请确保网络的通畅性
方案1:
复制以下命令行,使用管理员权限打开PowerShell,复制粘贴大法到PowerShell,安装好choco:
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
方案2
windows下有个脚本运行框,powershell,已管理员的身份运行,然后执行如下
第一步
Get-ExecutionPolicy
如果返回Restricted,则执行这一步
Set-ExecutionPolicy Bypass -Scope Process
第二步
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
至此应该安装完成了,可以通过下面的方式查看
choco –version
C盘需要5G的空间
在PowerShell中执行以下命令:(当前段落所执行的命令均可能导致较长的耗时,请耐心等待)
mkdir c:\opt\chocolatey
set PYTHONNOUSERSITE=1
set ChocolateyInstall=c:\opt\chocolatey
choco source add -n=ros-win -s="https://aka.ms/ros/public" --priority=1
执行完毕后输入:
choco upgrade ros-foxy-desktop -y --execution-timeout=0
带命令执行完毕后,以管理员权限打开cmd,运行:
call C:\opt\ros\foxy\x64\local_setup.bat
ros2 run turtlesim turtlesim_node
此时,应出现一个乌龟模拟器,此程序为ros2自带的测试程序,效果如图:
另起一个cmd,扔选择管理员权限开启,执行:
call C:\opt\ros\foxy\x64\local_setup.bat
ros2 run turtlesim turtle_teleop_key
即可对之前运行的乌龟模拟器进行控制,至此,ros2安装完成
在C:\Users\<当前用户>\Documents\WindowsPowerShell路径下新建文件Microsoft.PowerShell_profile.ps1
用记事本等软件打开文件,将如下内容填入文件中:
C:\opt\ros\foxy\x64\local_setup.ps1
Unblock-File C:\opt\ros\foxy\x64\local_setup.ps1
保存文件
则配置成功
如果不进行该项配置,之后每次运行cmd等terminal时,先行载入ros2配置文件(默认路径为C:\opt\ros\foxy\x64\local_setup.bat),以下文档默认执行过该命令,不另作说明,当发现输入ros2相关指令无反应时请自行检查
解决方法:
1、打开PowerShell(管理员)
2、set-ExecutionPolicy RemoteSigned //设置为打开
3、键入Y或者A,同意
4、执行get-executionpolicy查看是否更改成功,为RemoteSigned表示成功
建议新建文件夹,用以编写和试运行demo
运行命令:
ros2 pkg create --build-type ament_cmake --node-name my_node mypackage
当前路径下应出现mypackage文件夹,进入该文件夹应已自动创建如下文件
cd到上级目录,执行:
colcon build --packages-select mypackage
关于colcon的相关参数选择,可以点击此处查阅官方相关文档
执行完毕后,运行命令:.\install\setup.ps1
来source刚刚编译好的package
运行命令ros2 run mypackage my_node,可以看到输出结果为hello world mypackage package。
至此,官方的创建ros2包的demo程序成功完成。
选定工作目录后,新建文件夹src并进入,然后我们创建一个包
ros2 pkg create --build-type ament_cmake cpp_pubsub
终端会显示创建了一些文件和目录表示创建成功。
然后我们进入到包的src文件夹下
在当前目录下(src上级),按照前一步的方法使ros2自动创建工作环境并执行colcon build ,包名定位
新建文件publisher_member_function.cpp,内容如下:
新建文件subscriber_member_function.cpp,内容如下:
之后修改package.xml
文件
在ament_cmake
描述的编译依赖过后之后粘贴下面两行
之后修改CMakeLists.txt
文件。在已有的依赖find_package(ament_cmake REQUIRED)
下面添加新的两行
find_package(rclcpp REQUIRED)
find_package(std_msgs REQUIRED)
然后我们添加一个talker
的可执行文件,以便ros2 run
可以运行这个文件
add_executable(talker src/publisher_member_function.cpp)
ament_target_dependencies(talker rclcpp std_msgs)
后我们还需要添加install(TARGETS…)
部分以便于ros2 run
可以找到这个可执行文件:
install(TARGETS
talker
DESTINATION lib/${PROJECT_NAME})
在install部分talker
下面添加listener
add_executable(listener src/subscriber_member_function.cpp)
ament_target_dependencies(listener rclcpp std_msgs)
install(TARGETS
talker
listener
DESTINATION lib/${PROJECT_NAME})
至此CMakeLists.txt
和package.xml
文件修改完毕,完全修改的CMakeLists.txt
文件内容应如下:
之后请确保使用管理员权限运行Developer PowerShell for VS 2019(使用其他terminal可能会导致colcon build编译失败问题,也可通过cmake自行编译),在example所在目录,执行:
colcon build --packages-select example
出现finished字样则表明构建成功
之后按照之前的demo流程,在powershell中执行
.\install\setup.ps1
之后便可通过ros2 run example listner/talker 运行demo,注意第一次运行时可能会提示
请允许其在公共网络上通信,如发现listener无法正常接收来自talker的信息,可以关闭终端后,重新打开,执行.\install\setup.ps1后重新运行ros2 run example listner/talker即可解决,成功运行结果如图: