Criar uma aplicação de alto nível

A forma mais fácil de criar uma nova aplicação de alto nível é começar com o modelo Em Branco a partir da extensão do Azure Sphere do Visual Studio Code e ajustar a configuração ao seu projeto ao seguir estes passos:

1. Inicie o Visual Studio Code. Selecione Ver>Paleta de comandos e, em seguida, escreva Azure Sphere: Gerar Novo Projeto.

   

2. Selecione HL Em Branco no menu Modelos.

   

3. Em seguida, o Visual Studio Code apresenta uma janela Explorador de Ficheiros. Navegue para a pasta onde pretende colocar a aplicação Em branco e especifique um nome para o projeto, por exemplo NewHLApp. O Visual Studio Code cria a pasta NewHLApp na sua localização selecionada e gera os ficheiros de compilação para a aplicação em branco. Deverá ver mensagens do CMake.

4. Abra o ficheiro CMakeLists.txt e especifique a pasta que contém definições para o hardware que está a utilizar. Por predefinição, a aplicação HL Blank não contém definições de hardware. 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.

   O seguinte mostra como adicionar as definições de hardware de exemplo para o Kit de Desenvolvimento Seeed Azure Sphere MT3620:

   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 do comando azsphere_target_add_image_packagefinal .

Também pode criar uma nova aplicação de alto nível a partir de qualquer um dos exemplos de alto nível do Azure Sphere:

1. Clone o repositório de exemplos se ainda não o tiver feito. Copie uma das pastas de aplicação de alto nível e mude o nome para o projeto.

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

   PROJECT(NewHLApp C)

A forma mais fácil de criar uma nova aplicação de alto nível é começar com o modelo Em Branco a partir da extensão do Visual Studio Azure Sphere e ajustar a configuração ao seu projeto ao seguir estes passos:

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

2. Escreva Azure Sphere na caixa de pesquisa com o nome Procurar modelos. Selecione Azure Sphere HLCore Blank na lista devolvida e, em seguida, selecione Seguinte.

3. Especifique um nome de projeto (por exemplo, NewHLApp), uma localização de ficheiro de projeto e um nome de solução (que pode ser o mesmo que o nome do projeto) e, em seguida, selecione Criar. O Visual Studio cria a pasta NewHLpp na sua localização selecionada e gera os ficheiros de compilação da aplicação em branco. Deverá ver mensagens do CMake.

4. Abra o ficheiro CMakeLists.txt e especifique a pasta que contém definições para o hardware que está a utilizar. Por predefinição, a aplicação HL Blank não contém definições de hardware. 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.

   O seguinte mostra como adicionar as definições de hardware de exemplo para o Kit de Desenvolvimento Seeed Azure Sphere MT3620:

   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 do comando azsphere_target_add_image_packagefinal .

Também pode criar uma nova aplicação de alto nível a partir de qualquer um dos exemplos de alto nível do Azure Sphere:

1. Clone o repositório de exemplos se ainda não o tiver feito. Copie uma das pastas de aplicação de alto nível e mude o nome para o projeto.

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

   PROJECT(NewHLApp C)

A forma mais fácil de criar uma nova aplicação de alto nível é começar com qualquer um dos exemplos de alto nível do Azure Sphere:

1. Clone o repositório de exemplos se ainda não o tiver feito. Copie uma das pastas de aplicação de alto nível e mude o nome para o projeto.

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

   PROJECT(NewHLApp C)

Estrutura de ficheiros básica de uma aplicação de alto nível

Independentemente da forma como criar a sua aplicação, todas as aplicações do Azure Sphere partilham os seguintes ficheiros principais:

• Código fonte da aplicação num ou mais ficheiros. Atualmente, apenas o código fonte de linguagem C é suportado.
• Ficheiros de criação CMake. CMakeLists.txt é necessário. O CMake, juntamente com o utilitário ninja lightweight build, é utilizado para controlar o processo de compilação da aplicação do Azure Sphere.
• Um ficheiro de manifesto de aplicação que descreve as capacidades disponíveis para a aplicação.

Normalmente, as aplicações de alto nível terão pelo menos três outros ficheiros:

• Um ficheiro applibs-versions.h para especificar os níveis de versão de várias APIs do Azure Sphere
• Dois ficheiros de definição de hardware (uma versão editável no formato JSON e um ficheiro de linguagem C gerado a partir do mesmo) que fornecem uma forma conveniente de consultar componentes de hardware no seu código. Com um conjunto consistente de ficheiros de definição de hardware, pode escrever código fonte independente de hardware e, em seguida, criar imagens de aplicação para hardware específico ao simplesmente voltar a filtrar o ficheiro de definição de hardware adequado no seu ficheiro de CMakeLists.txt.

Escrever o código

1. Escreva o código da aplicação com os exemplos de aplicação de alto nível do Azure Sphere como guias. Os tópicos seguintes descrevem cenários de implementação específicos:
   • Utilizar periféricos numa aplicação de alto nível
   • Ligar a serviços Web
   • Utilizar wolfSSL para ligações TLS
   • Gerir certificados
   • Compreender a utilização da memória
   • Diferir atualizações de dispositivos
   • Gerir o tempo e utilizar o relógio em tempo real
   • Utilizar o armazenamento de dispositivos
   • Comunicar com uma aplicação em tempo real
   • Gerir o estado Desativado
   • Definir perfis de energia
   • Efetuar a deteção de serviços
2. No ficheiro deCMakeLists.txt:
   • Especificar a revisão das ferramentas do SDK do Azure Sphere
   • Especificar conjunto de API de destino
   • Especificar o hardware de destino
3. No ficheiro app_manifest.json:
   • Defina Name como o nome do projeto.
   • Adicione quaisquer capacidades específicas da aplicação necessárias ao seu código, tais como recursos de hardware ou ligações. Se a aplicação de alto nível comunicar com uma RTApp, adicione o ID do componente da aplicação de alto nível à AllowedApplicationConnections capacidade.

Se quiser implementar a sua aplicação de alto nível juntamente com uma aplicação de parceiro com capacidade em tempo real, adicione o ID de componente do parceiro ao campo partnerComponents da secção de configurações do ficheiro launch.vs.json (Visual Studio) ou .vscode/launch.json (Visual Studio Code):

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

Consulte também

• Criar uma aplicação de alto nível.
• Depurar uma aplicação de alto nível.