Skip to content

Commit

Permalink
add develop_guide
Browse files Browse the repository at this point in the history
  • Loading branch information
Ar-Ray-code committed Nov 26, 2023
1 parent 4902ba6 commit 94c9760
Showing 1 changed file with 99 additions and 0 deletions.
99 changes: 99 additions & 0 deletions develop_guide/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
# 開発ガイド

ここでは、開発に関する簡単な流れを説明します。

他のプロジェクトでも同様の流れを取れるようにします。

<br>

## 使用する環境

使用する環境はつぎの通りです。

### ハードウェア

- VSCodeが動くくらいの性能のPC

### ソフトウェア

- Ubuntu22.04 LTS (ROS 2 Humbleのrosdepが解決できる環境)
- ROS 2 Humble

<br>

## 開発の流れ

開発の流れはつぎの通りです。

1. タスクの割当てがある。(issue・Projectsのチケット)
- このとき、タスクの割当ては、`~~_plugins` フォルダに対して行う。
- テストコードも作成しておく
2. ブランチを切る。
3. `~~_plugins` フォルダに対して、ソースコードを作成する。
4. `~~_plugins` フォルダに対して、ドキュメントを作成する。
4. `~~_plugins` フォルダに対して、テストコードを作成する。(ない場合)
6. テストが通るようになったら、PRを出してレビューを受ける。
7. レビューが通ったら、マージする。

途中でパラメータの追加などの

<br>


## ブランチの命名規則

ブランチの命名規則はつぎの通りです。

- `feat/<機能名>` : 機能追加
- `fix/<機能名>` : 機能修正
- `refactor/<機能名>` : 機能のリファクタリング
- `docs/<機能名>` : ドキュメントの追加・修正
- `test/<機能名>` : テストの追加・修正

<br>

## フォルダ構成

ここでは、PanelDetectorのフォルダ構成を例に説明します。

フォルダ構成はつぎの通りです。

<!-- TODO: 画像 -->

<br>

publish_centerの場合、新しく追加するファイルはつぎの通りです。

- `panel_detector/panel_detector_plugins/src/publish_center.cpp` : ソースコード
- `panel_detector/panel_detector_plugins/include/panel_detector_plugins/publish_center.hpp` : ヘッダファイル
- `panel_detector_base.hpp` を継承します。

プラグインを追加するため、次のファイルを追加で記述します。(記述しないとコンパイルエラーになります。)

- `panel_detector/panel_detector_plugins/panel_detector_plugins.xml`
- `panel_detector/panel_detector_plugins/CMakeLists.txt`

必要に応じて次のファイルを追加で記述します。

- `panel_detector/panel_detector_plugins/package.xml`
- `panel_detector/build_depends.repos`


<br>

## テストについて

TODO

<br>

## ドキュメントについて

ドキュメントは、チーム外にも共有されます。

初めてでもわかりやすい説明を心がけましょう。

<br>



0 comments on commit 94c9760

Please sign in to comment.