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

Artigo
10/17/2024

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:

Baixe o script de instalação.
Navegue até a pasta na qual você baixou o arquivo compactado.
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.
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
```

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.

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 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 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) é instalada em /opt/azurespheresdk/Tools_v2 e a CLI clássica do Azure Sphere (Herdado) é 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 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 os arquivos para um computador conectado à Internet e transferi-los para o computador de instalação.

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.
- 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.
No computador de instalação, navegue até a pasta para a qual você transferiu os arquivos.
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).
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.

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:

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, consulte Baixar e executar a extensão do Azure Sphere.

Configurar seu ambiente de desenvolvimento

Desenvolva aplicativos do Azure Sphere no Linux usando o Visual Studio Code ou a CLI (interface de linha de comando). Independentemente do seu uso, você precisará instalar o CMake e o Ninja no computador de desenvolvimento caso ainda não o tenha feito. Consulte as instruções para adicionar o Repositório Kitware APT à sua instalação.

Instalar o CMake e o 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

Observação

Não instale o CMake nem o 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.

Use os links em Baixar o Visual Studio Code para instalar o Visual Studio Code, caso ainda não tenha feito isso.
Para instalar a extensão do Azure Sphere, pesquise "Azure Sphere" no Marketplace de Extensões em um navegador ou no Visual Studio Code. Você deve ver dois resultados, Azure Sphere e Interface do usuário do Azure Sphere. Selecione Instalar para qualquer um; o outro deve ser instalado automaticamente.
Após a instalação, você deverá ver as extensões Azure Sphere, C/C++ e Ferramentas CMake no painel Extensões HABILITADAS no IDE do Visual Studio Code.

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óximas etapas

Declarar dispositivo