Criar um aplicativo de alto nível

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).

A maneira mais fácil de criar um novo aplicativo de alto nível é começar com o modelo em branco da extensão do Azure Sphere do Visual Studio Code e ajustar a configuração para seu projeto seguindo estas etapas:

1. Inicie o Visual Studio Code. Selecione Exibir>paleta de comandos e digite Azure Sphere: Gerar Novo Projeto.

   

2. Escolha HL em branco no menu Modelos.

   

3. Em seguida, o Visual Studio Code exibe uma janela do Explorador de Arquivos. Navegue até a pasta onde você deseja colocar o aplicativo em branco e especifique um nome para seu projeto, por exemplo, NewHLApp. O Visual Studio Code cria a pasta NewHLApp no local selecionado e gera os arquivos de build para o aplicativo em branco. Você deve ver mensagens do CMake.

4. Abra o arquivo CMakeLists.txt e especifique a pasta que contém as definições do hardware que você está usando. Por padrão, o aplicativo HL Blank não contém definições de hardware. Você pode encontrar definições de hardware de exemplo no repositório de Exemplos do Azure Sphere ou criar uma, conforme descrito em Definições de hardware.

   Veja a seguir como adicionar as definições de hardware de exemplo para o Kit de Desenvolvimento MT3620 do Azure Sphere Seeed:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Esta linha deve ser inserida antes do início azsphere_target_add_image_packagedo comando final .

Você também pode criar um novo aplicativo de alto nível de qualquer um dos exemplos de alto nível do Azure Sphere:

1. Clone o repositório de amostras se você ainda não tiver feito isso. Copie uma das pastas de aplicativos de alto nível e renomeie-a para o seu projeto.

2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta. Por exemplo:

   PROJECT(NewHLApp C)

A maneira mais fácil de criar um novo aplicativo de alto nível é começar com o modelo em branco da extensão do Azure Sphere do Visual Studio e ajustar a configuração ao seu projeto seguindo estas etapas:

1. Inicie o Visual Studio e selecione Criar um projeto.

2. Digite Azure Sphere na caixa de pesquisa rotulada Pesquisar modelos. Selecione Azure Sphere HLCore Blank na lista retornada e, em seguida, selecione Avançar.

3. Especifique um nome de projeto (por exemplo, NewHLApp), um local de arquivo de projeto e um nome de solução (que pode ser o mesmo que o nome do projeto) e selecione Criar. O Visual Studio cria a pasta NewHLpp no local selecionado e gera os arquivos de build para o aplicativo em branco. Você deve ver mensagens do CMake.

4. Abra o arquivo CMakeLists.txt e especifique a pasta que contém as definições do hardware que você está usando. Por padrão, o aplicativo HL Blank não contém definições de hardware. Você pode encontrar definições de hardware de exemplo no repositório de Exemplos do Azure Sphere ou criar uma, conforme descrito em Definições de hardware.

   Veja a seguir como adicionar as definições de hardware de exemplo para o Kit de Desenvolvimento MT3620 do Azure Sphere Seeed:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Esta linha deve ser inserida antes do início azsphere_target_add_image_packagedo comando final .

Você também pode criar um novo aplicativo de alto nível de qualquer um dos exemplos de alto nível do Azure Sphere:

1. Clone o repositório de amostras se você ainda não tiver feito isso. Copie uma das pastas de aplicativos de alto nível e renomeie-a para o seu projeto.

2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta. Por exemplo:

   PROJECT(NewHLApp C)

A maneira mais fácil de criar um novo aplicativo de alto nível é começar com qualquer um dos exemplos de alto nível do Azure Sphere:

1. Clone o repositório de amostras se você ainda não tiver feito isso. Copie uma das pastas de aplicativos de alto nível e renomeie-a para o seu projeto.

2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta. Por exemplo:

   PROJECT(NewHLApp C)

Estrutura básica de arquivos de um aplicativo de alto nível

Não importa como você cria seu aplicativo, todos os aplicativos do Azure Sphere compartilham os seguintes arquivos principais:

• Código-fonte do aplicativo em um ou mais arquivos. Atualmente, apenas o código-fonte da linguagem C é suportado.
• Arquivos de compilação do CMake. CMakeLists.txt é obrigatório. O CMake, juntamente com o utilitário de build leve ninja, é usado para controlar o processo de build do aplicativo do Azure Sphere.
• Um arquivo de manifesto do aplicativo que descreve os recursos disponíveis para o aplicativo.

Os aplicativos de alto nível normalmente terão pelo menos três outros arquivos:

• Um arquivo applibs-versions.h para especificar os níveis de versão de várias APIs do Azure Sphere
• Dois arquivos de definição de hardware (uma versão editável no formato JSON e um arquivo de inclusão em linguagem C gerado a partir dele) que fornecem uma maneira conveniente de se referir a componentes de hardware em seu código. Com um conjunto consistente de arquivos de definição de hardware, você pode escrever código-fonte independente de hardware e, em seguida, criar imagens de aplicativos para hardware específico simplesmente redirecionando o arquivo de definição de hardware apropriado em seu arquivo CMakeLists.txt.

Escreva seu código

1. Escreva o código do aplicativo usando os exemplos de aplicativo de alto nível do Azure Sphere como guias. Os tópicos a seguir descrevem cenários de implementação específicos:
   • Usar periféricos em um aplicativo de alto nível
   • Conectar aos serviços Web
   • Use wolfSSL para conexões TLS
   • Gerenciar certificados
   • Entender o uso da memória
   • Adiar atualizações do dispositivo
   • Gerencie o tempo e use o relógio em tempo real
   • Usar o armazenamento do dispositivo
   • Comunicar-se com um aplicativo com capacidade em tempo real
   • Gerenciar o estado de desligamento
   • Definir perfis de energia
   • Executar descoberta de serviço
2. No arquivo CMakeLists.txt:
   • Especificar a revisão das ferramentas do SDK do Azure Sphere
   • Especificar o conjunto de APIs de destino
   • Especificar o hardware de destino
3. No arquivo app_manifest.json:
   • Configure Name como o nome de seu projeto.
   • Adicione quaisquer recursos específicos do aplicativo que seu código exigir, como recursos de hardware ou conexões. Se o aplicativo de alto nível se comunicar com um RTApp, adicione a ID do componente do aplicativo de alto nível à AllowedApplicationConnections funcionalidade.

Se você quiser implantar seu aplicativo de alto nível junto com um aplicativo parceiro com capacidade em tempo real, adicione a ID do componente do parceiro ao campo partnerComponents da seção de configurações do arquivo launch.vs.json (Visual Studio) ou .vscode/launch.json (Visual Studio Code):

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

Confira também

• Crie um aplicativo de alto nível.

• Depurar um aplicativo de alto nível.