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

Você pode instalar o SDK do Azure Sphere em um computador que executa o sistema operacional Linux para desenvolver, implantar e depurar aplicativos do Azure Sphere.

Pré-requisitos

A instalação do SDK do Azure Sphere requer os seguintes pré-requisitos:

• Um kit de desenvolvimento do Azure Sphere.
• Um computador com um processador baseado em x86-64 que executa ubuntu 24.04 de 64 bits (pré-lançamento), Ubuntu 22.04 LTS ou Ubuntu 20.04 LTS. Há suporte apenas para processadores x86-64 compatíveis com Intel; não há suporte para outras arquiteturas, como ARM (incluindo o Raspberry Pi), Itanium ou SPARC. A arquitetura x86-64 também é conhecida como x64, x86_64, AMD64 e Intel 64.
• Permissão do Linux sudo .
• Uma conexão com a Internet ou uma maneira de transferir arquivos de um computador que tem uma conexão com a Internet para seu computador. Para obter mais informações, consulte Instalar o SDK sem uma conexão com a Internet.

Adicionar pacotes do Linux necessários

Antes de executar o script de instalação do SDK, você precisará adicionar pacotes do Linux necessários ao computador se eles ainda não estiverem instalados. Insira as linhas a seguir em um terminal do Linux. Você pode omitir pacotes que já estão instalados.

sudo apt-get update
sudo apt-get install -y net-tools curl

Instalar o SDK do Azure Sphere

Siga estas etapas:

1. Baixe o script de instalação.

2. Navegue até a pasta na qual você baixou o arquivo compactado.

3. Extraia o conteúdo do arquivo compactado. Por exemplo, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. O arquivo .tar.gz contém o arquivo install_azure_sphere_sdk.sh.

4. Execute o script de instalação usando sudo da seguinte maneira:

   sudo ./install_azure_sphere_sdk.sh
   

   Se você vir o erro command not found ao executar o script, habilite a execução do script de instalação com este comando:

   chmod +x install_azure_sphere_sdk.sh
   

5. Durante a instalação, o script exibe mensagens de confirmação. As mensagens de confirmação podem ser ignoradas invocando o script com o -y sinalizador:

   sudo ./install_azure_sphere_sdk.sh -y
   

   Sem o -y sinalizador, o script espera respostas aos seguintes prompts:

   The SDK tarball signature is valid. The fingerprint of the key used is:
   
   Primary key fingerprint: <hexadecimal>
   
   Please check that this fingerprint matches the Microsoft GPG public key fingerprint shown on https://aka.ms/AzureSphereSDKVerification/Linux before proceeding. Do not proceed if these values do not match.
   Proceed with installation? (Y/N)
   

   Navegue até o site de impressão digital da chave público da Microsoft e verifique se o valor da impressão digital hexadecimal exibido durante a instalação corresponde à Impressão Digital da Chave Pública da Microsoft mostrada na página. Não prossiga se as duas impressões digitais não corresponderem.

   Installing CLI.
   This SDK contains two versions of the Azure Sphere CLI: the new Azure Sphere CLI (recommended) and Azure Sphere classic CLI (retiring). See https://aka.ms/AzureSphereCLIVersions for more information on the versions.
   
   You can choose which version is available through the command 'azsphere'.
   
   Note that the Azure Sphere classic CLI will always be available to use with 'azsphere_v1' and the new Azure Sphere CLI will always be available to use with 'azsphere_v2'.
   Use the recommended (new) CLI for 'azsphere'? (Y/N)
   
   

   Selecione Y para definir a CLI do Azure Sphere como sua CLI padrão ou N para definir a CLI clássica do Azure Sphere como sua CLI padrão.

   Some device operations require root permissions, or permissions granted by a udev rule. Set up the default udev rule and group (azsphere), and add the current user to it? (Y/N)
   
   

   Selecione Y para configurar o grupo azsphere e criar a regra udev.

6. Quando a instalação for concluída, você deverá fazer logon novamente no aplicativo da área de trabalho ou no shell de logon para inicializar a CLI do Azure Sphere (Herdado).

Após a instalação, o comando azsphere está no PATH e as novas regras de udev para seu dispositivo estão em /etc/udev/rules.d/.

O script instala o SDK para /opt/azurespheresdk e as cadeiras de ferramentas para /opt/azurespheresdk/Sysroots/sysroot-version/tools, em que a versão sysroot identifica um sysroot no qual o SDK dá suporte ao desenvolvimento de aplicativos.

