O que é um ID de componente?

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

Cada aplicativo do Azure Sphere deve ter uma ID de componente exclusiva para que possa ser facilmente identificado. A ID do componente é um identificador universalmente exclusivo (UUID), também conhecido como identificador global exclusivo (GUID), que é uma cadeia de caracteres que contém um conjunto de dígitos hexadecimais. Por exemplo, 02ce3860-3126-42af-8ac7-c2a661134129. Cada aplicativo tem um ID de componente diferente para evitar possíveis conflitos.

Gerar uma ID de componente

Na primeira vez que você abre um projeto CMake no Visual Studio ou no Visual Studio Code, a geração CMakeLists é executada automaticamente e define a ID do componente para o aplicativo no arquivo app_manifest.json. Se você executar o aplicativo sem uma ID de componente, a compilação falhará. Se necessário, você pode gerar manualmente um GUID/UUID e atualizar a configuração do manifesto do aplicativo.

Para gerar um GUID ou UUID:

Visual Studio

1. No menu Ferramentas, escolha Criar GUID.
2. No programa gerador de GUID, escolha o botão de opção Formato do Registro, escolha o botão Copiar e, em seguida, escolha o botão Sair.

PowerShell

1. Inicie o Windows PowerShell.
2. Insira o seguinte comando:

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

Linux

1. Abra o shell bash.
2. Insira o seguinte comando:

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

Cole o GUID/UUID gerado no ComponentId campo do arquivo app_manifest.json do aplicativo. Por exemplo: "ComponentId": "a5e23798-9bef-4bb0-9ae9-45643e788cb7"

Localizar a ID do componente

O ID do componente de um aplicativo é necessário para identificar um aplicativo. Você pode encontrar a ID do componente de um aplicativo das seguintes maneiras:

• Verifique o ID do componente no ComponentId campo do arquivo app_manifest.json do aplicativo.
• Use o comando azsphere device app show-status para listar o status e a ID do componente do aplicativo no dispositivo anexado.
• Use o comando azsphere device image list-installed para listar as imagens atualmente no dispositivo anexado. Observe a ID do componente do aplicativo necessário.