VS Code용 ROS1 환경설정 및 Debug 설정방법

1. Visual Studio Code 설치

VS Code를 다운로드 및 설치 (https://code.visualstudio.com/Download)

VS Code 실행하여 Extensions 설치

C/C++/Python Extensions (VS Code Extensions for C++ and Python)

Name	Code Name	Description
C/C++	ms-vscode.cpptools	C/C ++ IntelliSense, 디버깅 및 코드 검색
CMake	twxs.cmake	CMake 언어 지원
CMake Tools	ms-vscode.cmake-tools	CMake 언어 지원 및 다양한 툴
Python	ms-python.python	린팅, 디버깅, Intellisense, 코드 서식 지정, 리팩토링, 단위 테스트 등

ROS Extensions (VS Code Extensions for ROS, URDF, Colcon)
Name Code Name Description
ROS ms-iot.vscode-ros ROS 개발 지원
URDF smilerobotics.urdf URDF / xacro 지원
File Format Extensions (VS Code Extensions for XML, YAML, Markdown)
Name Code Name Description
XML Tools dotjoshjohnson.xml XML, XQuery, XPath 지원
YAML redhat.vscode-yaml YAML 지원
Markdown All in One yzhang.markdown-all-in-one Markdown 지원

Name	Code Name	Description
ROS	ms-iot.vscode-ros	ROS 개발 지원
URDF	smilerobotics.urdf	URDF / xacro 지원

Name	Code Name	Description
XML Tools	dotjoshjohnson.xml	XML, XQuery, XPath 지원
YAML	redhat.vscode-yaml	YAML 지원
Markdown All in One	yzhang.markdown-all-in-one	Markdown 지원

유용한 Extensions (VS Code Extensions for Etc.)

Name	Code Name	Description
Highlight Trailing White Spaces	ybaumes.highlight-trailing-white-spaces	의미 없이 사용된 공백의 스페이스 문자 강조
EOF Mark	msfukui.eof-mark	[EOF]이 없이 끝난 파일에 [EOF] 문자 추가
Better Comments	aaron-bond.better-comments	alert, informational, TODO 등의 코멘트 강화 기능

2. Visual Studio Code 개발환경 설정

1) ROS WorkSpace 설정

Visual Studio Code에서 File에서 “ Add Folder to Workspace”를 선택하여 ROS 설치시 설정한 catkin_ws 폴더를 연다.
- Workspace 폴더명 예시: /home/username/catkin_ws

2) User Setting(Settings.json) 설정

‘settings.json’은 VSCode의 사용자별 글로벌 환경 설정을 지정하는 파일이다. 이 파일에 기술된 설정들은 모든 작업 공간(workspace)에서 적용된다. 예를 들어, 미니맵 사용, 세로 제한 줄 표시, 탭 사이즈 등 이다.
ROS 관련 설정
1. ROS Distibute 설정: ROS 버전을 지정
2. File Associations 설정: ROS에서 사용되는 파일 확장자를 명시
설정 단축키: Ctrl + ‘,’
- ROS Distribute 설정
  - Settings에서 ROS: Distro 검색 후에 현재 ROS 버전을 입력(예: kinetic)
- Files Associations 설정
  - Settings에서 Files: Associations 검색 후 다음과 같이 repos, world, xacro 를 추가

3) Task Setting(tasks.json) 설정

VSCode에서는 외부 프로그램을 Command Line Interface (CLI) 을 통해 연동하게 하는 기능이 있는데 이를 Task 라고 한다. 단순한 텍스트 에디터 기능이 기본인 VSCode가 다양한 기능을 수행하고 쉽게 기능 확장을 사용할 수 있게 된 것도 이 Task 기능이 있었기 때문이다.
ROS Task 설정
- Catkin_make: Debug : 디버깅을 위한 빌드 설정
- Catkin_make: Release : 릴리즈를 위한 빌드 설정
- Catkin_make: RelWithDebInfo : 배포용으로 빌드하지만 디버깅도 가능하도록 용량을 최대로 줄여 빌드
- Catkin_make: Clean : Build 된 파일 및 폴더를 정리하도록 빌드 설정
빌드 Task 설정 단축키: Ctrl + Shift +B

Build Task를 설정하기 위해 우선 Run Build Task (Ctrl + Shift +B) 을 실행하고 Configure Task를 선택하여 tasks.json을 다음과 같이 수정하여 ROS Colcon Build를 위한 Tasks를 설정한다.

