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

Artigo
03/26/2024

Pode instalar o SDK do Azure Sphere num computador com o sistema operativo Linux para desenvolver, implementar e depurar aplicações 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 com o Ubuntu 24.04 de 64 bits (pré-lançamento), ubuntu 22.04 LTS ou Ubuntu 20.04 LTS. Apenas são suportados processadores x86-64 compatíveis com Intel; outras arquiteturas, como o 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 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, veja Instalar o SDK sem uma ligação à Internet.

Adicionar pacotes do Linux necessários

Antes de executar o script de instalação do SDK, tem de adicionar os pacotes Do Linux necessários ao seu computador, caso ainda não estejam instalados. Introduza as seguintes linhas num terminal do Linux. 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:

Transfira o script de instalação.
Navegue para a pasta para a qual transferiu o ficheiro comprimido.
Extraia o conteúdo do ficheiro comprimido. Por exemplo, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. O ficheiro .tar.gz contém o ficheiro install_azure_sphere_sdk.sh.
Execute o script de instalação com sudo o seguinte:
```
sudo ./install_azure_sphere_sdk.sh
```
Se vir o erro command not found ao executar o script, ative a execução do script de instalação com este comando:
```
chmod +x install_azure_sphere_sdk.sh
```

Durante a instalação, o script apresenta mensagens de confirmação. As mensagens de confirmação podem ser ignoradas ao invocar o script com o sinalizador -y :

sudo ./install_azure_sphere_sdk.sh -y

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

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 para o site de impressões digitais de chave pública da Microsoft e verifique se o valor de impressão digital hexadecimal apresentado durante a instalação corresponde à Impressão Digital da Chave Pública da Microsoft apresentada 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 a CLI predefinida ou N para definir a CLI clássica do Azure Sphere como a CLI predefinida.

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 estiver concluída, tem de iniciar sessão novamente na aplicação de ambiente de trabalho ou na shell de início de sessão para inicializar a CLI do Azure Sphere (Legado).

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

O script instala o SDK para /opt/azurespheresdk e as toolchains para /opt/azurespheresdk/Sysroots/sysroot-version/tools, em que a versão sysroot identifica um sysroot em relação ao qual o SDK suporta o desenvolvimento de aplicações.

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

No Linux, pode executar a CLI do Azure Sphere (Legado) a partir de um terminal com azsphere_v2 e azsphere se foi selecionada como a CLI predefinida durante a instalação.

Depois de instalar a CLI pela primeira vez, verifique se está instalada e se tem a versão correta ao executar a versão show-version do azsphere.

Regras 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 utilizador com sessão iniciada atualmente ao grupo. A udev regra concede a propriedade de dispositivos USB que correspondam à descrição do dispositivo do Azure Sphere. Depois de instalar o SDK e reiniciar o computador, não terá de utilizar sudo para a recuperação do dispositivo ou para a depuração do ARM Cortex-M4.

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

Instalar o SDK sem uma ligação à Internet

Se não tiver uma ligação à Internet no computador no qual está a instalar o SDK, terá de transferir os ficheiros para um computador ligado à Internet e transferi-los para o computador de instalação.

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) ou Ubuntu 22.04 LTS ou Ubuntu 20.04 LTS.
  
  O ficheiro transferido é um ficheiro tar comprimido (ficheiro .tar.gz ) com um nome que começa Azure_Sphere_SDK_Bundle.
- Script de instalação: trata-se de um ficheiro tar comprimido (ficheiro .tar.gz ) com um nome que começa install_azure_sphere_sdk.
- Chave pública gpg da Microsoft: este é um ficheiro de texto ASCII.
No computador de instalação, navegue para a pasta para a qual transferiu os ficheiros.
Extraia o conteúdo do ficheiro de script de instalação comprimido. Por exemplo, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. O ficheiro .tar.gz contém o ficheiro install_azure_sphere_sdk.sh. Deixe o Pacote SDK do Azure Sphere como um ficheiro tar comprimido (tar.gz ficheiro).
Execute o script de instalação com 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 ao seguinte:

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

Se vir o erro command not found ao executar o script, ative 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 comandos para gerir dispositivos ligados ao Azure Sphere e implementações na cloud é distribuída como uma extensão da CLI do Azure. Siga os seguintes passos para adicionar ou atualizar a extensão:

Instale a CLI do Azure se ainda não o tiver feito.

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
```

Tem de Iniciar sessão com a CLI do Azure para iniciar sessão na subscrição do Azure que pretende utilizar para gerir dispositivos do Azure Sphere.

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

Configurar o ambiente de desenvolvimento

Pode desenvolver aplicações do Azure Sphere no Linux com o Visual Studio Code ou a interface de linha de comandos (CLI). Independentemente do que utilizar, terá de instalar o CMake e o Ninja no seu computador de desenvolvimento, caso ainda não os tenha. Veja as instruções para adicionar o Repositório kitware APT à sua instalação.

Instalar cMake e Ninja

Para instalar o CMake e o Ninja, veja primeiro as instruções para adicionar o Repositório Kitware APT à sua instalação e, em seguida, utilize o seguinte comando:

sudo apt-get install cmake ninja-build

Nota

Não instale cmake ou ninja com o snap.

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

Se quiser utilizar o Visual Studio Code como ambiente de desenvolvimento, tem de instalá-lo e a Extensão do Azure Sphere.

Utilize as ligações em Transferir o Visual Studio Code para instalar o Visual Studio Code, caso ainda não o tenha feito.
Para instalar a extensão do Azure Sphere, procure "Azure Sphere" no Marketplace de Extensões a partir de um browser ou do Visual Studio Code. Deverá ver dois resultados: Azure Sphere e IU do Azure Sphere. Selecione Instalar para qualquer um dos dois; o outro deve ser instalado automaticamente.
Após a instalação, deverá ver as extensões Azure Sphere, C/C++ e CMake Tools no painel Extensões ATIVADAS no IDE do Visual Studio Code.

Quando a instalação estiver concluída, será aberta a página Readme da extensão. A página Readme fornece informações úteis sobre a configuração e os requisitos do Visual Studio Code e é atualizada juntamente com a extensão. Pode ver a página Readme em qualquer altura ao abrir o painel Extensões e selecionar Azure Sphere.

Passos seguintes

Reclamar o seu dispositivo