Início Rápido: instalar o SDK do Azure Sphere para Windows

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 computador executando Windows 11 ou Windows 10 Atualização de Aniversário (ou posterior)
  • Uma porta USB não usada e, se você estiver executando uma máquina virtual, dê suporte à passagem USB

Configurar seu kit de desenvolvimento em um computador Windows

Conecte o kit de desenvolvimento do Azure Sphere ao computador por meio do USB. Quando conectado, o dispositivo expõe quatro Conversores Serial USB.

Na primeira vez que você conecta o dispositivo, os drivers devem ser baixados e instalados automaticamente. A instalação pode ser lenta. Se os drivers não estiverem instalados automaticamente, clique com o botão direito do mouse no nome do dispositivo no Gerenciador de Dispositivos e selecione Atualizar driver. Como alternativa, você pode baixar os drivers da FTDI (Future Technology Devices International). Escolha o driver que corresponde à instalação do Windows (32 ou 64 bits).

Para verificar a instalação, abra Gerenciador de Dispositivos. Em Controladores de Barramento Serial Universal, procure quatro Conversores Serial USB. Gerenciador de Dispositivos com quatro conversores serial USB

Nota

Se você já usou esse quadro e habilitou o desenvolvimento do RTApp, verá três conversores em vez de quatro. Isso é normal e não representa um erro.

Se outros erros ocorrerem, consulte Solucionar problemas do Azure Sphere para obter ajuda.

Instalar o SDK do Azure Sphere

  1. Baixe o SDK. Salve o arquivo baixado no computador.

  2. Execute o .exe baixado para instalar o SDK. Concorde com os termos da licença e selecione Avançar.

  3. Selecione Instalar para iniciar a instalação.

  4. Aceite o prompt de elevação se um for exibido.

  5. Quando a instalação for concluída, reinicie o computador se o aplicativo de instalação solicitar.

Se o instalador retornar erros, tente desinstalar e reinstalar o pacote SDK.

O SDK inclui bibliotecas para desenvolvimento de aplicativos e as versões da CLI clássica do Azure Sphere e da CLI clássica do Azure Sphere. Você não precisa desinstalar a versão atual porque a instalação atualizará qualquer versão existente. A CLI do Azure Sphere está instalada em C:\Arquivos de Programa (x86)\Microsoft O SDK\Tools_v2 do Azure Sphere e a CLI clássica do Azure Sphere está instalada em C:\Arquivos de Programa (x86)\Microsoft SDK\Tools do Azure Sphere.

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 da 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 de Desenvolvedor Clássico do Azure Sphere (desativação), que está disponível no menu Iniciar no Azure Sphere.

Depois de instalar a CLI pela primeira vez, verifique se ela está instalada e 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 ao SDK do Azure Sphere executável às variáveis de ambiente do Windows. Acesse Painel de Controle Configurações>avançadas dosistemade segurança e sistema> de segurança>. Selecione Variáveis de ambiente e em Variáveis de sistema adicionem o caminho a azsphere.exe (por exemplo, C:\Arquivos de Programa (x86)\Microsoft SDK\Tools_v2 do Azure Sphere).

Instalar o Visual Studio e a extensão do Azure Sphere

Você pode usar Visual Studio Enterprise, Profissional ou Community 2022 (ou 2019 versão 16.11 ou superior) para desenvolver aplicativos do Azure Sphere.

  1. Se você ainda não tiver feito isso, instale o Visual Studio:

  2. Acesse o Visual Studio Marketplace para instalar a Extensão do Visual Studio para o 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.

Instalar CMake e Ninja no Windows

Se você planeja usar Visual Studio Code ou a CLI do Windows, precisará instalar o CMake e o Ninja manualmente.

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

  2. Baixe Ninja. O download é um arquivo zip pequeno. Para instalar o Ninja, abra o arquivo zip, selecione Extrair Todos e observe o local do arquivo extraído ninja.exe.

  3. Adicione o diretório CMake bin (normalmente, C:\Arquivos de Programa\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 Pesquisa.

Ponta

Reinicialize seu computador depois de modificar variáveis de ambiente para garantir que todos os processos peguem as alterações.

Instalar a extensão do Azure Sphere para Visual Studio Code

  1. Use os links em Baixar Visual Studio Code para instalar Visual Studio Code, se você ainda não tiver feito isso.

  2. Para instalar a extensão do Azure Sphere, pesquise "Azure Sphere" no Extension Marketplace de um navegador ou em Visual Studio Code. Você deve ver dois resultados, a interface do usuário do Azure Sphere e do Azure Sphere. Selecione Instalar para qualquer um deles; o outro deve ser instalado automaticamente.

  3. Após a instalação, você deverá ver extensões do Azure Sphere, C/C++e CMake Tools no painel Extensões HABILITADAS no IDE do Visual Studio Code.

Quando a instalação for concluída, a página Readme da extensão será aberta. A página Readme fornece informações úteis sobre Visual Studio Code configuração e requisitos e é atualizada junto com a extensão. Você pode exibir a página Readme a qualquer momento abrindo o painel Extensões e selecionando o Azure Sphere.

Próximas etapas