Guia de início rápido: instalar o SDK do Azure Sphere para Windows
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).
Para começar a usar um kit de desenvolvimento do Azure Sphere no Windows, você precisa configurar o kit de desenvolvimento, instalar o SDK e instalar qualquer software adicional necessário para seu ambiente de desenvolvimento.
Pré-requisitos
- Um kit de desenvolvimento do Azure Sphere
- Um PC com a Atualização de Aniversário do Windows 11 ou do Windows 10 (ou posterior)
- Uma porta USB não utilizada e, se estiver a executar uma máquina virtual, suporte para USB pass-through
Configurar seu kit de desenvolvimento em um PC com Windows
Ligue o seu kit para programador do Azure Sphere ao seu PC através de USB. Quando conectado, o dispositivo expõe quatro conversores seriais USB.
Na primeira vez que você conectar o dispositivo, os drivers devem ser baixados e instalados automaticamente. A instalação pode ser lenta. Se os drivers não forem instalados automaticamente, clique com o botão direito do mouse no nome do dispositivo no Gerenciador de dispositivos e selecione Atualizar driver. Em alternativa, pode transferir os controladores da Future Technology Devices International (FTDI). Escolha o driver que corresponde à sua instalação do Windows (32 ou 64 bits).
Para verificar a instalação, abra o Gestor de dispositivos. Em Controladores Universal Serial Bus, procure quatro conversores seriais USB.
Nota
Se você já usou essa placa e ativou o desenvolvimento RTApp, verá três conversores em vez de quatro. Isso é normal e não representa um erro.
Se ocorrerem outros erros, consulte Solucionar problemas do Azure Sphere para obter ajuda.
Instalar o SDK do Azure Sphere
Transfira o SDK. Guarde o ficheiro transferido no seu PC.
Execute o .exe transferido para instalar o SDK. Concorde com os termos de licenciamento e, em seguida, selecione Seguinte.
Selecione Instalar para iniciar a instalação.
Se for apresentado um pedido de elevação, aceite-o.
Quando a configuração estiver concluída, reinicie o seu PC se a aplicação de configuração o pedir.
Se o instalador retornar erros, tente desinstalar e reinstalar o pacote SDK.
Gorjeta
A licença do SDK do Azure Sphere é instalada em C:\Program Files (x86)\Microsoft Azure Sphere SDK\license.rtf.
O SDK inclui bibliotecas para desenvolvimento de aplicativos e as versões clássicas da CLI do Azure Sphere e da CLI clássica do Azure Sphere. Não é necessário desinstalar a versão atual porque a instalação atualizará qualquer versão existente. A CLI do Azure Sphere é instalada em C:\Program Files (x86)\Microsoft Azure Sphere SDK\Tools_v2 e a CLI clássica do Azure Sphere é instalada em C:\Program Files (x86)\Microsoft Azure Sphere SDK\Tools.
Você pode executar a CLI do Azure Sphere com o azsphere comando do Prompt de Comando do Windows ou do PowerShell. Recomendamos o PowerShell, pois ele oferece o recurso de conclusão de guia que não está disponível no Prompt de Comando do Windows.
A CLI clássica do Azure Sphere continuará disponível usando o Prompt de Comando do Desenvolvedor Clássico do Azure Sphere (desativação), que está disponível no menu Iniciar em Azure Sphere.
Depois de instalar a CLI pela primeira vez, verifique se ela está instalada e se você tem a versão correta executando azsphere show-version.
Se você tentar executar a CLI e receber uma mensagem de erro dizendo que azsphere não é um comando reconhecido, adicione o caminho para o executável do SDK do Azure Sphere às variáveis de ambiente do Windows. Vá para Sistema do Painel de Controle>e Configurações avançadas do sistema do Sistema>de Segurança.> Selecione Variáveis de ambiente e, em Variáveis de sistema, adicione o caminho a azsphere.exe (por exemplo, C:\Program Files (x86)\Microsoft Azure Sphere SDK\Tools_v2).
Instalar a extensão do Azure Sphere para Visual Studio
Você pode usar o Visual Studio Enterprise, Professional ou Community 2022 (ou 2019 versão 16.11 ou superior) para desenvolver aplicativos do Azure Sphere.
Se você ainda não tiver feito isso, instale o Visual Studio:
Vá para o Visual Studio Marketplace para instalar a extensão do Visual Studio para Azure Sphere:
O SDK do Azure Sphere e a Extensão do Azure Sphere para Visual Studio incluem todas as ferramentas necessárias para desenvolver aplicativos do Azure Sphere.
Instale CMake e Ninja no Windows
Se você planeja usar o Visual Studio Code ou a CLI do Windows, você precisa instalar o CMake e o Ninja manualmente.
Para instalar o CMake, baixe e instale a versão apropriada do CMake para seu ambiente de desenvolvimento na página de download do CMake.
Baixar Ninja. O download é um pequeno arquivo zip. Para instalar o Ninja, abra o arquivo zip, selecione Extrair tudo e anote o local do arquivo extraído ninja.exe.
Adicione o diretório CMake
bin(normalmente, C:\Program Files\CMake\bin) e o diretório que contém ninja.exe à variável de ambiente PATH. Para encontrar informações sobre como definir essa variável de ambiente no Windows, digite "caminho" na caixa Pesquisar.
Gorjeta
Reinicie o computador depois de modificar as variáveis de ambiente para garantir que todos os processos captem as alterações.
Instalar a extensão do Azure Sphere para Visual Studio Code
Use os links em Baixar o Visual Studio Code para instalar o Visual Studio Code, se ainda não tiver feito isso.
Para instalar a extensão Azure Sphere, procure "Azure Sphere" no Extension Marketplace a partir de um browser ou no Visual Studio Code. Você deve ver dois resultados, Azure Sphere e Azure Sphere UI. Selecione Instalar para qualquer um deles, o outro deve ser instalado automaticamente.
Após a instalação, você verá as extensões Azure Sphere, C/C++ e CMake Tools no painel Extensões ENABLED no IDE de código do Visual Studio.
Quando a instalação estiver concluída, a página Leiame da extensão será aberta. A página Leiame fornece informações úteis sobre a configuração e os requisitos do Visual Studio Code e é atualizada junto com a extensão. Você pode exibir a página Leiame a qualquer momento abrindo o painel Extensões e selecionando Azure Sphere.