#2 エディタを使おう(VisualStudio Code)【もっと!後輩たちのためのEV3rt講座】

# 目次

| 章 | タイトル | 内容 |
|:-:|:-:|:-:|
| 1 | [はじめに](#1-はじめに) | 今回のテーマ「エディタ」について説明 |
| 2 | [【Step 1】VSCodeのインストール](#2-step-1vscodeのインストール) | VSCodeのインストール |
| 3 | [【Step 2】VSCodeの日本語化](#3-step-2vscodeの日本語化) | VSCodeのセットアップ |
| 4 | [【Step 3】ワークスペースの拡張機能](#4-step-3ワークスペースの拡張機能) | ワークスペースを簡単に扱えるように設定 |
| 5 | [【Step 4】ワークスペースの設定](#5-step-4ワークスペースの設定) | EV3rtのワークスペースを設定 |
| 6 | [【Step 5】C/C++の拡張機能](#6-step-5ccの拡張機能) | C言語開発用の拡張機能を導入 |
| 7 | [まとめ](#7-まとめ) | 今回のまとめと次回について |

# 1. はじめに

前回、EV3rtを使うためにWSL/Linuxのインストール、および「コンパイラ」のインストール等を行い、最後に動作確認を行いました。

前回の記事👇

https://qiita.com/koushiro/items/4ee879e5420260cea6c8

今回は、開発をより効率的に進めるために、「エディタ」のインストールとその設定を行っていきます。

## エディタとは？

前回も登場した、EV3rtの開発の流れを示したイラストを見ながら説明していきたいと思います。

![EV3rt 構成図.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/d9c498fe-46b8-7956-dc26-b6c65649719d.png)

EV3rtのプログラムは「C言語」で書きますが、その「ファイルにプログラムを書くツール」を **「エディタ」** と言います。

エディタはファイルに文章を書くツールの総称なので、Windowsに標準搭載されている「メモ帳」もエディタの一つと言えます。

ただ、実際のところ、プログラムを書く場合はそれに特化したエディタを使う方が良いです。
近年のエディタには以下のような機能が搭載されています。

- 検索・置換機能
- コードの自動補完機能
- ウィンドウ内のターミナル
- その他あまたの拡張機能

その中でも、本シリーズではMicrosoft社が開発している **「Visual Studio Code」** を使っていきたいと思います。

Visual Studio Code (以降、VSCode) は近年非常に人気のコードエディタで、Microsoftが開発しているということもありPowershellやWSLとの親和性も非常に高いです。
今回はVScode自体のインストール、その後にソフト内で拡張機能のインストール、各種設定を行っていきます。

# 2. 【Step 1】VSCodeのインストール

まずは、以下のリンクからVSCodeのダウンロードサイトにアクセスしましょう。

https://code.visualstudio.com/download

下の画像の赤丸で囲んだボタンを押して、インストーラーをダウンロードします。

![VSCode_download.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/602880c2-7838-391b-d908-3e191b37d8cb.png)

ダウンロード出来たら、インストーラーを起動してください。
そうすると、以下のような同意画面が表示されるので、「同意する」にチェックをいれた上で次に進んでください。

![vscode_setup1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/ea7552b1-fd20-dc07-a9f3-70193d612dd7.png)

次に、VSCodeのインストール先について聞かれますが、特にこだわりがなければそのままの状態で次に進んでください。

![vscode_setup2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/595ff943-6773-a652-d8f6-eda16cb8160f.png)

次に、スタートメニューのショートカットについて聞かれますが、これもこだわりがなければそのままの状態で次に進んでください。

![vscode_setup3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/ea70e9dc-2876-fa69-eef0-906852ac30ab.png)

最後に追加タスクの選択としていくつかオプションが表示されていますが、以下の画像のようにチェック☑を入れておくことをお勧めします。

![vscode_setup4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/ba17b5a4-75c5-e92a-b4e4-29fa7ea30d22.png)

以下の画面まで進んだら、「インストール」を押してVSCodeをインストールしましょう。

![vscode_setup5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/9096f281-2bf8-c1e2-d0c6-e46a3d9726fa.png)

以下の画面が表示されたら、インストール完了です。
☑Visual Studio Code を実行する にチェックを入れた状態で「完了」を押し、そのままVSCodeを開いてセットアップに移りましょう。

![vscode_setup6.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/43deae96-d7dd-87c8-a8a1-87915358f532.png)

# 3. 【Step 2】VSCodeの日本語化

VSCodeを開くと以下のような画面が表示されます。

![VSCode_window.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/01fdcca9-27bc-7bf0-4411-3d69e35baabc.png)

ここから、拡張機能を導入していき、VSCodeを使いやすくしていきます。

### VSCodeの日本語化

まずは、VSCodeを日本語化していきます。
下の画像に示すように、左のタブバーの「Extensions」のアイコンを開きます。

![VSCode_window.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/686203a4-b0ea-507e-f4bf-f10900060721.png)

すると、Extensionsのサブウィンドウが表示されます。

![ext_jp.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/b77993f3-f496-446d-57f3-9634b3db6532.png)

上の画像の赤丸で囲んだ部分の検索ボックスに、 **「Japanese」** と入力します。
すると、 **「Japanese Language Pack for Visual Studio Code」** という拡張機能が提示されます。

青い **「Install」** ボタンを押して、インストールをしましょう。
インストールが完了すると、画面右下に以下のようなダイアログが表示されます。

![jp_install.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/d424e580-d817-32eb-b5df-6f7ca805c2b1.png)

この、 **「Change Language and Restart」** を押し、VSCodeを再起動してください。
再起動すると、VSCodeの日本語化が完了するはずです。

![VSCode_jp.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/ce4aa392-f00e-533b-f054-b980e7ed057a.png)

# 4. 【Step 3】ワークスペースの拡張機能

次に、同じく拡張機能の検索ボックスに、 **「Workspace Explorer」** と入力してください。
すると、以下のような拡張機能が提示されます。

![ext_workspace.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/65f30a99-1691-dca7-0786-b2e4a607522d.png)

これは、VSCodeで扱う「ワークスペース」に簡単にアクセスすることが出来る拡張機能です。
「ワークスペース」の設定も後ほど行いますが、要するにEV3rtのフォルダ群のことです。

上の拡張機能も「インストール」ボタンを押して、インストールしましょう。

インストールが完了したら、以下のように歯車ボタンを押して、「拡張機能の設定」を押しましょう。

![ext_ws_set.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/d4fafd15-ff2c-55ba-dc4d-f0aaf28324b4.png)

すると以下のような画面が表示されるはずです。

![ext_ws_set2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/a158afe0-defb-478c-9f6a-bfdcb2c4476f.png)

ここで、 `Workspace Explorer: Workspace Storage Directory` の部分に、`C:\workspaces`を指定しましょう。
これは、Cドライブ直下の`workspaces`というフォルダにワークスペースの設定ファイルを置くようにして、それを拡張機能が読みに行けるようにするという設定です。

VSCodeを再起動して次へ進みましょう。

# 5. 【Step 4】ワークスペースの設定

では、実際にEV3rtのワークスペースを設定していきます。

まず、エクスプローラーでCドライブを開きましょう。
前回配置した `ev3rt-1.1-release` のフォルダを右クリックして、 **「Codeで開く」** を選択します。

![cdrive_vsopen.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/3cf0c613-ed65-0845-dcf3-7bc9c22f9b2b.png)

すると、以下のようにev3rtのフォルダが開かれたVSCodeが起動します。
左側のサブウィンドウで表示されているファイル・フォルダ群、これが「ワークスペース」です。

![vscode_ev3rt.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/d40c45a6-76fb-f492-8b50-05dd01ad13b5.png)

既にこれでワークスペースを開けているのですが、これを毎回エクスプローラーから開くのは少し面倒なので、先ほど導入した拡張機能からアクセスできるようにします。

以下のように、「ファイル」の **「名前を付けてワークスペースを保存…」** を押して、ワークスペースの設定ファイルを作成・保存します。

![ws_file_save.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/e78dfd69-ee08-038f-41ff-8c568a5a29c7.png)

すると、どこに設定ファイルを保存するか聞かれるので、まずはCドライブに移動しましょう。

![ws_file_save_exp1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/795173c7-a29f-9bbc-866c-bb12579cde94.png)

ここに、`workspaces`という新しいフォルダを作成します。

![ws_file_save_exp2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/7b19205b-344a-339d-529a-c485d1da45a1.png)

`workspaces`フォルダ内に入り、「保存」を押します。
これで、先ほどの拡張機能が勝手にワークスペースを見つけてくれるようになります。

## ワークスペースの確認

では、ちゃんとワークスペースが登録されてるか、確認しましょう。
以下のように、左のタブバーのアイコンを選択して、サブウィンドウを表示させましょう。

![ws_ext_check.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/5bdb0b77-153e-c10e-2c10-4945f50ef661.png)

ここに、確かに **`ev3rt-1.1-release`** が登録されていることが確認できます。
開くときは、そのワークスペースの名前の部分をクリックすれば一発で開くことが出来ます。

# 6. 【Step 5】C/C++の拡張機能

EV3rtの開発はC言語で行うので、C言語の開発をサポートしてくれる拡張機能を導入します。
先ほどと同様に、VSCodeの拡張機能検索で、`C`と検索してください。

いくつか表示されますが、その中で **「C/C++ Extension Pack」** を探してください。
これをインストールしましょう。

![ext_c.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/e4e67dc4-5b44-79ca-ee2b-e1304fca8afd.png)

何か目に見える変化はありませんが、随所でC言語の開発を少し手助けしてくれます。

# 7. まとめ

## の前に一つだけ補足

この手のコードでの開発で、プログラムを修正したはずなのになぜか治ってない、みたいなことがよく起こります。
そういった時の典型的な原因一つとして、 **「ファイルを保存していなかった」** という理由があります。

VSCodeにはこれを防ぐ、コードの **「自動保存」** 機能があります。
これを設定しておくことをお勧めします。

設定方法は、「ファイル」⇒「自動保存」にチェックを入れておくだけです。
これだけで、開発時のミスを減らせるので、ぜひオンにしておきましょう。

![autosave.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/2367749d-626a-2866-654d-a19509d73190.png)

## 本当にまとめ

今回は「エディタ」を導入し、使いやすいようにカスタイマイズを行いました。
今回紹介したもの以外にも、VSCodeにはあまたの拡張機能があります。
色々調べてみて、自分が使いやすい「エディタ」にカスタイマイズしていくのも良いと思います。
ぜひ自分だけのエディタを作ってみてください!

又、今回の設定を行ったことで、プログラム製作時に自動的に予測の候補を出してくれるようになっているはずです。

![sugest.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/e8ff6d30-bf6e-cfb9-dd0a-b380b7435edb.png)

さらに、その関数に指定すべき値(引数)についての説明も自動的に表示されます。

![sugest2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/183170/c8900e82-51e6-f55d-d9d7-411101d5f889.png)

これで、プログラム開発がかなり楽になったはずです。
詳しい使い方は、追々のプログラム製作で確認していきましょう。

次回はEV3rtにおける開発の基本的な事項について説明していきます。
SDcardに書く設定ファイルや、プログラム制作時の4つのファイル、コンパイルの方法などについてです。
次回も頑張りましょう!!

前回: [#1 開発環境を作ろう](https://qiita.com/koushiro/items/4ee879e5420260cea6c8)
次回: [#3 アプリケーション開発のおやくそく](https://qiita.com/koushiro/items/e3d04e3a4e266c603865)