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

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

先决条件

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

• Azure Sphere 开发工具包。
• 具有基于 x86-64 的处理器的计算机，它运行 64 位 Ubuntu 24.04 (预发行) 、Ubuntu 22.04 LTS 或 Ubuntu 20.04 LTS。 仅支持与 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 组并创建 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_v2azsphere运行 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

注意

请勿使用 snap 安装 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”，随时查看自述文件页。

后续步骤

声明你的设备

注意

请勿使用 snap 安装 cmake 或 ninja。