VEX VS Code拡張機能UIの概要

この記事では、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 で VEX プロジェクトを開発する際によく使用されるアイコンは次のとおりです。

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

サイドバー

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

拡張ビュー

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

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

VEXビュー

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

• プロジェクトアクション
  プロジェクトアクション の下のボタンは、新しい VEX プロジェクトを作成したり、既存の VEXcode プロジェクトをインポートしたりするために使用されます
  VS Code で VEX プロジェクトを作成する詳細なガイダンスについては、 V5 についてはこの記事、 EXP についてはこの記事、 IQ (2nd) についてはこの記事を参照してください。

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

  

  
  このカテゴリは、接続されている VEX デバイスの種類を示し、Brain システム、シリアル ポート、ダウンロードされたプログラム、および VEX Brain のスマート ポートに接続されているデバイスの情報を表示します。 これにより、 VEX Brain 画面のスクリーンショットを撮る、 VEX Brain イベントログを表示する、 V5 Battery Medic を使用する、 ブレイン名を設定する および チーム番号を設定する、および VEX Brain からユーザープログラムを消去する。
  
  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 を使用する方法については、 こちらの記事を参照してください。
  
  

エクスプローラービュー

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

エディタ

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

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

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

端子パネル

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

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

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

  

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

ツールバー

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

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

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

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

• デバイス ピッカー - デバイス ピッカーには、接続されている VEX デバイスのアイコン (ブレイン アイコン またはコントローラ アイコン ) が表示されます
  注: コントローラがコンピューターに接続されているが、ブレインとの無線リンクがない場合は、コントローラ アイコンの横にブレイン名は表示されません。

• スロット セレクター アイコン - スロット セレクター アイコン を使用すると、それをクリックして選択リストから VEX Brain 上の 8 つの利用可能なスロットの 1 つを選択することで、VEX Extension がユーザー プログラムをダウンロードまたは再生するスロットを選択できます。
• ビルド & ダウンロード アイコン - VEX デバイスが接続されている場合、 ダウンロード アイコン ツールバーに表示されます。 クリックすると、プロジェクトがビルドされ、成功した場合は接続されている VEX デバイスにダウンロードされます。
• 再生アイコン - クリックすると、 再生アイコン は、VEX Brain の選択されたスロットにダウンロードされたユーザー プログラムを実行します。
• 停止アイコン - クリックすると、 停止アイコン VEX Brain 上のユーザー プログラムの実行が停止します。
• プロジェクトセレクター - プロジェクトセレクター には、選択したプロジェクトの名前が表示されます。 プロジェクト セレクター アイコン を使用すると、ワークスペース内に複数の VEX プロジェクトが存在する場合に、それをクリックして選択リストからプロジェクトを選択することで、VEX プロジェクトを切り替えることができます。
• Python ファイル セレクター (Python のみ) - VEX Python プロジェクトを選択すると、 Python ファイル セレクター ツールバーに表示されます。 Python ファイル セレクター には、選択した Python ファイルの名前が表示されます。 Python for VEX は現在、単一ファイルのダウンロードのみをサポートしています。

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

VEXユーザー設定

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

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

• コントローラ チャネル (V5 コントローラのみ) - V5 コントローラの無線チャネルを ダウンロード、 または ピットに設定します。 この設定は、VEXnet 無線リンクにのみ適用されます。

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

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