什么是组件 ID？

重要

这是 Azure Sphere（旧版）文档。 Azure Sphere（旧版）将于 2027 年 9 月 27 日停用，用户此时必须迁移到 Azure Sphere（集成）。 使用位于 TOC 上方的版本选择器查看 Azure Sphere（集成）文档。

每个 Azure Sphere 应用程序必须具有唯 一的组件 ID ，以便可以轻松识别它。 组件 ID 是一个通用唯一标识符（UUID），也称为全局唯一标识符（GUID），它是包含一组十六进制数字的字符串。 例如，02ce3860-3126-42af-8ac7-c2a661134129。 每个应用程序都有不同的组件 ID，以避免可能的冲突。

生成组件 ID

首次在 Visual Studio 或 Visual Studio Code 中打开 CMake 项目时，CMakeLists 生成会自动运行并设置app_manifest.json文件中应用程序的组件 ID。 如果在没有组件 ID 的情况下运行应用程序，生成将失败。 如果需要，可以手动生成 GUID/UUID 并更新应用程序清单设置。

生成 GUID 或 UUID：

Visual Studio

1. 在 “工具” 菜单上，选择 “创建 GUID”。
2. 在 “GUID 生成器” 程序中，选择 “注册表格式” 选项按钮，再选择 “复制” 按钮，然后选择 “退出” 按钮。

PowerShell

1. 启动 Windows PowerShell。
2. 输入以下命令：

    [guid]::NewGuid()
    Guid
    ----
    02ce3860-3126-42af-8ac7-c2a661134129

Linux

1. 打开 bash shell。
2. 输入以下命令：

    uuidgen
    a5e23798-9bef-4bb0-9ae9-45643e788cb7

将生成的 GUID/UUID 粘贴到 ComponentId 应用程序 app_manifest.json 文件的字段中。 例如："ComponentId": "a5e23798-9bef-4bb0-9ae9-45643e788cb7"

查找组件 ID

标识应用程序需要应用程序的组件 ID。 可通过以下任何方式查找应用程序的组件 ID：

• 检查应用程序app_manifest.json文件中的组件 IDComponentId。
• 使用命令 azsphere device app show-status 列出附加设备上的应用程序的状态和组件 ID。
• 使用已安装 azsphere 设备映像列表的命令列出当前在附加设备上的映像。 记下所需应用程序的组件 ID。