在远端主机上搭配安全壳层 (SSH) 使用Visual Studio Code

Visual Studio Code可用于 Azure 球体 SDK，透过安全壳层 (SSH) 在远端主机上建立和侦错程式码。支援两个案例：

1.本机电脑上远端电脑和装置上的程式码。

2.远端电脑上的程式码和装置。

第一步设定电脑

下载并安装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 扩充功能。

设定远端电脑

1.我们强烈建议您 将远端电脑设定为按键型验证。

2.安装适用于 Windows 或 Linux的 Azure 球体 SDK。

本机电脑上远端电脑和装置上的程式码

1.将装置连接到本机电脑，如果本机电脑执行 Linux，请执行 azsphere_connect.sh 脚本。
2.如果远端电脑上还没有专案，您可以复制 样本存放库 ，或从 Microsoft 范例浏览器取得单一专案。
3.在本机开启Visual Studio Code。
4.仅第一次：从 [检视>] 命令调色盘>Remote-SSH 开启Visual Studio Code：新增 SSH 主机，并在系统提示时输入 SSH 主机资讯。 (根据预设，名为 config 的档案会写入您家庭目录中的 .ssh 目录。如果您的本机电脑是 Windows，有时会造成许可权问题。您可能会想要将档案移到另一个目录，并在 [档案>喜好设定>> ] 中指定 [远端->SSH： 设定档案.)

连线到远端电脑

1.执行 Visual Studio Code 命令检视>Command Palette>Remote-SSH：连线到主机 (Shift+Ctrl+P) ，以连线到远端电脑。

2.在Visual Studio Code扩充功能面板中搜寻 Azure 球体，然后按一下 [在 SSH 中安装]：[远端名称]按钮，将 Azure 球体扩充功能安装到远端电脑。安装之后，您可能需要重新开机Visual Studio Code并重新连线到远端电脑。

提示：若要检查远端电脑上的扩充功能是否正确安装，请清除扩充功能面板中的搜寻方块，并确定 Azure Sphere 扩充功能出现在 SSH 中：[远端名称] - 已安装 检视。

3.使用 [开启旧档档夹] 或 [开启旧档]工作区开启专案档>>夹或工作区。

建置、部署至本机装置和侦错

1.按 F5 以建立及侦错专案。如果专案先前尚未建立，或是档案已变更且需要重建，Visual Studio Code会在侦错开始之前建立专案。

2.等候数秒Visual Studio Code来建立应用程式、建立影像套件、部署到白板，然后以侦错模式启动。一路走来，您会在 [ 输出 ] 窗格中看到状态更新。

首先，CMake 会判断是否需要建立应用程式。若是如此，焦点会移至输出视窗，显示来自 CMake/Build 的输出。

接下来，[ 输出 ] 窗格会在影像套件部署到装置时显示结果。最后，侦错主机会接收焦点，并显示侦错工具输出。

使用Visual Studio Code侦错工具来设定中断点、暂停、重迭、步入、重新开机或停止应用程式。

远端电脑上的程式码和装置

1.透过 USB 将装置连接到远端电脑，如果远端电脑执行 Linux，请执行 azsphere_connect.sh 脚本。

2.如果远端电脑上还没有专案，您可以复制 样本存放库 ，或从 Microsoft 范例浏览器取得单一专案。

3.在本机开启Visual Studio Code。

4.仅第一次：从 [检视>] 命令调色盘>Remote-SSH 开启Visual Studio Code：新增 SSH 主机，并在系统提示时输入 SSH 主机资讯。 (根据预设，名为 config 的档案会写入您家庭目录中的 .ssh 目录。如果您的本机电脑是 Windows，有时会造成许可权问题。您可能会想要将档案移到另一个目录，并在 [档案>喜好设定>> ] 中指定 [远端->SSH： 设定档案.)

连线到远端电脑并设定远端设定

1.执行 VS 程式码命令 [检视>命令调色盘>远端 SSH：连线至主机 () Shift+Ctrl+P ，以连线到远端电脑。

2.执行 VS 程式码命令 [检视>命令调色盘>喜好设定]，新增远端设定：开启 [远端设定]，并将下栏栏位新增至 JSON 物件 (如果是空白档案，您必须将此 {} 专案换成) ：

    "remote.extensionKind": {
        "ms-vscode.azure-sphere-tools-ui": [
            "workspace"
        ]
    }

您可以根据专案和小组的设定，改为将此设定新增至使用者/工作区设定。

3.在Visual Studio Code扩充功能面板中搜寻 Azure 球体，然后按一下 [在 SSH 中安装]：[远端名称]按钮，将 Azure 球体扩充功能安装到远端电脑。安装之后，您可能需要重新开机Visual Studio Code并重新连线到远端电脑。

4.使用 [开启旧档档夹] 或 [开启旧档] 工作区来开启专案档>> 夹或工作区。

建置、部署至远端装置和侦错

1.按 F5 以建立及侦错专案。如果专案先前尚未建立，或是档案已变更且需要重建，Visual Studio Code会在侦错开始之前建立专案。

2.等候数秒Visual Studio Code来建立应用程式、建立影像套件、部署到白板，然后以侦错模式启动。一路走来，您会在 [ 输出 ] 窗格中看到状态更新。

首先，CMake 会判断是否需要建立应用程式。若是如此，焦点会移至输出视窗，显示来自 CMake/Build 的输出。

接下来，[ 输出 ] 窗格会在影像套件部署到装置时显示结果。最后，侦错主机会接收焦点，并显示侦错工具输出。

使用Visual Studio Code侦错工具来设定中断点、暂停、重迭、步入、重新开机或停止应用程式。

关闭连线

若要结束远端侦错会话，请选取[关闭档案>远端连线]。