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

V5 の VS Code 拡張インターフェースのスクリーンショット。開発者がコーディング エクスペリエンスを向上させるために利用できる機能とツールを紹介します。

UIコンポーネント

VEX VS コード拡張には 3 つの主要なコンポーネントがあります。

  1. ツールバー
  2. アクティビティバーとサイドバー
  3. 端子パネル

ツールバー

ツールバーを使用すると、ユーザーは VEX VS Code 拡張プロジェクト、VEX Brains、および VEX コントローラーを簡単に操作できます。 ツールバーは、有効な VEX プロジェクトが VS Codeで開かれている場合にのみアクティブになります。 有効な VEX プロジェクトは、拡張機能によって作成またはインポートされたプロジェクトです。 VEXcode または VEXcode Pro プロジェクトを開くことは無効なので、インポートする必要があります。

V5 の VS Code 拡張機能インターフェースのスクリーンショット。開発者が利用できる機能とツールを紹介し、簡単にナビゲートして使用できるようにセクションが強調表示されています。

デバイスピッカー

V5 の VS Code 拡張インターフェースのスクリーンショット。ユーザーが開発エクスペリエンスを向上させるために利用できる機能とツールを紹介しています。

デバイス ピッカーには 2 つの主な機能があります。 まず、接続されている VEX デバイスのタイプを表すブレインまたはコントローラーのアイコンが表示されます。

VEX Robotics プラットフォームを使用する開発者が利用できる機能とツールを紹介する、V5 VS Code 拡張機能インターフェースのスクリーンショット。

次に、デバイス リスト アイコンをクリックすると、接続されているすべての VEX デバイスを含むクイック ピック リストが表示されます。 ユーザーは、拡張機能が接続するデバイスを選択できます。
現在接続されているデバイスは常にリストの先頭に表示され、その後に他のすべてのデバイスがデバイス タイプ (ブレインまたはコントローラー) およびプラットフォーム (IQ 第 2 世代、EXP、および V5) ごとに並べ替えられて表示されます。

開発ワークフローを強化するために利用できる機能とツールを紹介する、V5 の VS Code 拡張インターフェースのスクリーンショット。

各デバイス項目には、ブレイン名、プラットフォーム、デバイス タイプ、およびデバイス パスの情報が含まれています。

V5 用の VS Code 拡張機能のスクリーンショット。コーディング効率と V5 開発のサポートを強化するために設計されたインターフェイスと機能を紹介します。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペット、デバッグ オプション、プロジェクト管理機能など、開発者が利用できる機能とツールを紹介しています。

重要

コントローラがコンピュータに接続されているが、ブレインへの無線リンクがない場合、リスト項目またはデバイス リストのステータス バー アイコンの横にブレイン名は表示されません。

スロットセレクター

V5 VS Code 拡張機能インターフェースのスクリーンショット。コード スニペットやデバッグ オプションなど、V5 開発に使用できる機能とツールを紹介しています。

スロット セレクター アイコンを使用すると、拡張機能がユーザー プログラムをダウンロードまたは再生するスロットを選択できます。

V5 用の VS Code 拡張インターフェースのスクリーンショット。コード スニペットやプロジェクト管理オプションなど、V5 開発に使用できる機能とツールを紹介しています。

スロット セレクター アイコンをクリックすると、利用可能なユーザー プログラム スロット 1 ~ 8 を含むクイック ピック リストが表示されます。

ビルド/ダウンロード

V5 の VS Code 拡張インターフェースのスクリーンショット。生産性とコード管理の向上に重点を置いた、開発者が利用できる機能とツールを紹介します。V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集オプションやプロジェクト管理機能など、開発者が利用できる機能とツールを紹介しています。

VEX Brain または VEX コントローラーが接続されている場合、Build/Download アイコンの機能が変わります。

V5 の VS Code 拡張インターフェースのスクリーンショット。生産性とコード管理の向上に重点を置いた、開発者が利用できる機能とツールを紹介します。

VEX デバイスが接続されていない場合は、ビルド アイコンが表示されます。 クリックすると、プロジェクトがビルドされるだけです。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集オプションやプロジェクト管理機能など、開発者が利用できる機能とツールを紹介しています。

VEX デバイスが接続されている場合、ダウンロード アイコンが表示されます。 クリックするとプロジェクトがビルドされ、成功すると VEX デバイスにダウンロードされます。

