# ROS セットアップチュートリアル

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

[ROS(英語)](http://www.ros.org/) (ロボットオペレーティングシステム) は、ロボットアプリケーション用に設計されたライブラリとツールのセットです。 主に C++ および Python の開発を対象とし、Python スクリプトを使用した CMake に基づく [catkin(英語)](http://wiki.ros.org/catkin) ビルドシステムを使用します。 ROS ソフトウェア [ディストリビューション(英語)](http://wiki.ros.org/ROS/Installation)は、Linux、Windows、実験モードで macOS で利用できます。

CLion は ROS プロジェクトの IDE として使用できます。 このチュートリアルでは、ワークフローを設定する方法と、ROS パッケージを作成して CLion で操作する例を示します。 このセットアップ手順は Ubuntu でテストされていることに注意してください。

> **Tip:**
> CLion の ROS 開発に使用できるサードパーティ製プラグイン、 [ROS- ロボットオペレーティングシステム(英語)](https://plugins.jetbrains.com/plugin/11420-ros-robot-operating-system)と [Hatchery(英語)](https://github.com/duckietown/hatchery) もあります。
>
>
>
> メモ   : サードパーティのプラグインは、CLion チームによって維持またはサポートされていません。

## ソース環境で CLion を起動

CLion には、ROS 固有の環境変数を通知する必要があります。 これらの変数は、ワークスペースディレクトリから次のコマンドを実行して [ワークスペースを調達(英語)](http://wiki.ros.org/ROS/Tutorials/InstallingandConfiguringROSEnvironment#Managing_Your_Environment)するときに、現在のシェルで取得されます。

```CONSOLE
source ./devel/setup.bash

```

CLion に ROS 環境変数を提供する最も簡単な方法は、   同じシェルから IDE を起動します   です。 ワークスペースが読み込まれたら、同じターミナルに入力できます。

```CONSOLE
sh <PATH_TO_CLION>/bin/clion.sh

```

## CLion で ROS プロジェクトを開く

ソース環境で CLion を起動したら、次のいずれかを実行して ROS プロジェクトを開きます。

* `ファイル | オープン` をクリックし、ROS ワークスペースの `src` ディレクトリで `CMakeLists.txt` を選択し、 プロジェクトとして開く​ を選択します。

* `ファイル | 情報源からの新しい CMake プロジェクト` をクリックし、プロジェクトをインポートするワークスペースの `src` ディレクトリを選択します。

CMake ツールウィンドウ   にプロジェクトのロード状況が表示されます:

![cmake プロジェクトを正常にロードしました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros_cmakeload_success.png)

> **Note:**
> [catkin_tools(英語)](https://catkin-tools.readthedocs.io/en/latest/index.html) を使用している場合、ワークスペース全体にトップレベルの  `CMakeLists.txt`  はありません。 この場合、各パッケージを CLion で個別のプロジェクトとして開く必要があります（パッケージディレクトリから  `CMakeLists.txt`  を選択します）。   CLion での catkin_tools   サポートの機能リクエスト: [CPP-7438(英語)](https://youtrack.jetbrains.com/issue/CPP-7438)。
>
>
>
> catkin build   と   catkin_make   の違いの詳細については、 [Catkin_tools 移行ガイド(英語)](https://catkin-tools.readthedocs.io/en/latest/migration.html)を参照してください。

## catkin ワークスペースへのビルドパスを設定する

デフォルトでは、CLion は自動的に作成される  `cmake-build-debug`  または  `cmake-build-release`  ディレクトリにビルド出力を配置します。 ROS 開発では、CLion と  `catkin_make`  を実行するコンソールの 2 つの異なるビルドがあることになります。

IDE とコンソールで共通のビルド   には、CLion ビルドパスを catkin ワークスペースディレクトリに設定する必要があります。 これを行うには、  `ファイル｜設定 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))｜ビルド、実行、デプロイ｜CMake`  に移動して 2 つのフィールドを変更します。

* ビルドディレクトリ では、 `<WORKSPACE_DIRECTORY>/build` を設定します。

* CMake のオプション に `-DCATKIN_DEVEL_PREFIX:PATH=<WORKSPACE_DIRECTORY>/devel` を追加します。

## 起動ファイルを操作する

CLion では、ROS ノードを通常のアプリケーションとして [実行](running-applications.html)および [デバッグできます](starting-the-debugger-session.html)。

[Launch](http://wiki.ros.org/roslaunch/XML)ファイルは直接実行できませんが、XML 構文ハイライトや補完を使って編集でき、実行中のノードに [デバッガー](attach-to-process.html)を接続できます。

Procedure: 実行中のノードにデバッガーを接続する

1. コマンドラインから  `.launch`  ファイルを実行します。 たとえば

```CONSOLE
roslaunch roscpp_tutorials talker_listener.launch
```

`rosnode list`  コマンドで現在実行中のノードのリストを確認することができます。 この例では、リストには  `talker`  と  `listener`  が含まれます:

![ros ノードリスト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros_nodelists.png)

2. メインメニューから  `実行 | プロセスにアタッチ`  を呼び出すか、 `Ctrl+Alt+F5` (Windows), `⌥ ⇧ F5` (macOS), `⌥ ⇧ F5` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ F5` (macOS System Shortcuts), `Ctrl+Alt+5` (XWin), `Ctrl+Alt+5` (GNOME), `Ctrl+Alt+5` (KDE), `Ctrl+Alt+F5` (Emacs), `Ctrl+Alt+F5` (Sublime Text), `⌥ ⇧ F5` (Sublime Text (macOS)), `⌥ ⇧ F5` (Xcode), `Ctrl+Alt+P` (Visual Studio), `⌘ ⌥ P` (Visual Studio (macOS)), `Ctrl+Alt+F5` (ReSharper), `⌃ ⌥ F5` (ReSharper (macOS)), `Ctrl+Alt+F5` (QtCreator), `⌥ ⇧ F5` (QtCreator (macOS)), `Ctrl+Alt+F5` (NetBeans), `Ctrl+Alt+F5` (Eclipse), `⌥ ⇧ F5` (Eclipse (macOS)) を押してください。

3. PID または名前で目的のノードに接続します：

![ros ノードにアタッチ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros_attachtonode.png)

## サンプル: 基本的な ROS ノードを作成し、CLion で編集して実行する

この例では、単純な ROS パッケージを作成し、ソースコードを編集して、CLion からノードを実行します。 Ubuntu 18.04 で ROSMelodic を使用し、 [ROS wiki(英語)](http://wiki.ros.org/ROS) で利用可能な [簡単なパブリッシャーとサブスクライバを書く (C++)(英語)](http://wiki.ros.org/ROS/Tutorials/WritingPublisherSubscriber%28c%2B%2B%29) チュートリアルの基本的な  パブリッシャー ノードを使用します。

Procedure: 基本的な ROS パッケージを作成する

1. ROS ワークスペースを作成してビルドする:

```SHELL
mkdir -p ros_workspace/src
cd ros_workspace
catkin_make

```

2. ワークスペースで、  `my_package`  というパッケージを作成します。

```SHELL
cd src
catkin_create_pkg my_package roscpp rospy std_msgs

```

Procedure: CLion を起動

1. ワークスペースのソース:

```CONSOLE
cd ../../../
source ./devel/setup.bash

```

2. 同じターミナルで CLion を起動します:

```CONSOLE
sh /opt/clion-2018.2/bin/clion.sh

```

Procedure: CLion のプロジェクトとしてパッケージを開く

* CLion で、メインメニューの   ファイル | オープン   に移動し、パッケージフォルダー内にある  `CMakeLists .txt`  ファイルを選択し、それをプロジェクトとして開くことを選びます：

![open ros プロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros_openprj.png)

Procedure: ソースファイルを追加して CMakeLists.txt を編集する

1. プロジェクトに新しいソースファイルを追加します。Project ツリーで  `src`  を右クリックし、  `新規 | C/C++ ソースファイル`  を選択して  `my_package.cpp`  と名付けます。

2. [talker.cpp(英語)](https://raw.githubusercontent.com/ros/ros_tutorials/kinetic-devel/roscpp_tutorials/talker/talker.cpp) ファイル全体を [パブリッシャーとサブスクライバー(英語)](http://wiki.ros.org/ROS/Tutorials/WritingPublisherSubscriber%28c%2B%2B%29)チュートリアルから  `my_package.cpp`  にコピーします。

3. 新しく作成されたソースを  `CMakeLists.txt`  に追加し、   catkin   ライブラリに対して [リンク(英語)](http://wiki.ros.org/catkin/CMakeLists.txt#target_link_libraries)します。

```CMAKE
add_executable(my_package src/my_package.cpp)
target_link_libraries(my_package ${catkin_LIBRARIES})

```

その後、CMake プロジェクトを [再ロード](reloading-project.html)し、Run/Debug 設定のリストの中の   my_package   に注目してください。

![cmakelists にソースを追加して再ロードする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros_addcpp_reload.png)

Procedure: ROS ノードの実行

1. CLion からノードを実行する前に、新しいターミナルで ROS マスタを開きます。

```CONSOLE
roscore
```

2. CLion で、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) を使って   my_package   構成を実行します。   実行ツールウィンドウ   はノードの出力を表示します：

![実行中のノードの出力](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros_runnode.png)

3. 別のターミナルで、現在アクティブな ROS トピックを確認します。

`chatter`  からのメッセージを出力すると、出力は CLion で表示されるものと同様になります。

![ros chatter ノードが実行](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ros_chatter.png)

ここで、CLion でアプリケーションを停止すると、  `rostopic echo /chatter`  コマンドは出力されなくなります。

## See also

### オンラインドキュメント

[クイック CMake チュートリアル](quick-cmake-tutorial.html)

### 外部リンク

[ROS wiki](https://wiki.ros.org/)

