O que é um ID de componente?

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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. O 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 um ID de componente

A primeira vez que você abre um projeto CMake no Visual Studio ou 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. Introduza o seguinte comando:

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

Linux

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

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

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

Localizar o ID do componente

A ID do componente de um aplicativo é necessária para identificar um aplicativo. Você pode encontrar a ID do componente para um aplicativo de qualquer uma das seguintes maneiras:

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