遊ぶ

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールや VEX ロボット統合などのユーザー インターフェイスと機能を紹介しています。

再生アイコンをクリックすると、選択したスロットでユーザー プログラムが実行されます。

停止

V5 用の VS Code 拡張インターフェースのスクリーンショット。V5 プラットフォームを使用する開発者が利用できる機能とツールを紹介しています。

停止アイコンをクリックすると、ユーザープログラムが停止します。

選択したワークスペース

V5 用の VS Code 拡張機能のスクリーンショット。開発エクスペリエンスを向上させるために設計された、コード編集ツールや V5 カテゴリ オプションなどのユーザー インターフェイスと機能を紹介します。

VS Code はマルチ ワークスペース プロジェクトをサポートします。 ワークスペース内に複数の VEX プロジェクトが存在する場合、プロジェクト セレクターを使用してユーザーは VEX プロジェクトを切り替えることができます。

V5 用の VS Code 拡張インターフェースのスクリーンショット。コード編集ツールや開発者向けのオプションなど、V5 カテゴリの説明に関連する機能と機能を紹介しています。

プロジェクト セレクター アイコンをクリックすると、すべての有効なプロジェクトを含むクイック ピック リストが表示されます。

重要
プロジェクトが有効でない場合、プロジェクトのクイック ピック リストには表示されません。 プロジェクトは、VEX VS Code 拡張機能によって作成またはインポートされない限り有効ではありません。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、開発者が利用できる機能とツールを紹介しています。

Python ファイル セレクター(Python のみ)
VEX Python プロジェクトが選択されると、Python ファイル セレクターがツールバーに表示されます。 Python for VEX は現在、単一ファイルのダウンロードのみをサポートしています。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、開発者が利用できる機能とツールを紹介しています。


アイコンをクリックすると、ワークスペース ディレクトリにあるすべての Python ファイルを含むクイック ピック リストが表示されます。
Python ファイル セレクターを使用すると、ユーザーは Python ソース ファイル (.py) を切り替えることができます。

VEX アクティビティ バーとサイドバー

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールやナビゲーション オプションなど、V5 カテゴリの説明に関連するユーザー インターフェイスと機能を紹介します。

プロジェクトのアクション

VEX ロボティクスによるコーディング エクスペリエンスを強化する機能を紹介する、V5 VS Code 拡張インターフェースのスクリーンショット。

VEX アクティビティ バーには、プロジェクト アクション ビューと VEX デバイス情報ビューが含まれています。

プロジェクト アクション ビューは、新しいプロジェクトを作成したり、既存の VEXcode または VEXcode Pro プロジェクトをインポートしたりするために使用されます。

新しいプロジェクトの作成の詳細については、 この記事をご覧ください。

バージョン情報は、ビューの左下隅と右下隅にも表示されます。

重要
VEXcode または VEXcode Pro プロジェクトがエディターで開いている場合、それは有効な VEX プロジェクトとみなされません。VEX サイドバーの [インポート] ボタンを使用してプロジェクトをインポートする必要があります。

VEX デバイス情報

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールや V5 固有の機能などのインターフェースと機能を紹介しています。Visual Studio Code の VEX V5 コード拡張インターフェースのスクリーンショット。V5 ロボット システムのプログラミングに使用できる主要な機能とオプションを紹介しています。

VEX デバイス情報ビューでは、接続されている VEX Brain または VEX コントローラーの概要がユーザーに表示されます。 VEXos のバージョン、シリアル ポート パス、ユーザー プログラム、デバイス情報はすべてこのビューで確認できます。 VEXos ファームウェアの更新、スクリーンショット、ブレイン名の設定、チーム番号の設定などの他の機能も、このビューから実行できます。

システムインフォメーション

V5 の VS Code 拡張インターフェースのスクリーンショット。V5 カテゴリの開発者が利用できる機能とツールを紹介しています。

システム情報は、接続された VEX デバイスの概要を示します。 これには、デバイスの VEXos バージョン、Brain 名、チーム番号、Brain ID、および Python ランタイム バージョン情報が含まれます。

シリアルポート情報

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペットやデバッグ オプションなど、開発者が利用できる機能とツールを紹介しています。

シリアル ポート情報には、VEX デバイスで使用可能な各ポートのデバイス パスが表示されます。 ほとんどの VEX デバイスは 2 つのシリアル ポートとして列挙されます。 通信シリアル ポートは、プログラムをダウンロードし、脳機能を制御するために使用されます。 ユーザー シリアル ポートは、Brain 上で実行されているユーザー アプリと USB 経由で接続されたホスト コンピューターの間でデータを転送するために使用されます。 V5 コントローラーは、通信シリアル ポートのみを備え、ユーザー シリアル ポートを持たない唯一の VEX デバイスです。

プログラム情報

V5 用の VS Code 拡張インターフェースのスクリーンショット。V5 プロジェクトで作業する開発者が利用できる機能とツールを紹介しています。

プログラム情報には、VEX Brain にダウンロードされたすべてのユーザー プログラムのリストが表示されます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペットや統合オプションなど、開発者が利用できる機能とツールを紹介しています。

各プログラム リストの項目を展開すると、スロットの場所、ファイル名、言語の種類、ファイル サイズ、ダウンロード時間など、各ユーザー プログラムに関する追加情報が表示されます。

デバイス情報

V5 VS Code 拡張機能インターフェースのスクリーンショット。コード スニペットや構成オプションなど、V5 開発に使用できる機能とツールを紹介しています。

デバイス情報には、VEX Brain に接続されているすべてのスマート ポート デバイスのリストが表示されます。 各リスト項目には、スマート ポート番号とデバイス タイプが表示されます。

V5 用の VS Code 拡張インターフェースのスクリーンショット。V5 プロジェクトで作業する開発者が利用できる機能とツールを紹介しています。

各デバイス リスト項目を展開して、各スマート ポート デバイスのファームウェア バージョン情報を表示できます。

VEX Brain Deviceに接続すると、コントローラーのリンクステータスが表示されます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、VEX Robotics を使用する開発者が利用できる機能とツールを紹介しています。

VEX Brain は VEX コントローラーにリンクされています

V5 用の VS Code 拡張インターフェースのスクリーンショット。V5 プラットフォームを使用する開発者に関連する機能を紹介します。

VEX Brain は VEX コントローラーにリンクされていません

V5 の VS Code 拡張インターフェースのスクリーンショット。開発者がコーディング エクスペリエンスを向上させるために利用できる主要な機能とツールを紹介しています。

VEX V5 コントローラーは VEX V5 Brain に接続されています

スクリーンショット

V5 の VS Code 拡張インターフェースのスクリーンショット。開発者がコーディング エクスペリエンスを向上させるために利用できるさまざまな機能とツールを紹介しています。

カメラ アイコンをクリックすると、ユーザーは VEX Brain からスクリーンショットを撮ってダウンロードできます。
スクリーンショットは、USB 経由で VEX Brain に直接接続した場合のみ利用可能です

バッテリーメディック (V5 Brain のみ)

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールや VEX ロボット統合オプションなどのインターフェイスと機能を紹介しています。

ハートのアイコンをクリックすると、拡張機能がバッテリーメディックユーザープログラムをダウンロードして実行します。

ブレインネームを設定する

V5 用の VS Code 拡張機能のスクリーンショット。VEX ロボット開発におけるコーディング効率とプロジェクト管理を強化するために設計されたユーザー インターフェイスと機能を紹介します。

system>名の横にある鉛筆アイコンをクリックすると、ユーザーは VEX Brain の名前を設定できます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、VEX ロボット プログラミングに使用できる機能とツールを紹介しています。

鉛筆アイコンをクリックすると、VS Code エディターの上部に入力ボックスが表示されます。 入力ボックスに新しい脳名を入力し、Enter キーを押して設定します。

チーム番号を設定する

V5 用の VS Code 拡張インターフェースのスクリーンショット。V5 プロジェクトで作業する開発者が利用できる機能とツールを紹介しています。

system->チームの横にある鉛筆アイコンをクリックすると、VEX Brain のチーム番号を設定できます。

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールや統合オプションなど、V5 カテゴリの開発に関連するユーザー インターフェイスと機能を紹介します。

鉛筆アイコンをクリックすると、VS Code エディターの上部に入力ボックスが表示されます。 入力ボックスに新しいチーム番号を入力し、Enter キーを押して設定します。

ユーザープログラムの消去

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集オプションやプロジェクト管理機能など、開発者が利用できる機能とツールを紹介しています。

プログラム>プロジェクト名の横にある ゴミ箱 アイコンをクリックすると、特定のスロットのプログラムを消去できます。 重要、一度消去したプログラムは復元できません。 この機能を使用する場合は注意してください。

デバイス情報の警告

VEXos アップデート

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集オプションや統合機能など、開発者が利用できる機能とツールを紹介しています。

VEX Brain の VEXos バージョンが古い場合、VEXos バージョンの横に警告メッセージ アイコンが表示され、両方の Brain アイコンが黄色に変わります。

この警告を解決するには、ユーザーは VEXos Brain の VEXos を更新する必要があります。

V5 の VS Code 拡張インターフェースのスクリーンショット。メニューやツール オプションなど、コーディング エクスペリエンスを強化する機能を紹介します。

VEXos は、VEX Brain アイコンの横にある上矢印をクリックして更新できます。

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールや開発エクスペリエンスを強化する統合オプションなどのユーザー インターフェイスと機能を紹介しています。

また、VEXos が古い場合は、VS Code エディターの右下隅に通知ボックスが表示されます。 ユーザーは「更新」ボタンをクリックして VEXos アップデートを開始するか、「無視」ボタンをクリックして VEXos アップデートをスキップできます。

脳が接続されたコントローラーにリンクされていません

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペットやプロジェクト管理オプションなど、開発者が利用できる機能とツールを紹介しています。

VEX コントローラーがコンピューターに接続されているが、VEX Brain にリンクされていない場合、VEX コントローラーのアイコンは黄色に変わります。

この警告を解決するには、ユーザーは VEX コントローラーを VEX Brain にリンクする必要があります。

端子パネル

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

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペットやプロジェクト管理オプションなど、開発者が利用できる機能とツールを紹介しています。

ログターミナル

V5 用の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、V5 開発に使用できる機能とツールを紹介しています。

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

インタラクティブターミナル

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、VEX ロボット開発に使用できる機能とツールを紹介しています。

インタラクティブ ターミナルには、printf ログの表示と生のキーストロークをユーザー プログラムに送信するという 2 つの機能があります。 インタラクティブ ターミナルを利用するには、VEX VS Code Extension を実行しているコンピュータに Brain または Controller を接続する必要があります。 ユーザープログラムをビルドしてダウンロードした後、対話型ターミナル出力はデフォルトでクリアされます。

ユーザー設定

ユーザー設定は、Visual Studio コードが拡張機能ごとに提供するグローバル設定です。 ユーザー設定は、すべての VEX VS Code 拡張プロジェクトに適用されます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペットやプロジェクト管理オプションなど、開発者が利用できる機能とツールを紹介しています。

VEX ユーザー設定にアクセスする方法

V5 の VS Code 拡張インターフェースのスクリーンショット。VEX ロボティクスを使用したコーディング エクスペリエンスを強化するためにユーザーが利用できる機能とオプションを紹介しています。

VS Code の左隅にある歯車をクリックすると、コンテキスト メニューが表示されます

V5 の VS Code 拡張インターフェースのスクリーンショット。V5 カテゴリの開発者が利用できる機能とツールを紹介しています。

コンテキストメニューで「設定」項目をクリックすると、設定ページが表示されます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集オプションや VEX 固有の機能など、開発者が利用できる機能とツールを紹介しています。

左側のリストビューで、「拡張機能」項目をクリックします。 次に、一番下までスクロールして「VEX」というラベルの付いた項目を見つけます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集オプションやプロジェクト管理機能など、開発者が利用できる機能とツールを紹介しています。

「VEX」リスト項目をクリックします。

V5 用の VS Code 拡張機能のスクリーンショット。ユーザー インターフェイス要素やコード スニペットなど、V5 カテゴリの説明に関連する機能が表示されています。

VEX ユーザー設定が右側のパネルに表示されます。

設定の概要

コントローラ チャネル (V5 コントローラのみ)

コントローラー チャネル 設定は、V5 Brain と V5 コントローラー間の無線通信チャネル タイプを制御します。
この設定は、VS Code が USB 経由で V5 コントローラーに接続され、コントローラーが VEXnet 経由で V5 Brain に接続されている場合にのみ適用されます。 ユーザーは、 ダウンロード チャンネルと ピット チャンネルの間で選択できます。 Downloadに設定すると、ユーザー プログラムのダウンロードが開始されると、ラジオはダウンロード VEXnet チャネルにジャンプします。 ダウンロード チャネルにより、より高いデータ レートとより効率的なダウンロードが可能になります。 Pitに設定すると、ラジオはピット チャネルに留まり、ダウンロードにかかる時間が大幅に長くなります。 デフォルトでは、この設定は ダウンロードに設定されています。

V5 用の VS Code 拡張インターフェースのスクリーンショット。V5 プロジェクトで作業する開発者が利用できる機能とツールを紹介しています。

Cpp プロジェクト SDK ホーム

この設定は編集しないでください。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、開発者が利用できる機能とツールを紹介しています。

Cpp ツールチェーンのパス

Cpp ツールチェーン パス は、C++ VEX VS Code プロジェクトを構築するときに使用されるツールチェーンのパスを設定します。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペット、デバッグ オプション、プロジェクト管理ツールなど、開発者が利用できる機能とツールを紹介しています。

ユーザー端末を有効にする

Enable User Terminal 設定では、VEX Brain または VEX コントローラーが拡張機能によって検出されたときに、拡張機能がユーザー シリアル ポートを開くことができます。 唯一の例外は、ユーザー シリアル ポートを列挙しない V5 コントローラーに適用されます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、開発者が利用できる機能とツールを紹介しています。

有効 では、拡張機能が起動時にユーザーポートに接続できるようになり、対話型ターミナルが作成されます。 拡張機能の実行中に有効が選択されている場合、拡張機能はデバイスが接続されている場合にユーザーポートを開こうとします。
無効 起動時に拡張機能がユーザー ポートに接続できなくなり、対話型ターミナルが作成されなくなります。 拡張機能の実行中に無効が選択された場合、拡張機能はユーザー ポートを閉じ、対話型ターミナルを削除します。

プロジェクトのビルドタイプ

プロジェクト ビルド タイプ は、拡張機能が C++ プロジェクトをビルドする方法を設定します。 ユーザーはビルド タイプをビルドまたはリビルドに設定できます。
ビルド Make がプロジェクトのソース コードの変更を検出した場合にのみプロジェクトをビルドします。
Rebuild 、プロジェクトのビルド ディレクトリをクリーンアップしてから、プロジェクトをビルドします。 このオプションは通常、かなり遅くなります。

V5 用の VS Code 拡張機能のスクリーンショット。V5 プロジェクトで作業するユーザーのコーディング効率を高め、開発プロセスを合理化するように設計されたインターフェイスと機能を紹介します。

プロジェクトホーム

プロジェクト ホーム は、新規プロジェクト ウィザードを完了するときに、新規プロジェクトのデフォルトのホーム ディレクトリを設定します。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード編集やデバッグ オプションなど、開発者が利用できる機能とツールを紹介しています。

ダウンロード後に実行

Run After Download を有効にすると、ユーザー プログラムが VEX Brain にダウンロードされた後に実行されます。

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールや VEX 固有の機能などのユーザー インターフェイスと機能を紹介しています。

Python SDK ホーム

この設定は編集しないでください。

V5 VS Code 拡張機能インターフェースのスクリーンショット。コード スニペットやプロジェクト管理オプションなど、V5 開発に使用できる機能とツールを紹介しています。

VEX コマンドのヘルプ

VEX コマンド ヘルプを使用すると、C++ および Python API (アプリケーション プログラミング インターフェイス) に含まれる特定の関数のドキュメントにアクセスできます。 ドキュメントは各 VEX プラットフォーム (IQ 第 2 世代、EXP、V5) に固有です。

V5 用の VS Code 拡張機能のスクリーンショット。コード編集ツールや VEX ロボット プログラミングの統合オプションなど、ユーザー インターフェイスと機能を紹介しています。

VEX コマンド ヘルプにアクセスするには、まず、検索する関数のテキストをハイライト表示します。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペットやデバッグ オプションなど、開発者が利用できる機能とツールを紹介しています。

選択したテキストを右クリックすると、コンテキスト メニューが表示されます。
次に、VEX コマンド ヘルプをクリックしてドキュメントにアクセスします。

コード スニペットやプロジェクト管理オプションなど、開発者が利用できる機能とツールを表示する、V5 の VS Code 拡張インターフェースのスクリーンショット。

VEX Command Help が完全に一致するものを見つけた場合、新しい Web ビューが関連ドキュメントとともに表示されます。

V5 の VS Code 拡張インターフェースのスクリーンショット。コード スニペットやプロジェクト管理オプションなど、開発者が利用できる機能とツールを紹介しています。

複数のドキュメントが選択したテキストと一致する場合、ドロップダウンに関連ドキュメントのフィルタリングされたリストが表示されます。

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

Last Updated: