Partilhar via

Guia de início rápido: instalar o SDK do Azure Sphere para Linux

  • Artigo

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

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 executando o Ubuntu 24.04 de 64 bits (pré-lançamento), Ubuntu 22.04 LTS ou Ubuntu 20.04 LTS. Apenas processadores x86-64 compatíveis com Intel são suportados; outras arquiteturas como ARM (incluindo o Raspberry Pi), Itanium ou SPARC não são suportadas. A arquitetura x86-64 também é conhecida como x64, x86_64, AMD64 e Intel 64.
  • Permissão Linux sudo .
  • Uma ligação à Internet ou uma forma de transferir ficheiros de um computador que tenha uma ligação à Internet para o seu computador. Para obter mais informações, consulte Instalar o SDK sem uma conexão com a Internet.

Adicionar pacotes Linux necessários

Antes de executar o script de instalação do SDK, você precisa adicionar os pacotes Linux necessários ao seu computador se eles ainda não estiverem instalados. Digite as seguintes linhas em um terminal 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 estes passos:

  1. Faça o download do 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 o seguinte:

    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 a -y bandeira:

    sudo ./install_azure_sphere_sdk.sh -y

    Sem o -y sinalizador, o script esperará 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 de chave pública da Microsoft e verifique se o valor de impressão digital hexadecimal exibido durante a instalação corresponde à impressão digital de 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 login novamente no aplicativo da área de trabalho ou no shell de login para inicializar a CLI.

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

O script instala o SDK em /opt/azurespheresdk e as toolchains em /opt/azurespheresdk/Sysroots/sysroot-version/tools, onde sysroot-version identifica um sysroot em relação ao qual o SDK suporta o desenvolvimento de aplicativos.

O instalador instala as versões CLI do Azure Sphere e CLI clássica do Azure Sphere da CLI. 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 /opt/azurespheresdk/Tools_v2 e a CLI clássica do Azure Sphere é instalada em /opt/azurespheresdk/Tools.

No Linux, você pode executar a CLI do Azure Sphere a partir de um terminal usando azsphere_v2 e azsphere se ela foi selecionada como a CLI padrão durante a instalação.

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.

Regras Udev

O SDK do Azure Sphere especifica udev regras para as informações do dispositivo do seu computador. O SDK cria um novo grupo chamado azsphere e adiciona o usuário conectado no momento ao grupo. A udev regra concede a propriedade de dispositivos USB correspondentes à descrição do dispositivo Azure Sphere. Depois de instalar o SDK e reiniciar o computador, você não precisará usar sudo para recuperação de dispositivo ou depuração 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 esses arquivos para um computador conectado à Internet e transferi-los para o computador de instalação.

  1. Transfira estes ficheiros e transfira-os para o computador de instalação:

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

      O ficheiro descarregado é um ficheiro tar comprimido (ficheiro .tar.gz ) com um nome que começa Azure_Sphere_SDK_Bundle.

    • Script de instalação: 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 para a qual você transferiu os arquivos.

  3. Extraia o conteúdo do arquivo de script de instalação 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. Deixe o Azure Sphere SDK Bundle como um arquivo tar compactado (arquivo tar.gz ).

  4. Execute o script de instalação usando sudoo . 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

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

Configurar o ambiente de desenvolvimento

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

Instale CMake e Ninja

Para instalar o CMake e o Ninja, primeiro consulte as instruções para adicionar o Kitware APT Repository à sua instalação e, em seguida, 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 o Visual Studio Code como seu ambiente de desenvolvimento, precisará instalá-lo e a Extensão do Azure Sphere.

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

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

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

Próximos passos

Reclame o seu dispositivo