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 executando o Ubuntu 24.04 de 64 bits (pré-lançamento), o Ubuntu 22.04 LTS ou o Ubuntu 20.04 LTS. Somente 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 do sudo do Linux.
• Uma conexão com a Internet ou uma maneira de transferir arquivos de um computador que tenha uma conexão com a Internet para seu computador. Para obter mais informações, confira 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 os pacotes do Linux necessários ao seu computador, caso ainda não estejam 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 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 o -y sinalizador:

   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 continue 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á efetuar 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 cadeias de ferramenta em /opt/azurespheresdk/Sysroots/sysroot-version/tools, em que sysroot-version identifica um sysroot no qual o SDK dá suporte ao desenvolvimento de aplicativos.

O instalador instala a CLI do Azure Sphere e as versões da CLI clássica do Azure Sphere 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 é 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 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 do Udev

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

O grupo azsphere é adicionado para conceder permissões usando a regra udev. 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 em que está instalando o SDK, precisará baixar esses 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), 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.

   • 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 Pacote do 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 do SDK e o -k parâmetro para especificar o caminho para a chave. O 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.

Configurar seu ambiente de desenvolvimento

sudo apt-get install cmake ninja-build

Próximas etapas