この記事では、VEX Visual Studio Code 拡張機能 UI (ユーザー インターフェイス) の概要を説明します。 この拡張機能は、VEX IQ (第 2 世代)、EXP、および V5 プラットフォーム用の C++ および Python プロジェクトの開発をサポートします。

VEX VS Code拡張機能のUIレイアウト

VEX Visual Studio Code 拡張機能 UI は、アクティビティ バー、サイド バー、エディター、ターミナル パネル、ツールバーの 5 つの主要領域に分かれています。

完全な VEX VS Code UI レイアウトを示すスクリーンショット。 アクティビティ バーとサイド バーは画面の左側にあり、ツールバーとターミナルは画面の下部にあり、エディターは画面の残りの部分を占めます。

アクティビティバー

アクティビティ バーには、ビューを切り替えたり、VEX プロジェクト開発のコンテキスト固有の追加インジケーターを表示したりするためのアイコンの配列が用意されています。

VEX Robotics 拡張機能がインストールされた VS Code アクティビティ バー。 アクティビティ バーには、検索、拡張機能の管理、バージョン管理などの便利なクイック アクションを提供するアイコンがあります。

VS Code で VEX プロジェクトを開発する際によく使用されるアイコンは次のとおりです。

  • エクスプローラー ビュー アイコン。 エクスプローラー ビュー アイコン - クリックすると、サイド バーに エクスプローラー ビュー が開きます。
  • 拡張機能の表示アイコン。 拡張機能ビューアイコン - クリックすると、サイドバーに 拡張機能ビュー が開きます。
  • VEX ビューアイコン。 VEX ビューアイコン - クリックすると、サイドバーに VEX ビュー が開きます。

サイドバー

サイドバーには、VS Code 内の統合ツールを使用できるようにするさまざまなビューが含まれています。 VEX プロジェクト開発のタスクを実行するために使用される一般的なサイドバー ビューは、 拡張ビューVEX ビュー、および エクスプローラー ビューです。

拡張ビュー

拡張機能ビュー 、VS Code で拡張機能をインストールおよび管理するために使用されます。 VEX IQ (第 2 世代)、EXP、および V5 プラットフォームでソフトウェアを開発するには、VEX 拡張機能、C/C++ 拡張機能、および Python 拡張機能をインストールする必要があります。

VS Code に VEX 拡張機能C/C++ 拡張機能、および Python 拡張機能 をインストールする手順については、 この記事を参照してください。

インストールされている拡張機能の一覧を表示する VS Code 拡張機能ビュー。 各拡張機能には、ここで開くことができる設定メニューがあり、新しい拡張機能を見つけてダウンロードするための検索バーがあります。


VEXビュー

VEX View を使用すると、VS Code で VEX IQ (第 2 世代)、EXP、V5 のプロジェクトを開発できます。 VEX ビューには、 プロジェクト アクション、VEX デバイス情報、 および VEX フィードバック3 つのカテゴリが含まれています。

VS Code VEX ビュー。上部にプロジェクトの作成とインポートのオプション、下部に VEX デバイス情報メニュー、下部にフィードバック メニューが表示されます。

VEX 拡張ビューのプロジェクト アクション セクション。 このセクションには、「新規プロジェクト」と「プロジェクトのインポート」という 2 つのボタンがあります。

  • VEX デバイス情報
    VEX デバイス情報 カテゴリでは 接続 れている VEX デバイス (VEX ブレインまたは VEX コントローラー) の概要が表示されます。

    VEX Device Info section of the VEX Extension View is shown, with a list of all connected devices and specific info about each one. In this example, an EXP Brain and its downloaded programs are shown.


    このカテゴリは、接続されている VEX デバイスの種類を示し、Brain システム、シリアル ポート、ダウンロードされたプログラム、および VEX Brain のスマート ポートに接続されているデバイスの情報を表示します。 これにより、VEX ブレイン画面のスクリーンショットを撮ったり、VEX ブレインイベントログを表示したり、ブレイン名とチーム番号を設定したり、VEX ブレインからユーザープログラムを消去したりすることができます

    VEX Brain がコンピュータに接続されている場合、 VEX DEVICE INFO カテゴリには、VEX コントローラーが VEX Brain にリンクされているかどうかが表示され、 VEX Brain の VEXos 4 バージョンが古い場合は、VEX Brain の VEXos を更新できます

    VEX コントローラーがコンピューターに接続されている場合、 VEX DEVICE INFO カテゴリには、VEX Brain が VEX コントローラーにリンクされているかどうかが表示され、VEX コントローラーの VEXos のバージョンが古い場合は、VEX コントローラーの を更新できます

    デバイス情報の包括的な説明と、 VEX DEVICE INFOの機能の使用方法については、 こちらの記事をご覧ください。
  • VEX FEEDBACK
    VEX FEEDBACK の下に テキストボックスにメッセージを入力し、 SEND ボタンをクリックすると、VEX にフィードバックを送信できます。
    VS Code で VEX FEEDBACK を使用する方法については、 こちらの記事を参照してください。

