本文概述了 VEX Visual Studio 程式碼擴充 UI（使用者介面）。 此擴充支援為 VEX IQ 第二代、EXP 和 V5 平台開發 C++ 和 Python 專案。
使用者介面組件
VEX VS Code 擴充功能有 3 個主要組件。
- 工具列
- 活動欄和側欄
- 端子麵板
工具列
此工具列為使用者提供了與 VEX VS Code 擴充項目 VEX Brains 和 VEX Controller 互動的快速方式。 只有在 VS Code中開啟有效的 VEX 專案時，工具列才會處於活動狀態。 有效的 VEX 專案是由擴充功能建立或匯入的專案。 開啟 VEXcode 或 VEXcode Pro 專案無效，需要匯入。
裝置選擇器
設備選擇器有兩個主要功能。 首先，它顯示代表連接的 VEX 裝置類型的大腦或控制器圖示。
其次，當單擊設備列表圖示時，會出現快速選擇列表，其中包含所有已連接的 VEX 設備。 使用者可以選擇分機將連接到哪個裝置。
目前連接的裝置將始終顯示在清單頂部，然後是按裝置類型（大腦或控制器）和平台（IQ 第二代、EXP 和 V5）排序的所有其他裝置。
每個設備項目包含 Brain 名稱、平台、設備類型和設備路徑資訊。
重要的
如果控制器連接到計算機，但沒有到大腦的無線電鏈路，則列表項目或設備列表狀態列圖示旁邊不會顯示大腦名稱。
插槽選擇器
插槽選擇器圖示允許使用者選擇擴充功能將在哪個插槽上下載或播放使用者程式。
當您按一下插槽選擇器圖示時，將出現快速選擇列表，其中包含可用的使用者程式插槽 1-8。
建置/下載
如果連接了 VEX Brain 或 VEX 控制器，建置/下載圖示會變更功能。
如果未連接 VEX 設備，則會顯示建置圖示。 單擊後，只會建置該項目。
如果連接了 VEX 設備，則會顯示下載圖示。 點擊後，將建置項目，如果成功，將下載到 VEX 設備。
玩
點擊播放圖示後，將運行所選插槽中的使用者程式。
停止
點選停止圖示可停止使用者程式。
選定的工作空間
VS Code 支援多工作區專案。 當工作區內存在多個 VEX 項目時，項目選擇器可讓使用者在 VEX 項目之間切換。
當您按一下項目選擇器圖示時，將出現一個包含所有有效項目的快速選擇清單。
重要
如果項目無效，則不會顯示在項目快速選擇清單中。 除非由 VEX VS Code 擴充功能建立或匯入，否則項目無效。
Python 檔案選擇器（僅限 Python）
當選擇 VEX python 專案時，python 檔案選擇器將出現在工具列中。 Python for VEX 目前僅支援單一檔案下載。
當圖示時，將出現一個快速選擇列表，其中包含位於工作區目錄中的所有 python 檔案。
python 檔案選擇器允許使用者在 python 來源檔案（.py）之間切換
VEX 活動欄和側邊欄
項目 行動
vex 活動列包含項目操作視圖和 VEX 設備資訊視圖。
專案操作視圖用於建立新專案或匯入現有的 VEXcode 或 VEXcode Pro 專案。
有關創建新項目的更多信息，請查看 這篇文章！
版本資訊也顯示在視圖的左下角和右下角。
重要
如果 VEXcode 或 VEXcode Pro 項目在編輯器中打開，則它將不會被視為有效的 VEX 項目，需要使用 VEX 側邊欄中的匯入按鈕匯入該項目。
VEX 設備資訊
VEX 設備資訊視圖為使用者提供了所連接的 VEX Brain 或 VEX 控制器的概覽。 VEXos版本、串列路徑、使用者程式、裝置資訊都可以在該檢視中找到。 其他功能，如 VEXos 韌體更新、螢幕截圖、設定大腦名稱和設定團隊編號也可以透過此視圖執行。
系統資訊
系統資訊提供了所連接的 VEX 設備的簡要概述。 這包括裝置的 VEXos 版本、Brain 名稱、團隊編號、Brain ID 和 python 運行時版本資訊。
串口資訊
序列埠資訊顯示可用於 VEX 設備的每個連接埠的設備路徑。 大多數 VEX 設備枚舉為兩個序列埠。 通訊串口用於下載程式和控制大腦功能。 使用者序列埠用於在 Brain 上執行的使用者應用程式和透過 USB 連接的主機之間傳輸資料。 V5 控制器是唯一隻有通訊串列埠而沒有使用者序列埠的 VEX 設備。
節目資訊
程式資訊顯示 VEX Brain 上所有下載的使用者程式的清單。
每個程式清單項目都可以展開以顯示有關每個使用者程式的附加信息，例如插槽位置、檔案名稱、語言類型、檔案大小和下載時間。
設備資訊
設備資訊顯示連接到 VEX Brain 的所有智慧型連接埠設備的清單。 每個清單項目顯示智慧型連接埠號碼和裝置類型。
每個設備清單項目都可以展開以顯示有關每個智慧型連接埠設備的韌體版本資訊。
連接到 VEX Brain Device 時會顯示控制器連結狀態。
VEX Brain 連接到 VEX 控制器
VEX Brain 未連結至 VEX 控制器
VEX V5 控制器連接到 VEX V5 Brain
螢幕截圖
透過點擊相機圖標，使用者可以從 VEX Brain 拍攝並下載螢幕截圖。
螢幕截圖僅在透過 USB 直接連接到 VEX Brain 時可用
電池醫生（僅限 V5 Brain）
透過點擊“心臟”圖標，擴展程式將下載並運行電池醫生用戶程式。
設定大腦名稱
透過點擊 system->名稱旁邊的鉛筆圖標，使用者可以設定 VEX Brain 的名稱。
點擊鉛筆圖示後，VS Code 編輯器頂部會出現一個輸入框。 在輸入框中輸入新的大腦名稱，然後按回車鍵進行設定。
設定隊伍號碼
透過點擊 system->團隊旁邊的鉛筆圖標，使用者可以設定 VEX Brain 的團隊編號。
點擊鉛筆圖示後，VS Code 編輯器頂部將出現一個輸入框。 在輸入框中輸入新的隊伍號碼，然後按下回車鍵設定。
擦除使用者程式
透過點擊程式>項目名稱旁邊的 垃圾桶 圖標，使用者可以刪除特定插槽中的程式。 重要，一旦刪除程序，就無法恢復。 使用此功能時請謹慎。
設備資訊警告
VEXos 更新
當 VEX Brain 的 VEXos 版本過時時，VEXos 版本旁邊會出現警告訊息圖標，並且兩個 Brain 圖標都會變成黃色。
若要解決此警告，使用者應更新其 VEXos Brain 的 VEXos。
可以透過點擊 VEX Brain 圖示旁的向上箭頭來更新 VEXos。
當 VEXos 過時時，VS Code 編輯器的右下角也會出現一個通知框。 使用者可以透過點擊「更新」按鈕啟動 VEXos 更新，也可以按一下「忽略」按鈕跳過 VEXos 更新。
大腦未連接至已連接的控制器
當 VEX 控制器連接到電腦但未連結到 VEX Brain 時，VEX 控制器圖示將變為黃色。
若要解決此警告，使用者應將 VEX 控制器連結到 VEX Brain
端子麵板
VEX VS Code 擴充功能在啟動時提供兩個終端，日誌終端和互動終端
日誌終端
日誌終端顯示建置輸出、建置錯誤和下載結果。
互動終端
互動式終端有兩個功能，顯示 printf 日誌和將原始擊鍵傳回使用者程式。 為了利用互動終端，大腦或控制器必須連接到執行 VEX VS 程式碼擴充的電腦。 建置並下載使用者程式後，預設會清除互動式終端輸出。
使用者設定
使用者設定是 Visual Studio Code 為每個擴充功能提供的全域設定。 使用者設定適用於每個 VEX VS Code 擴充項目。
如何存取 VEX 使用者設定
點擊 VS Code 左上角的齒輪，將出現一個上下文選單
在上下文選單中，按一下「設定」項，將出現一個設定頁面。
在左側清單檢視中，按一下「擴充」項目。 接下來，向下捲動到底部並找到標有“VEX”的項目。
按一下“VEX”清單項目。
VEX 使用者設定將出現在右側面板。
設定概覽
控制器通道（僅限 V5 控制器）
控制器通道 設定控制 V5 Brain 和 V5 控制器之間的無線電通訊通道類型。
此設定僅適用於 VS Code 透過 USB 連接到 V5 控制器且控制器透過 VEXnet 連接到 V5 Brain 的情況。 使用者可在 下載 和 坑 頻道之間進行選擇。 設定為 Download時，一旦啟動使用者程式下載，無線電將跳到下載 VEXnet 通道。 下載通道允許更高的資料速率和更有效率的下載。 當設定為 Pit時，收音機將保留在坑頻道上，並且下載將花費更長的時間。 預設情況下，此設定設定為 下載。
Cpp專案SDK主頁
請勿編輯此設定。
Cpp 工具鏈路徑
Cpp Toolchain Path 設定建置 C++ VEX VS Code 專案時所使用的工具鏈的路徑。
啟用使用者終端
啟用用戶終端 設定允許分機在偵測到 VEX Brain 或 VEX 控制器時開啟使用者序列埠。 唯一的例外適用於不枚舉使用者序列埠的 V5 控制器。
啟用 允許擴充功能在啟動時連接到使用者連接埠並將建立互動式終端。 如果在擴充功能運行時選擇啟用，則擴充功能將在連接裝置時嘗試開啟使用者連接埠。
禁用 阻止擴充功能在啟動時連接到使用者端口，並且不會建立互動終端。 如果在擴充功能運行時選擇停用，則擴充功能將關閉使用者連接埠並刪除互動式終端。
專案建置類型
專案建置類型 設定擴充如何建置 C++ 專案。 使用者可以將建置類型設定為“建置”或“重建”。
Build 僅當 Make 偵測到專案原始碼中的任何變更時才建置專案。
Rebuild 清理專案的建置目錄，然後建置專案。 此選項通常要慢得多。
項目首頁
專案主目錄 完成新建專案精靈時設定新專案的預設主目錄。
下載後運行
下載後執行 啟用後，會導致使用者程式在下載到 VEX Brain 後執行。
Python SDK 首頁
請勿編輯此設定。
VEX 指令幫助
VEX 命令可協助允許存取 C++ 和 Python API（應用程式介面）中包含的特定函數的文件。 文件特定於每個 VEX 平台（IQ 第二代、EXP、V5）。
若要存取 VEX 命令協助，請先反白顯示要搜尋的函數的文字。
右鍵單擊所選文本，將出現上下文選單。
下一步 按一下 VEX 命令說明以存取文件。
如果 VEX Command Help 找到完全符合的內容，則會出現一個新的 Web 視圖以及相關文件。
如果多個文件與所選文字匹配，則會出現一個下拉列表，其中包含相關文件的篩選列表。