本文概述了 VEX Visual Studio 程式碼擴充 UI(使用者介面)。 此擴充支援為 VEX IQ 第二代、EXP 和 V5 平台開發 C++ 和 Python 專案。
VEX VS Code 擴充 UI 佈局
VEX Visual Studio Code 擴充 UI 分為五個主要區域:活動列、側邊欄、編輯器、終端面板和工具列。
活動欄
活動欄具有一系列圖標,可讓我們在視圖之間切換,並為我們提供用於 VEX 專案開發的附加上下文特定指示器。
在 VS Code 中開發 VEX 專案的常用圖示有:
-
資源管理器檢視圖示 - 點選後, 資源管理器視圖 將在側邊欄中開啟。
-
擴充視圖圖示 - 點選後, 擴充視圖 將在側邊欄中開啟。
-
VEX 視圖圖示 - 點選時, VEX 視圖 在側邊欄中開啟。
側邊欄
側欄包含不同的視圖,使我們能夠使用 VS Code 中的整合工具。 用於執行 VEX 專案開發任務的常見側欄視圖有 擴展視圖 視圖和 資源管理器視圖。
擴展視圖
擴充視圖 用於安裝和管理 VS Code 中的擴充。 為了在VEX IQ第二代、EXP和V5平台上開發軟體,我們需要安裝VEX擴充、C/C++擴充和Python擴充。
有關如何在 VS Code 中安裝 VEX 擴充功能、 C/C++ 擴充功能和 Python 擴充功能 逐步說明,請查看 這篇文章。
VEX視圖
VEX View 使我們能夠在 VS Code 中開發 VEX IQ 第二代、EXP 和 V5 專案。 VEX 視圖中包含三個類別: 項目操作、VEX 設備資訊、 和 VEX 回饋。
-
PROJECT ACTIONS
PROJECT ACTIONS 下的按鈕用於建立新的 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 中刪除使用者程式大腦.
當 VEX Brain 連接到電腦時, VEX DEVICE INFO 類別顯示 VEX 控制器是否連結到 VEX Brain,並允許我們更新 VEX Brain 的 VEX Brain 的 VEXos 版本是已經過時了。
當 VEX 控制器連接到電腦時, VEX 設備資訊 類別會顯示 VEX Brain 是否連結到 VEX 控制器,並允許我們更新 VEX 控制器的 如果 VEX 控制器的 VEXos 版本是已經過時了。
有關設備資訊的全面說明以及如何使用 VEX DEVICE INFO下的功能,請查看 這篇文章。
-
VEX FEEDBACK
我們可以透過在 VEX FEEDBACK 下的文字方塊中輸入訊息並點擊 SEND 按鈕來向 VEX 提交回饋。
有關在 VS Code 中使用 VEX FEEDBACK 的有用信息,請參閱 本文。
資源管理器視圖
Explorer View 用於瀏覽、開啟和管理 VS Code 中的 VEX 專案檔案和資料夾。
編輯
編輯器是 VS Code 中編輯文件的主要區域。 VEX VS 程式碼擴充功能在編輯器區域中啟用了 C/C++ 和 Python 的 Intellisense/Linting,以幫助我們開發程式。
在編輯器區域中,我們可以透過將滑鼠懸停在函數文字上或使用 VEX 命令幫助 訪問C++ 和Python API(應用程式介面)中包含的該函數的文檔來獲取有關特定函數的有用信息。 )。
有關在 VS Code 中使用 VEX 指令幫助 詳細說明,請參閱 本文。
端子麵板
VEX VS Code Extension 在啟動時提供兩個終端:日誌終端機和互動終端。
-
誌終端 - 日誌終端機顯示建置輸出、建置錯誤和下載結果。
-
互動式終端 - 互動終端機有兩個功能 - 顯示列印日誌和將原始擊鍵傳回使用者程式。
注意: 要使用互動終端,大腦或控制器必須連接到執行 VEX VS Code 擴充的電腦。
注意: 建置和下載使用者程式後,預設會清除互動式終端輸出。
工具列
工具列具有一系列圖標,為我們提供了與 VEX VS Code 擴展項目、VEX Brains 和 VEX 控制器互動的快速方式。
注意: 僅在 VS Code 中開啟有效的 VEX 專案時,工具列才會處於活動狀態。
注意: 有效的 VEX 專案是由擴充功能建立或匯入的專案。 在編輯器中開啟的 VEXcode 或 VEXcode Pro 專案不會被視為有效的 VEX 項目,需要匯入。
工具列上的圖示包括:
-
設備選擇器 - 設備選擇器顯示所連接的 VEX 設備的圖示(大腦圖示
或控制器圖示
)
注意: 如果控制器已連接到計算機,但沒有與計算機的無線電鏈接大腦,控制器圖示旁邊不會顯示大腦名稱。
-
插槽選擇器圖示 - 插槽選擇器圖示 允許我們選擇VEX 擴充功能將在哪個插槽上下載或播放使用者程序,方法是點擊該插槽並從選擇清單中選擇VEX Brain 上的八個可用插槽之一。
-
建置圖示 - 如果未連接 VEX 設備, 建置圖示 將顯示在工具列上。 單擊後,只會建置該項目。
-
下載圖示 - 如果連接了 VEX 設備, 下載圖示 將顯示在工具列上。 點擊後,將建置項目,如果成功,將下載到連接的 VEX 裝置。
-
播放圖示 - 點擊時, 播放圖示 將在 VEX Brain 上選定的插槽中執行下載的使用者程式。
-
停止圖示 - 點擊時, 停止圖示 停止執行 VEX Brain 上的使用者程式。
-
項目選擇器 - 項目選擇器 顯示所選項目的名稱。 當工作區內存在多個 VEX 項目時, 項目選擇器圖示 允許我們透過點擊它並從選擇清單中選擇一個項目來在 VEX 項目之間進行切換。
-
Python 檔案選擇器(僅限 Python) - 當選擇 VEX Python 專案時, Python 檔案選擇器 將出現在工具列中。 Python 檔案選擇器 顯示所選 Python 檔案的名稱。 Python for VEX 目前僅支援單一檔案下載。
有關如何使用 VS Code 中的工具列功能的有用信息,請查看 這篇文章。
VEX 使用者設定
VEX 使用者設定允許我們根據自己的要求配置 VEX 分機。 使用者設定是套用於每個 VEX VS Code 擴充項目的全域設定。 我們可以透過點擊 VS Code 中的「設定」圖示並在選單中選擇相應的項目來存取 VEX 使用者設定。
用於配置 VEX VS 程式碼擴充的 VEX 使用者設定為:
- 控制器通道(僅限 V5 控制器) - 將 V5 控制器無線電通道設定為 下載 或 Pit。 此設定僅適用於 VEXnet 無線電連結。
- Cpp 工具鏈路徑 - 設定 CPP 工具鏈的路徑。
- 啟用用戶終端- 啟用或停用擴充功能以開啟和顯示來自用戶連接埠的資料。
- 誌條目 - 設定從 VEX Brain 上傳的日誌條目數。
- 專案建置類型 - 設定擴充如何建置 C++ 專案。
- 項目主頁 - 設定新項目的預設位置。
- 下載後運行 - 設定使用者程式是否應在下載到 VEX Brain 後運行。
- 系統 DFU 自動恢復 - 設定在 DFU 模式下偵測到 IQ2 或 EXP 時 Brain 是否應自動恢復。
- Websocket 伺服器啟用 - 啟用或停用擴充功能以啟動 Websocket 伺服器。
- Websocket 伺服器主機位址 - 設定 Websocket 伺服器的主機位址。
- Websocket 伺服器連接埠 - 設定 Websocket 伺服器連接埠號
有關如何存取和設定 VEX 使用者設定的有用信息,請查看 這篇文章。