VEX 拡張ビューの VEX フィードバック セクション。 このセクションには、VEX にフィードバックを送信するためのオプションを含むフォームがあります。

エクスプローラービュー

エクスプローラー ビュー 、VS Code で VEX プロジェクト ファイルとフォルダーを参照、開き、管理するために使用されます。

ユーザーが VEX プロジェクト内のフォルダーとファイルを移動できるようにする VS Code エクスプローラー ビュー。 ファイルには対応するアイコンとファイル タイプが表示されます。この例では、Python ファイルが選択され、タイトルは main.py になっています。

エディタ

エディターは、VS Code でファイルを編集するためのメイン領域です。 VEX VS Code 拡張機能により、エディター領域で C/C++ と Python の両方の Intellisense/Lint が有効になり、プログラムの開発に役立ちます。

VEX プロジェクトの一部として Python ファイルを開いた VS Code エディター。 ここで Python または C/C++ コードを記述および編集して、VEX Brain に接続したときに VEX ロボット プログラムを作成できます。

エディター領域では、関数のテキストの上にマウスを移動するか、 VEX コマンド ヘルプ を使用して C++ および Python API (アプリケーション プログラミング インターフェイス) に含まれるこの関数のドキュメントにアクセスすることで、特定の関数に関する役立つ情報にアクセスできます。

VS Code で VEX コマンド ヘルプ を使用する詳細な手順については、 この記事参照してください。

端子パネル

VEX VS Code 拡張機能は、起動時にログ ターミナルとインタラクティブ ターミナルの 2 つのターミナルを提供します。 

  • ログ ターミナル - ログ ターミナルには、ビルド出力、ビルド エラー、およびダウンロード結果が表示されます。

VS Code VEX ログ ターミナルが開き、ログを読み取る 1 つのメッセージのみが印刷されたデフォルトの空白の状態が表示されます。

  • 対話型端末 - 対話型端末には、印刷ログの表示と、生のキーストロークをユーザープログラムに返すという2つの機能があります

    VS Code VEX Interactive Terminal is opened and shows messages that detail the VEX Brain connection status.



    注: インタラクティブターミナルを利用するには、ブレインまたはコントローラーをVEX VS Code拡張機能を実行しているコンピューターに接続する必要があります
    注: ユーザー プログラムをビルドしてダウンロードすると、対話型ターミナル出力はデフォルトでクリアされます。

ツールバー

ツールバーには、VEX VS Code 拡張プロジェクト、VEX ブレイン、および VEX コントローラーと簡単に対話できるさまざまなアイコンが用意されています。

接続された VEX デバイスおよびプロジェクトとすばやく対話するために使用できる VEX 拡張アイコンを備えた VS Code ツールバー。 VEX の機能には、デバイス ピッカー、スロット セレクター、ビルド & ダウンロード アイコン、再生アイコン、停止アイコン、プロジェクト セレクター、Python ファイル セレクターが含まれます。

注: ツールバーは、VS Code で有効な VEX プロジェクトが開いている場合にのみアクティブになります。 

注: 有効な VEX プロジェクトは、拡張機能によって作成またはインポートされたプロジェクトです。 エディターで開かれた VEXcode または VEXcode Pro プロジェクトは有効な VEX プロジェクトとはみなされないため、インポートする必要があります。