tasks.json (~/catkin_make/.vscode/tasks.json)

  
  {
    "version": "2.0.0",
    "tasks": [        
        {
          "label": "Catkin_make: Debug",
          "type": "shell",
          "command": "catkin_make",
          "args": [
              "-j12",
              "-DCMAKE_BUILD_TYPE=Debug",
              "-DCMAKE_EXPORT_COMPILE_COMMANDS=1",
              "-DCMAKE_CXX_STANDARD=14"
          ],
          "problemMatcher": [],
          "group": {
              "kind": "build",
              "isDefault": false
          }
        },
        {
          "label": "Catkin_make: Release",
          "type": "shell",
          "command": "catkin_make",
          "args": [
              "-j12",
              "-DCMAKE_BUILD_TYPE=Release",
              "-DCMAKE_EXPORT_COMPILE_COMMANDS=1",
              "-DCMAKE_CXX_STANDARD=14"
          ],
          "problemMatcher": [],
          "group": {
              "kind": "build",
              "isDefault": false
          }
        },        
        {
          "label": "Catkin_make: RelWithDebInfo",
          "type": "shell",
          "command": "catkin_make",
          "args": [
              "-j12",
              "-DCMAKE_BUILD_TYPE=RelWithDebInfo",
              "-DCMAKE_EXPORT_COMPILE_COMMANDS=1",
              "-DCMAKE_CXX_STANDARD=14"
          ],
          "problemMatcher": [],
          "group": {
              "kind": "build",
              "isDefault": false
          }
        },
        {
          "label": "Catkin_make: Clean",
          "type": "shell",
          "command": "rm -rf build devel install"
        }
    ]
  }

4) Launch Setting(launch.json) 설정

VSCode에서의 Launch는 ‘Run and Debug’ (Ctrl + Shift + d)에서 사용되는 실행 명령어로 언어별, 디버거별로 설정이 가능하고 세부 옵션으로 Launch가 실행되기 전 즉 디버깅하기 전에 사용할 Task를 지정하거나 콘솔 기능을 설정할 수도 있다.
Launch 설정
- ROS: Attach : 실행중인 ROS Node에 디버거를 붙여 디버깅
- ROS: Launch : ROS Launch 파일을 Target에 설정해 디버깅
- Debug-rclpy(debugpy) : debugpy를 이용해 rclpy를 디버깅
- Debug-rclcpp(gbd) : gdb를 이용핸 rclcpp를 디버깅하고 디버깅 전 미리 Catkin_make: RelWithDebInfo를 수행

launch.json (~/catkin_ws/.vscode/launch.json)

  
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "ROS: Attach",
            "type": "ros",
            "request": "attach"
        },
        {
            "name": "ROS: Launch",
            "request": "launch",
            "target": "/home/username/catkin_ws/src/test_pkg/launch/test_pkg.launch",
            "type": "ros"
        },
        {
            "name": "Debug-rospy(debugpy)",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"
          },
          {
            "name": "Debug-roscpp(gbd)",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/devel/lib/${input:package}/${input:node}",
            "args": [],
            "preLaunchTask": "Catkin_make: RelWithDebInfo",
            "stopAtEntry": true,
            "cwd": "${workspaceFolder}",
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
              {
                "description": "Enable pretty-printing for gdb",
                "text": "-enable-pretty-printing",
                "ignoreFailures": true
              }
            ]
          }
        ],
        "inputs": [
          {
            "id": "package",
            "type": "promptString",
            "description": "Input ROS Package Name you want to debugging",
            "default": "ROS Package Name"
          },
          {
            "id": "node",
            "type": "promptString",
            "description": "Input ROS Node Name you want to debugging",
            "default": "ROS Node Name"
          }

    ]
}

3. VS Code에서 ROS 명령 실행

1) ROS Core 실행

Ctrl + Shift + P 실행 후 ‘ROS: Start’ 입력
VS Code 하단 파란 바에 ROS1.kinetic 왼쪽에 체크표시가 있으면 ROS Core가 가동중이고, 그곳을 누르면 ROS Core의 정보가 출력됨(ROS Parameters, Topics, Services)

2) ROS Core 중단

Ctrl + Shift + P 실행 후 ‘ROS: Stop’ 입력
ROS Core 를 중단함

3) 새로운 ROS Package 생성

Ctrl + Shift + P 실행 후 ‘ROS: Create Catkin Package’ 입력
새로운 ROS Package를 생성함
- Package name : 생성할 package의 이름을 입력
- Dependencies : 생성할 package의 의존성 package를 입력(예: roscpp, rviz, nav_msgs 등)

4) ROS Node 실행(rosrun)

Ctrl + Shift + P 실행 후 ‘ROS: Run a ROS executable (rosrun)’ 입력
실행가능한 ROS Node를 구동
- Choose a package : 실행할 ROS Node의 package를 입력
- Choose an executable : 실행할 ROS Node 파일 입력
- Enter any extra arguments : 추가적으로 넣을 arguments들을 입력

5) ROS Launch 실행(roslaunch)

Ctrl + Shift + P 실행 후 ‘ROS: Run a ROS launch file (roslaunch)’ 입력
ROS Launch 파일 구동
- Choose a package : 실행할 ROS Launch파일의 package를 입력
- Choose a launch file : 실행할 ROS Launch파일 입력
- Enter any extra arguments : 추가적으로 넣을 arguments들을 입력

6) ROS Build (Colcon Build)

Ctrl + Shift + B 실행 후, 상황에 맞게 Catkin_make: Build Option’ 입력
- Catkin_make Build Options
  - Catkin_make: Debug : 디버깅 가능하도록 빌드
  - Catkin_make: Release : 디버깅이 되지 않는 배포용 빌드
  - Catkin_make: RelWithDebInfo : 배포용으로 빌드하지만 디버깅도 가능하도록 용량을 최대로 줄여 빌드
  - Catkin_make: Clean : Build된 파일 및 폴더를 삭제

4. ROS Debugging in VS Code

우선적으로 Catkin_make: Debug나 RelWithDebInfo로 코드를 Build 한다
- Ctrl + Shift + B 실행 후, 상황에 맞게 ‘Catkin_make: Debug’ 입력

1) ROS Attach 방법

attach-to-cpp

디버깅할 소스코드에 Break 포인트를 걸어두고, 해당 코드의 ROS Node를 실행
- Ctrl + Shift + P 실행 후 ‘ROS: Run a ROS executable (rosrun)’ 입력
- Choose a package : 디버깅할 ROS Node의 package를 입력 (예시: beginner_tutorials)
- Choose an executable : 디버깅할 ROS Node 파일 입력 (예시: talker)
VS Code의 Run and Debug (’Ctrl + Shift + D’)로 이동
‘ROS: Attach’를 선택하고 디버깅 플레이버튼 누름
Choose Runtime type of node to attach to 에는 현재 디버깅할 ROS Node의 Type을 선택(C++, Python)
Select the process to attach to 에는 위에서 실행했던 ROS Node의 이름(예시: talker)을 입력 및 선택하여 구동중인 ROS Node Process에 Debugger를 붙여 Debugging을 시작

2) ROS Task 방법

debug_roscpp

ROS Cpp 파일
- 디버깅할 소스코드에 Break 포인트 설정
- VS Code의 Run and Debug (’Ctrl + Shift + D’)로 이동
- ‘Debug-roscpp(gbd)’를 선택하고 디버깅 플레이버튼 누름
- ROS Package Name 에 디버깅할 ROS Node의 Package 이름을 입력
- ROS Node Name 에 디버깅할 ROS Node의 이름을 입력하면 ROS Node가 실행되며 Break 포인트가 걸려 디버깅이 시작
ROS Py 파일
- 디버깅할 소스코드에 Break 포인트 설정
- VS Code의 Run and Debug (’Ctrl + Shift + D’)로 이동
- ‘Debug-rospy(debugpy)’를 선택하고 디버깅 플레이버튼 누름
- ROS Package Name 에 디버깅할 ROS Node의 Package 이름을 입력
- ROS Node Name 에 디버깅할 ROS Node의 이름을 입력하면 ROS Node가 실행되며 Break 포인트가 걸려 디버깅이 시작

3) ROS Launch 파일 Debugging

launch-and-debug-nodes

디버깅할 소스코드에 Break 포인트 설정
VS Code의 Run and Debug (’Ctrl + Shift + D’)로 이동
Debug Type을 ‘ROS: Launch’로 설정하고 그 오른쪽에 있는 톱니바퀴를 눌러 launch.json 파일을 오픈
launch.json 파일 안에 ROS: Launch Configuration 항목 중, “target” 에 디버깅에 사용할 Launch 파일의 절대 경로를 입력하고 저장
F5 버튼이나 ‘ROS: Launch’를 선택하고 디버깅 플레이버튼 눌러 디버깅 시작
- Launch 파일이 실행되며 위에서 설정한 Break 포인트에 디버깅 걸림

Ros1 Environment Settings For Vscode