快速入门:安装适用于 Windows 的 Azure Sphere SDK

若要开始在 Windows 上使用 Azure Sphere 开发工具包,需要设置开发工具包、安装 SDK,并安装开发环境所需的任何其他软件。

先决条件

  • Azure Sphere 开发工具包
  • 运行Windows 11或Windows 10周年更新 (或更高版本的电脑)
  • 未使用的 USB 端口,如果正在运行虚拟机,则支持 USB 直通

在 Windows 电脑上设置开发工具包

通过 USB 将 Azure Sphere 开发工具包连接到电脑。 接通电源后,设备会公开四个 USB 串行转换器。

首次插入设备时,应自动下载并安装驱动程序。 安装速度可能很慢。 如果未自动安装驱动程序,请右键单击设备管理器中的设备名称,然后选择“更新驱动程序”。 或者,可以从未来技术设备国际 (FTDI) 下载驱动程序。 选择与 Windows 安装 (32 位或 64 位) 匹配的驱动程序。

若要验证安装,请打开设备管理器。 在“通用串行总线控制器”下,查找四个 USB 串行转换器。

注意

如果以前已使用此开发板并启用了 RTApp 开发,则会看到三个转换器,而不是四个转换器。 这是正常的,不表示错误。

如果发生其他错误,请参阅 排查 Azure Sphere 问题 以获取帮助。

安装 Azure Sphere SDK

  1. 下载 SDK。 将下载的文件保存在电脑上。

  2. 运行下载的 .exe 以安装 SDK。 同意许可条款,然后选择“ 下一步”。

  3. 选择“ 安装 ”开始安装。

  4. 如果出现提升提示,请接受提升提示。

  5. 安装完成后,如果安装应用程序请求,请重启电脑。

如果安装程序返回错误,请尝试卸载并重新安装 SDK 包。

安装适用于 Azure CLI 的 Azure Sphere 扩展

用于管理 Azure Sphere 附加设备和云部署的命令行工具作为 Azure CLI 扩展分发。 执行以下步骤来获取它:

  1. 安装 Azure CLI(如果尚未安装)。

  2. 若要添加 Azure Sphere 扩展,请运行以下命令:

    az extension add --name azure-sphere
    

必须使用 Azure CLI 登录 才能登录到要用于管理 Azure Sphere 设备的 Azure 订阅。

有关详细信息,请参阅 下载并运行 Azure Sphere 扩展

安装适用于 Visual Studio 的 Azure Sphere 扩展

可以使用 Visual Studio Enterprise、Professional 或 Community 2022 (或 2019 版本 16.11 或更高版本) 开发 Azure Sphere 应用程序。

  1. 如果尚未安装,请安装 Visual Studio:

  2. 转到 Visual Studio 市场以安装适用于 Azure Sphere 的 Visual Studio 扩展:

Azure Sphere SDK 和适用于 Visual Studio 的 Azure Sphere 扩展包括开发 Azure Sphere 应用程序所需的所有工具。

在 Windows 上安装 CMake 和 Ninja

如果计划使用 Visual Studio Code 或 Windows CLI,则需要手动安装 CMake 和 Ninja。

  1. 若要安装 CMake,请从 CMake 下载页下载并安装适合开发环境的 CMake 版本。

  2. 下载 Ninja。 下载是一个小型 zip 文件。 若要安装 Ninja,请打开 zip 文件,选择“ 全部提取”,并记下提取的文件 ninja.exe 的文件位置。

  3. 通常,将 CMake bin 目录 (C:\Program Files\CMake\bin) 和包含 ninja.exe 的目录添加到 PATH 环境变量。 若要查找有关在 Windows 中设置此环境变量的信息,请在“搜索”框中键入“路径”。

提示

修改环境变量后重启计算机,确保所有进程都能够选取更改。

安装适用于 Visual Studio Code 的 Azure Sphere 扩展

  1. 使用下载Visual Studio Code中的链接安装Visual Studio Code(如果尚未安装)。

  2. 若要安装 Azure Sphere 扩展,请在扩展市场中从浏览器或Visual Studio Code中搜索“Azure Sphere”。 应会看到两个结果: Azure SphereAzure Sphere UI。 为任一选择“ 安装” ;应自动安装另一个 。

  3. 安装后,应在 VISUAL STUDIO CODE IDE 的“已启用扩展”窗格中看到 Azure SphereC/C++CMake Tools 扩展。

安装完成后,将打开扩展的 “自述文件 ”页。 自述文件页提供有关Visual Studio Code配置和要求的有用信息,并随扩展一起更新。 可以通过打开“扩展”窗格并选择“Azure Sphere”,随时查看自述文件页。

后续步骤