VS Code Overview

Visual Studio Code Basics and the WPILib Extension VS Code基礎及WPILib延伸集

微軟的VS Code是FRC競賽時支援C++和Java的IDE套件,本主題介紹一些VS Code的基本操作和WPILib的延伸集。

Welcome Page 歡迎頁

English Version

Chinese Version

頁面提供許多可以自訂的連結,能快速執行動作,也有相關說明文件與示範影片。

請注意右上角有一個小的六角形W符號,他是唯一通往WPI延伸集的通道。

WPILib Commands in Visual Studio Code WPI 在VS Code裡的命令列

底下是由WPI提供的完整命令列表。

WPILib: Build Robot Code - 建立使用GradleRIO的開放專案。

WPILib: Create a new project - 創立一個新的機器人專案。

WPILib C++: Refresh C++ Intellisense - 強制更換為C++ Intellisense設定。

WPILib C++: Select Current C++ Toolchain - 選擇工具鏈來用Intellisense(例如:桌面對roboRIO),等於以目前狀態點擊右下角狀態列。

WPILib C++: Select Enabled C++ Intellisense Binary Types - 切換Intellisense之下靜態、分享、可執行三種模式。

WPILib: Cancel currently running tasks - 取消任何WPI目前正在執行的工作。

WPILib: Change Auto Save On Deploy Setting - 改變為是否自動存檔,內定是已啟動。

WPILib: Change Auto Start RioLog on Deploy Setting - 改變為是否自動紀錄,內定是自動紀錄。

WPILib: Change Desktop Support Enabled Setting - 改變為是否啟用在桌面上建立機器人程式,此功能用於測試和模擬,

User Interface 使用者介面

重要的連結應該是基本使用文件,該文件指出許多基本的UI操作、主要訊息為如何開始VS Code用於FRC。

Command Palette 命令列(調色盤?)

Creating a Robot Program 建立機器人程式

安裝好軟體之後,就可以準備建立機器人程式啦。WPILib為我們準備了一些暫時的機器人程式,強烈建議初學者必用,進階玩家就自由發揮吧。

Choosing a Base Class 選定一個基類

專案可以始於WPILib提供的機器人程式,首先必須選擇一個基類,使用者可在這個控制程式流程基類之下建立主要機器人子類別。有三種基類可供選擇:TimedRobot、RobotBase、Command Robot。

TimedRobot 定時機器人基類

Java文件Java原始碼

TimedRobot類別推薦給大部分使用者當基類,他提供如init([初始化]),periodic([定期的]),exit([離開])的方法來控制機器人,於特殊狀態被WPI所呼叫使用(例如:自主或遠端操作時),呼叫期間、程式碼會輪流讀取設備數據並採取行動,例如,確定搖桿位置和按下按鈕,此基類亦提供透過SendableChooser的程序。

每20毫秒會呼叫periodic()方法一次,可以透過呼叫superclass constructor來改變執行頻率。

危險:改變執行頻率會導致迴圈溢位執行意外,你可以選擇使用Notifiers來重新規劃執行頻率(?)

RobotBase 機器人基地基類

Java文件Java原始碼

RobotBase類別提供一個最小的基類,通常不建議直接拿來當基類使用。它並未提供控制機器人的流程且都必須透過startCompetition()方法來寫。

RobotBase Skeleton 會提供一個空白的startCompetition()方法。

Command Robot 命令機器人

命令基礎程式教學




3rd Party Libraries 第三方套件

Building and Deploying Robot Code 建造、佈署機器人程式

Viewing Console Output 檢視螢幕輸出

Debugging a Robot Program 機器人程式除錯

Importing a Grandle Project 導入Grandle專案