[Arduino] 使用Visual Studio Code 來取代官方IDE (Part 2-安裝)
承上一篇，底下分享安裝步驟:
STEP1.先安裝Arduino官方IDE!
沒錯! 這模組仍舊需要官方Arduino IDE的核心，所以請先確認你電腦已經安裝!
STEP2.下載並安裝VSCode。
STEP3. 打開VSCode，安裝Arduino Extension。
(1)首先，在VSCode最左邊Side Bar工具列，有五個圖示，
點最下面那個正方形圖案， 也就是「Extensions頁面」(參考下圖黃色箭頭)，
(2)然後在最上面輸入關鍵字"Arduino"，它就會自動連上網路搜尋，
接著就會跳出一整排相關的Extension，
看到第一個「Arduino for Visual Studio Code」就是了!請點選他!
(3)然後看右邊頁面，按下「install」這個小按鈕。然後重新啟動VSCode即可。
STEP4. 修改語系為繁體中文
(1)下載中文語言模組
切換到模組畫面，輸入關鍵字"tradition"，找到Chinese(Traditional) Language Pack...，
然後按install安裝。
安裝完後，原本的Install按鈕那邊，會變成Reload To Activate，
而且右下角會出現對話視窗，很貼心的問你，要不要重開，順便切換為繁體中文語系?
當然直接點選Yes就好啦!!!
重開後~~~ 上面菜單都變中文囉~
====
如果你之後還要改其他語系，
請在主畫面下，按鍵盤F1，輸入關鍵字"Display"，找到Configure Display Language這項，
編輯視窗會跳出locale.json檔案，
修改最後一行 locale:"zh-tw"，把雙引號清空""，看要改成什麼語言，它會自動跳出很多選項。
改好後按ctrl+s存檔。
把VSCODE整個關掉、重開就可以囉~
STEP5.修改設定檔
這個步驟到目前為止還是有點繁瑣，尤其是include path的設定，
如果沒設定完整，就會出現錯誤訊息"include file not found in browse.path"
類似下圖這樣:
設定檔至少有3個，分為3個層級:
1.使用者(User Settings):
這層級的設定檔存放在唯一一個settings.json檔案中，
路徑是在C:\User\使用者名稱\AppData\Roaming\Code\User底下。
2.工作區(Workspace Settings):
這層級的設定檔存放在任意一個副檔名為 *.code-workspace的檔案中，
只有主程式被手動加入一個「工作區」時才會出現。
工作區其實有點像project或solution的概念，
通常是把所有專案相關檔案新增到同一個工作區中，
在「邏輯上」湊成一包，方便開發時的管理，
但實際上各檔案可以散落在不同的實體資料夾中。
3.資料夾(Folder Settings):
這層級的設定檔會存放在主程式同一層資料夾下， 「.vscode」這個子目錄中。
==================
通常，愈下層的設定檔，會覆蓋上層的設定檔同樣內容的設定。
ex: 「資料夾層級」覆蓋「工作區層級」
===================
而Arduino 目前還會受到c_cpp_properties.json設定檔影響，
這個檔案其實是另一個C/C++ 的外掛在用的，
只要你安裝MS Arduino外掛時，它就會跟著一起被安裝!!!
(參考C/C++ for VSCODE，或是Marketplace頁面。)
但，如果你是新增一個空白的Arduino *.ino檔案，
或是把以前開發過的Arduino專案拿來VSCode修改，
一開始是不會有這個設定檔的存在。
不過，只要你選擇Arduino開發板型號時，c_cpp_properties.json這個設定檔就會自動出現，
而且跟「資料夾」層級的設定檔一樣，
也是出現在主程式同一層資料夾底下，「.vscode」這個資料夾中。
同上一段所述，這是更下層的設定檔，所以它會覆蓋最上層的使用者設定(settings.json)的內容。
這會造成一個現象，
即使你在使用者層級設定好include path或browse path，
C/C++ intellisense 動態偵測編譯沒有error了，
但你開啟Arduino檔案(*.ino)，選擇好板子之後，error又會再度出現!!!
這時就要在c_cpp_properties.json重新加入path。
通常是在該檔案中加入這一段:
"browse": {
"limitSymbolsToIncludedHeaders": false,
"path": [
"C:\\Users\\skybow\\AppData\\Local\\Arduino15\\packages\\arduino\\hardware\\avr\\1.6.21\\cores\\arduino",
"C:\\Program Files (x86)\\Arduino\\hardware\\arduino\\avr\\libraries",
"C:\\Program Files (x86\\Arduino\\hardware\\arduino\\avr\\cores\\arduino",
"C:\\Users\\使用者名稱(自己改不要照打!)\\Documents\\Arduino\\libraries"
]
}
加入完成之後，就不會再出現error訊息~
======================================================
[常用功能和命令]
1.選擇Arduino 的序列埠"
方法1=>按下方工具列，右下角有個COM的文字小區塊
方法2=>按CTRL+Shift+P，叫出「命令選擇區(Command Palette)」，在>符號後面輸入"Arduino:Select Serial Port"，按Enter
2.選擇Arduino開發板型號
方法1=>按下方工具列，右下角有個Board Config的文字區塊
方法2=>按F1，叫出「命令選擇區(Command Palette)」，在>符號後面輸入"Arduino:Board Config"，按Enter
3.編譯:
方法1=>按CTRL+Alt+R
方法2=>按F1，叫出「命令選擇區(Command Palette)」，在>符號後面輸入"Arduino:Verify"，按Enter
p.s.這邊有個提升編譯速度的方法!
編譯時，若仔細看下方除錯視窗，會看到一行如下的訊息:
這表示你沒有設定編譯檔的暫存目錄，
所以每次按下編譯+上傳時，所有相關函式庫都要重新編譯，這會造成大量時間的浪費!
因此，建議編譯前要先設定一個「編譯檔暫存目錄」；
方法如下:
找到"arduino.json"設定檔，
然後在檔案中新增底下這行，然後存檔!
這一行是在設定output資料路徑，
路徑最前面兩個點，表示「主程式所在目錄」的「上一層目錄」中，
所以根據這個路徑，VSCode就會建立一個build目錄，
然後把arduino編譯過程會連結到的相關函數編譯好，存放在裡面，
這樣下次修改程式，重新編譯上傳時，就可重複利用!省下不少時間!
根據我的實驗，至少可以節省60%的時間!! (原本31秒變成12秒!)
4.編譯且上傳:
方法1=>按CTRL+Alt+U
方法2=>按F1，叫出「命令選擇區(Command Palette)」，在>符號後面輸入"Arduino:Upload"，按Enter
5.連結Arduino，監看序列埠輸出:
這就跟官方IDE的「序列埠監控視窗」一樣，可以看到序列埠的訊息。
方法1=>最下方工具列右邊，有個「插頭形狀」的小按鈕可以按
方法2=>按F1，叫出「命令選擇區(Command Palette)」，在>符號後面輸入"Arduino:Open Serial Monitor"，按Enter
假設Arduino程式中loop()內寫了
Serial.println("Hello World!");
那就會看到底下「輸出」視窗，不斷出現這一行!
如下圖:
6.序列埠輸入:
這個就是原本官方IDE的序列埠視窗最上方，可以輸入文字訊息，透過序列埠和Arduino溝通的功能。
但他只會在VSCode最上方出現一個輸入區，讓你進行輸入，
不像Arduino官方IDE，是把序列埠的輸出和輸入整合在一個獨立浮動視窗。
方法1=>按F1，叫出「命令選擇區(Command Palette)」，在>符號後面輸入"Arduino:Send Text to Serial Port"，按Enter。
==============
P.S.
有些網路上的教學，會建議用另一個叫做「PlatformIO IDE」的外掛，它也蠻受到歡迎的。
但我覺得它會大幅更動原來的Arduino檔案結構，
譬如，主程式原本都是*.ino，它卻必須改成.cpp檔案，
這樣就無法再回到官方IDE去使用，所以我暫時不採用PlatformIO 這個Extension。
