在遠端主機上搭配安全殼層 (SSH) 使用Visual Studio Code

Visual Studio Code可用於 Azure 球體 SDK，透過安全殼層 (SSH) 在遠端主機上建立和偵錯程式碼。支援兩個案例：

不支援第三個案例，也就是遠端電腦上的本機電腦和裝置上的程式碼。

設定本機電腦

下載並安裝Visual Studio Code。
安裝適用于 Windows 或 Linux的 Azure 球體 SDK。
在 Visual Studio Code 擴充功能面板中搜尋 Azure 球體，然後按一下 [安裝]，以安裝 Azure 球體擴充功能。

提示

有兩 Azure Sphere 個擴充功能，其中一個擴充功能將同時安裝：UI 元件的 Azure 球體 UI ，以及工作區元件的 Azure 球體 。
在Visual Studio Code擴充功能面板中搜尋 Remote-SSH，然後按一下 [安裝] 按鈕，以安裝 Remote-SSH 擴充功能。

透過 USB 將裝置連接到本機電腦。
如果遠端電腦上還沒有專案，您可以複製樣本存放庫，或從 Microsoft 範例瀏覽器取得單一專案。
在本機開啟Visual Studio Code。
僅第一次：從 [檢視>] 命令調色盤>Remote-SSH 開啟Visual Studio Code：新增 SSH 主機，並在系統提示時輸入 SSH 主機資訊。 (根據預設，名為 config 的檔案會寫入您家庭目錄中的 .ssh 目錄。如果您的本機電腦是 Windows，有時會造成許可權問題。您可能會想要將檔案移到另一個目錄，並在 [檔案>喜好設定>> ] 中指定 [遠端->SSH：設定檔案.)

執行 Visual Studio Code 命令檢視>Command Palette>Remote-SSH：連線到主機 (Shift+Ctrl+P) ，以連線到遠端電腦。
在Visual Studio Code擴充功能面板中搜尋 Azure 球體，然後按一下 [在 SSH 中安裝]：[遠端名稱]按鈕，將 Azure 球體擴充功能安裝到遠端電腦。安裝之後，您可能需要重新開機Visual Studio Code並重新連線到遠端電腦。

提示

若要檢查遠端電腦上的擴充功能是否正確安裝，請清除擴充功能面板中的搜尋方塊，並確定 Azure Sphere 擴充功能出現在 SSH 中：[遠端名稱] - 已安裝 檢視。
使用 [開啟舊檔檔夾] 或 [開啟舊檔]工作區開啟專案檔>>夾或工作區。

按 F5 以建立及偵錯專案。如果專案先前尚未建立，或是檔案已變更且需要重建，Visual Studio Code會在偵錯開始之前建立專案。
等候數秒Visual Studio Code來建立應用程式、建立影像套件、部署到白板，然後以偵錯模式啟動。一路走來，您會在 [ 輸出 ] 窗格中看到狀態更新。

首先，CMake 會判斷是否需要建立應用程式。若是如此，焦點會移至輸出視窗，顯示來自 CMake/Build 的輸出。

接下來，[ 輸出 ] 窗格會在影像套件部署到裝置時顯示結果。最後，偵錯主機會接收焦點，並顯示偵錯工具輸出。

使用Visual Studio Code偵錯工具來設定中斷點、暫停、重迭、步入、重新開機或停止應用程式。

透過 USB 將裝置連接到遠端電腦。
如果遠端電腦上還沒有專案，您可以複製樣本存放庫，或從 Microsoft 範例瀏覽器取得單一專案。
在本機開啟Visual Studio Code。
僅第一次：從 [檢視>] 命令調色盤>Remote-SSH 開啟Visual Studio Code：新增 SSH 主機，並在系統提示時輸入 SSH 主機資訊。 (根據預設，名為 config 的檔案會寫入您家庭目錄中的 .ssh 目錄。如果您的本機電腦是 Windows，有時會造成許可權問題。您可能會想要將檔案移到另一個目錄，並在 [檔案>喜好設定>> ] 中指定 [遠端->SSH：設定檔案.)

執行 VS 程式碼命令 [檢視>命令調色盤>遠端 SSH：連線至主機 () Shift+Ctrl+P ，以連線到遠端電腦。
執行 VS 程式碼命令檢視>命令調色盤>喜好設定來新增遠端設定：開啟 [遠端設定]，並將下欄欄位新增至 JSON 物件 (如果是空白檔案，您必須將此 {} 專案換成) ：
```
    "remote.extensionKind": {
        "ms-vscode.azure-sphere-tools-ui": [
            "workspace"
        ]
    }
```
視專案和小組的設定而定，您可以改為將此設定新增至使用者/工作區設定。
在Visual Studio Code擴充功能面板中搜尋 Azure 球體，然後按一下 [在 SSH 中安裝]：[遠端名稱]按鈕，將 Azure 球體擴充功能安裝到遠端電腦。安裝之後，您可能需要重新開機Visual Studio Code並重新連線到遠端電腦。

提示

若要檢查遠端電腦上的擴充功能是否正確安裝，請清除擴充功能面板中的搜尋方塊，並確定 Azure Sphere 擴充功能出現在 SSH 中：[遠端名稱] - 已安裝 檢視。
使用 [開啟舊檔檔夾] 或 [開啟檔案] 工作區來開啟專案檔案 >>夾或工作區。

按 F5 以建立及偵錯專案。如果專案先前尚未建立，或是檔案已變更且需要重建，Visual Studio Code會在偵錯開始之前建立專案。
等候數秒Visual Studio Code來建立應用程式、建立影像套件、部署到白板，然後以偵錯模式啟動。一路走來，您會在 [ 輸出 ] 窗格中看到狀態更新。

首先，CMake 會判斷是否需要建立應用程式。若是如此，焦點會移至輸出視窗，顯示來自 CMake/Build 的輸出。

接下來，[ 輸出 ] 窗格會在影像套件部署到裝置時顯示結果。最後，偵錯主機會接收焦點，並顯示偵錯工具輸出。

使用Visual Studio Code偵錯工具來設定中斷點、暫停、重迭、步入、重新開機或停止應用程式。

若要結束遠端偵錯會話，請選取[關閉檔案>遠端連線]。