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 2nd Generation、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 Brain または 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 バージョンが古い場合は、VEX Brain の VEXos 更新できます。
  
  VEX Controller がコンピューターに接続されている場合、 VEX DEVICE INFO カテゴリには、VEX Brain が VEX コントローラーにリンクされているかどうかが表示され、VEX Controller の VEXos バージョンが古い場合は、VEX Controller の 更新できます。
  
  デバイス情報の包括的な説明と、 VEX DEVICE INFOの機能の使用方法については、 こちらの記事をご覧ください。

• VEX フィードバック
  VEX フィードバック の下のテキスト ボックスにメッセージを入力し、 送信 ボタンをクリックすると、VEX にフィードバックを送信できます。
  VS Code で VEX フィードバック 使用する方法については、 この記事を参照してください。
  
  

エクスプローラービュー

エクスプローラー ビュー 、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 ユーザー設定にアクセスして設定する方法についての役立つ情報については、 この記事をご覧ください。