ツールバーに表示されるアイコンは次のとおりです。

  • デバイス ピッカー アイコンが VS Code ツールバーに表示されます。 デバイス ピッカー - デバイス ピッカーには、接続されている VEX デバイスのアイコン (ブレイン アイコン Device Picker icon is highlighted on the VS Code toolbar. In this example it shows a Brain icon. またはコントローラ アイコン Device Picker icon is highlighted on the VS Code toolbar. In this example it shows a Controller icon.) が表示されます
    注: コントローラがコンピューターに接続されているが、ブレインとの無線リンクがない場合は、コントローラ アイコンの横にブレイン名は表示されません。
  • スロットセレクターアイコン。 スロット セレクター アイコン - スロット セレクター アイコン を使用すると、それをクリックして選択リストから VEX Brain 上の 8 つの利用可能なスロットの 1 つを選択することで、VEX Extension がユーザー プログラムをダウンロードまたは再生するスロットを選択できます。
  • ビルドとダウンロードのアイコン。 ビルド & ダウンロード アイコン - VEX デバイスが接続されている場合、 ダウンロード アイコン ツールバーに表示されます。 クリックすると、プロジェクトがビルドされ、成功した場合は接続されている VEX デバイスにダウンロードされます。
  • 再生アイコン。 再生アイコン - クリックすると、 再生アイコン は、VEX Brain の選択されたスロットにダウンロードされたユーザー プログラムを実行します。
  • 停止アイコン。 停止アイコン - クリックすると、 停止アイコン VEX Brain 上のユーザー プログラムの実行が停止します。
  • プロジェクト セレクターは VS Code ツールバーに表示されます。 この例では、v5NewProject と表示されます。 プロジェクトセレクター - プロジェクトセレクター には、選択したプロジェクトの名前が表示されます。 プロジェクト セレクター アイコン を使用すると、ワークスペース内に複数の VEX プロジェクトが存在する場合に、それをクリックして選択リストからプロジェクトを選択することで、VEX プロジェクトを切り替えることができます。
  • Python ファイル セレクター アイコンが VS Code ツールバーに表示されます。 この例では main.py となります。 Python ファイル セレクター (Python のみ) - VEX Python プロジェクトを選択すると、 Python ファイル セレクター ツールバーに表示されます。 Python ファイル セレクター には、選択した Python ファイルの名前が表示されます。 Python for VEX は現在、単一ファイルのダウンロードのみをサポートしています。

VS Code のツールバー機能の使用方法に関する役立つ情報については、 この記事をご覧ください。

VEXユーザー設定

VEX ユーザー設定を使用すると、独自の要件に応じて VEX Extension を構成できます。 ユーザー設定は、すべての VEX VS Code 拡張プロジェクトに適用されるグローバル設定です。 VS Code の設定アイコンをクリックし、メニューで対応する項目を選択すると、 VEX ユーザー設定 にアクセスできます。

VS Code ユーザー設定が VEX カテゴリに開かれ、VEX ロボティクス拡張機能の動作をカスタマイズできます。

VEX VS Code 拡張機能を構成するための VEX ユーザー設定は次のとおりです。

  • Cpp ツールチェーン パス - CPP ツールチェーンのパスを設定します。
  • ユーザー ターミナルを有効にする - 拡張機能がユーザー ポートからデータを開いて表示することを有効または無効にします。
  • ログエントリ - VEX ブレインからアップロードするログエントリの数を設定します。
  • プロジェクト ビルド タイプ - 拡張機能が C++ プロジェクトをビルドする方法を設定します。
  • プロジェクト ホーム - 新しいプロジェクトのデフォルトの場所を設定します。
  • ダウンロード後に実行 - ユーザー プログラムが VEX Brain にダウンロードされた後に実行されるかどうかを設定します。
  • システム DFU 自動回復 - DFU モードで IQ (第 2 世代) または EXP Brain が検出された場合に Brain を自動回復するかどうかを設定します。
  • Websocket サーバー有効化 - Websocket サーバーを起動する拡張機能を有効または無効にします。
  • Websocket サーバー ホスト アドレス - Websocket サーバーのホスト アドレスを設定します。
  • Websocketサーバーポート - Websocketサーバーのポート番号を設定します

VEX ユーザー設定にアクセスして設定する方法についての役立つ情報については、 この記事をご覧ください。

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: