快速入门：安装适用于 Linux 的 Azure Sphere SDK

可以在运行 Linux 操作系统的计算机上安装 Azure Sphere SDK，以开发、部署和调试 Azure Sphere 应用程序。

先决条件

Azure Sphere SDK 安装需要满足以下先决条件：

• Azure Sphere 开发工具包。
• 运行 64 位 Ubuntu 24.04（预发行版）、Ubuntu 22.04 LTS 或 Ubuntu 20.04 LTS 的基于 x86-64 处理器的计算机。 仅支持 Intel 兼容的 x86-64 处理器;不支持 ARM（包括 Raspberry Pi）、Itanium 或 SPARC 等其他体系结构。 x86-64 体系结构也称为 x64、x86_64、AMD64 和 Intel 64。
• Linux sudo 权限。
• Internet 连接或将文件从具有 Internet 连接的计算机传输到你的计算机的方法。 有关详细信息，请参阅在无 Internet 连接的情况下安装 SDK。

添加所需的 Linux 包

在运行 SDK 安装脚本之前，如果你的计算机中尚未安装所需的 Linux 包，则需要添加此包。 在 Linux 终端中输入以下行。 可以忽略已安装的包。

sudo apt-get update
sudo apt-get install -y net-tools curl

安装 Azure Sphere SDK

执行以下步骤：

1. 下载安装脚本。

2. 导航到下载压缩文件的文件夹。

3. 提取压缩文件的内容。 例如，tar xvfz install_azure_sphere_sdk_<version>.tar.gz。 .tar.gz文件包含install_azure_sphere_sdk.sh文件。

4. 按 sudo 如下所示运行安装脚本：

   sudo ./install_azure_sphere_sdk.sh
   

   如果在运行脚本时看到错误 command not found ，请使用以下命令启用安装脚本的执行：

   chmod +x install_azure_sphere_sdk.sh
   

5. 安装期间，脚本会显示确认消息。 可以通过使用 -y 标志调用脚本来跳过确认消息：

   sudo ./install_azure_sphere_sdk.sh -y
   

   -y如果没有标志，脚本将期望对以下提示做出响应：

   The SDK tarball signature is valid. The fingerprint of the key used is:
   
   Primary key fingerprint: <hexadecimal>
   
   Please check that this fingerprint matches the Microsoft GPG public key fingerprint shown on https://aka.ms/AzureSphereSDKVerification/Linux before proceeding. Do not proceed if these values do not match.
   Proceed with installation? (Y/N)
   

   导航到Microsoft的公共密钥指纹站点，并验证安装过程中显示的十六进制指纹值是否与页面上显示的Microsoft公钥指纹匹配。 如果这两个指纹不匹配，请勿继续操作。

   Installing CLI.
   This SDK contains two versions of the Azure Sphere CLI: the new Azure Sphere CLI (recommended) and Azure Sphere classic CLI (retiring). See https://aka.ms/AzureSphereCLIVersions for more information on the versions.
   
   You can choose which version is available through the command 'azsphere'.
   
   Note that the Azure Sphere classic CLI will always be available to use with 'azsphere_v1' and the new Azure Sphere CLI will always be available to use with 'azsphere_v2'.
   Use the recommended (new) CLI for 'azsphere'? (Y/N)
   
   

   选择 Y 将 Azure Sphere CLI 设置为默认 CLI，或 N 将 Azure Sphere 经典 CLI 设置为默认 CLI。

   Some device operations require root permissions, or permissions granted by a udev rule. Set up the default udev rule and group (azsphere), and add the current user to it? (Y/N)
   
   

   选择 Y 以设置 azsphere group 并创建 udev 规则。

6. 安装完成后，必须再次登录到桌面应用程序或登录 shell 以初始化 Azure Sphere （旧版） CLI。

安装后，azsphere 命令位于 PATH 上，设备的新 udev 规则位于 。/etc/udev/rules.d/

该脚本将 SDK 安装到 /opt/azurespheresdk，将工具链安装到 /opt/azurespheresdk/Sysroots/sysroot-version/tools，其中 sysroot-version 标识 SDK 针对其支持应用开发的 sysroot。

安装程序安装 CLI 的 Azure Sphere （旧版） CLI 版本。 无需卸载当前版本，因为安装将更新任何现有版本。 Azure Sphere （旧版） CLI 安装在 /opt/azurespheresdk/Tools_v2 和 Azure Sphere （旧版） 经典 CLI 中，安装在 /opt/azurespheresdk/Tools 中。

在 Linux 上，可以从终端运行 azsphere_v2 azsphere Azure Sphere （旧版） CLI，并在安装过程中将其选为默认 CLI。

首次安装 CLI 后，请检查它是否已安装，并通过运行 azsphere show-version 获得正确的版本。

Udev 规则

Azure Sphere SDK 为计算机的设备信息指定 udev 规则。 SDK 创建名为 azsphere 的新组，并将当前登录的用户添加到该组。 udev 规则授予匹配 Azure Sphere 设备描述的 USB 设备所有权。 安装 SDK 并重新启动计算机后，将无需使用 sudo 进行设备恢复或 ARM Cortex-M4 调试。

添加 azsphere 组是为了使用 udev 规则授予权限。 请勿手动修改组。

在没有 Internet 连接的情况下安装 SDK

如果在安装 SDK 的计算机上没有 Internet 连接，则需要将文件下载到连接到 Internet 的计算机，并将其传输到安装计算机。

1. 下载这些文件并将其传输到安装计算机：

   • 适用于 Linux 的 Azure Sphere SDK：从 Ubuntu 24.04（预发布）或 Ubuntu 22.04 LTS 或 Ubuntu 20.04 LTS 中进行选择。

     下载的文件是一个压缩的 tar 文件（.tar.gz文件），其名称以Azure_Sphere_SDK_Bundle开头。

   • 安装脚本：这是一个压缩的 tar 文件（.tar.gz文件），其名称以install_azure_sphere_sdk开头。

   • Microsoft的 GPG 公钥：这是 ASCII 文本文件。

2. 在安装计算机上，导航到要将文件传输到的文件夹。

3. 提取压缩的安装脚本文件的内容。 例如，tar xvfz install_azure_sphere_sdk_<version>.tar.gz。 .tar.gz文件包含install_azure_sphere_sdk.sh文件。 将 Azure Sphere SDK 捆绑包保留为压缩的 tar 文件（tar.gz 文件）。

4. 使用 sudo 运行安装脚本。 -i包括用于指定 SDK 捆绑包的路径的参数，-k以及指定密钥路径的参数。 命令应如下所示：

   sudo ./install_azure_sphere_sdk.sh -i [pathtopackage]/[sdkbundle] -k [pathtokey]/microsoft.asc

   如果在运行脚本时看到错误 command not found ，请使用以下命令启用安装脚本的执行：

   chmod +x install_azure_sphere_sdk.sh
   

按照安装 Azure Sphere SDK 中所述继续安装。

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

用于管理 Azure Sphere 附加设备和云部署的命令行工具作为 Azure CLI 扩展分发。 执行以下步骤添加或更新扩展：

1. 安装 Azure CLI （如果尚未安装）。

• 若要添加 Azure Sphere 扩展，请运行以下命令：

  az extension add --name azure-sphere
  

• 若要更新 Azure Sphere 扩展，请运行以下命令：

  az extension udpate --name azure-sphere
  

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

有关详细信息，请参阅 “下载并运行 Azure Sphere 扩展”。

设置开发环境

可以使用 Visual Studio Code 或命令行接口 (CLI) 在 Linux 上开发 Azure Sphere 应用。 无论使用哪种方法，都需要在开发计算机上安装 CMake 和 Ninja（如果尚未安装）。 请参阅将 Kitware APT 存储库添加到安装的说明。

安装 CMake 和 Ninja

若要安装 CMake 和 Ninja，请先参阅将 Kitware APT 存储库添加到安装的说明，然后使用以下命令：

sudo apt-get install cmake ninja-build

注意

请勿使用对齐安装 CMake 或 Ninja。

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

如果要将 Visual Studio Code 用作开发环境，则需要安装它和 Azure Sphere 扩展。

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

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

3. 在安装后，在 Visual Studio Code IDE 的“已启用的扩展”窗格中应当会看到 Azure Sphere、C/C++ 和 CMake Tools 扩展。

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

后续步骤

声明你的设备

注意

请勿使用对齐安装 CMake 或 Ninja。