快速入门:安装适用于 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 Marketplace 以安装适用于 Azure Sphere 的 Visual Studio 扩展:

适用于 Visual Studio 的 Azure Sphere SDK 和 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 来查看自述文件页。

后续步骤