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 Brain または VEX Controller) の概要が提供されます。

  

  
  このカテゴリは、接続されているVEXデバイスの種類を示し、ブレインシステム、シリアルポート、ダウンロードされたプログラム、およびVEXブレインのスマートポートに接続されているデバイスの情報を表示します。これにより、 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フィードバック
  VEXフィードバック 下に テキストボックスにメッセージを入力し、 送信 ボタンをクリックすることで、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 デバイスのアイコン (ブレイン アイコン またはコントローラー アイコン ) が表示されます。4
  注: コントローラーがコンピューターに接続されていても、ブレインとの無線リンクがない場合、コントローラー アイコンの横にブレイン名は表示されません。

• スロットセレクターアイコン - スロットセレクターアイコン をクリックすると、VEX 拡張機能がユーザープログラムをダウンロードまたは実行するスロットを選択できます。これは、アイコンをクリックして、選択リストから VEX Brain の 8 つの利用可能なスロットのいずれかを選択することによって行います。
•   ビルド & ダウンロード アイコン - 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 ユーザー設定にアクセスして設定する方法についての役立つ情報については、 この記事をご覧ください。