O instalador instala as versões da CLI do Azure Sphere (Herdado) da CLI. Você não precisa desinstalar a versão atual porque a instalação atualizará qualquer versão existente. A CLI do Azure Sphere (Herdado) está instalada na CLI clássica /opt/azurespheresdk/Tools_v2 e a CLI clássica do Azure Sphere (Herdado) está instalada em /opt/azurespheresdk/Tools.

No Linux, você pode executar a CLI do Azure Sphere (Herdado) de um terminal usando azsphere_v2 e azsphere se ele foi selecionado como a CLI padrão durante a instalação.

Depois de instalar a CLI pela primeira vez, marcar que ela está instalada e você tem a versão correta executando azsphere show-version.

Regras do Udev

O SDK do Azure Sphere especifica udev regras para as informações do dispositivo do computador. O SDK cria um novo grupo chamado azsphere e adiciona o usuário conectado atualmente ao grupo. A udev regra concede a propriedade de dispositivos USB que correspondem à descrição do dispositivo do Azure Sphere. Depois de instalar o SDK e reiniciar seu computador, você não precisará usar sudo para recuperação de dispositivo ou depuração do ARM Cortex-M4.

O azsphere grupo é adicionado para conceder permissões usando a udev regra. Não modifique o grupo manualmente.

Instalar o SDK sem uma conexão com a Internet

Se você não tiver uma conexão com a Internet no computador no qual está instalando o SDK, precisará baixar os arquivos para um computador conectado à Internet e transferi-los para o computador de instalação.

1. Baixe esses arquivos e transfira-os para o computador de instalação:

   • SDK do Azure Sphere para Linux: escolha entre Ubuntu 24.04 (pré-lançamento) ou Ubuntu 22.04 LTS ou Ubuntu 20.04 LTS.

     O arquivo baixado é um arquivo tar compactado (arquivo .tar.gz ) com um nome começando Azure_Sphere_SDK_Bundle.

   • Instalar script: este é um arquivo tar compactado (arquivo .tar.gz ) com um nome começando install_azure_sphere_sdk.

   • Chave pública GPG da Microsoft: este é um arquivo de texto ASCII.

2. No computador de instalação, navegue até a pasta na qual você transferiu os arquivos.

3. Extraia o conteúdo do arquivo de script de instalação compactada. Por exemplo, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. O arquivo .tar.gz contém o arquivo install_azure_sphere_sdk.sh. Deixe o Pacote de SDK do Azure Sphere como um arquivo tar compactado (tar.gz arquivo).

4. Execute o script de instalação usando sudo. Inclua o -i parâmetro para especificar o caminho para o pacote SDK e o -k parâmetro para especificar o caminho para a chave. Seu comando deve ser semelhante a este:

   sudo ./install_azure_sphere_sdk.sh -i [pathtopackage]/[sdkbundle] -k [pathtokey]/microsoft.asc

   Se você vir o erro command not found ao executar o script, habilite a execução do script de instalação com este comando:

   chmod +x install_azure_sphere_sdk.sh
   

Prossiga com a instalação conforme descrito em Instalar o SDK do Azure Sphere.

Instalar a extensão do Azure Sphere para a CLI do Azure

A ferramenta de linha de comando para gerenciar dispositivos anexados do Azure Sphere e implantações de nuvem é distribuída como uma extensão da CLI do Azure. Siga as seguintes etapas para adicionar ou atualizar a extensão:

1. Instale a CLI do Azure se você ainda não tiver feito isso.

• Para adicionar a extensão do Azure Sphere, execute o seguinte comando:

  az extension add --name azure-sphere
  

• Para atualizar a extensão do Azure Sphere, execute o seguinte comando:

  az extension udpate --name azure-sphere
  

Você deve entrar com a CLI do Azure para fazer logon na assinatura do Azure que deseja usar para gerenciar dispositivos do Azure Sphere.

Para obter mais informações, confira Baixar e executar a extensão do Azure Sphere.

Configurar seu ambiente de desenvolvimento

Você pode desenvolver aplicativos do Azure Sphere no Linux usando Visual Studio Code ou a CLI (interface de linha de comando). Não importa o que você use, você precisará instalar o CMake e o Ninja em seu computador de desenvolvimento, se ainda não os tiver. Consulte as instruções para adicionar o Repositório APT do Kitware à sua instalação.

Instalar o CMake e o Ninja

Para instalar o CMake e o Ninja, primeiro consulte as instruções para adicionar o Repositório APT do Kitware à sua instalação e use o seguinte comando:

sudo apt-get install cmake ninja-build

Nota

Não instale cmake ou ninja usando snap.

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

Se você quiser usar Visual Studio Code como seu ambiente de desenvolvimento, precisará instalá-lo e a Extensão do Azure Sphere.

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

Reivindicar seu dispositivo

Nota

Não instale cmake ou ninja usando snap.