Guida introduttiva: Installare Azure Sphere SDK per Linux

Articolo
10/17/2024

Importante

Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).

È possibile installare Azure Sphere SDK in un computer che esegue il sistema operativo Linux per sviluppare, distribuire e sottoporre a debug le applicazioni Azure Sphere.

Prerequisiti

Per l'installazione di Azure Sphere SDK sono necessari i prerequisiti seguenti:

Kit di sviluppo di Azure Sphere.
Un computer con un processore basato su x86-64 che esegue Ubuntu 24.04 a 64 bit (versione non rilasciata), Ubuntu 22.04 LTS o Ubuntu 20.04 LTS. Sono supportati solo processori x86-64 compatibili con Intel; altre architetture come ARM (incluso Raspberry Pi), Itanium o SPARC non sono supportate. L'architettura x86-64 è nota anche come x64, x86_64, AMD64 e Intel 64.
Autorizzazione sudo di Linux.
Una connessione Internet o un modo per trasferire file da un computer dotato di connessione Internet al proprio computer. Per altre informazioni, vedere Installare l'SDK senza una connessione Internet.

Aggiungere i pacchetti Linux necessari

Prima di eseguire lo script di installazione dell'SDK, è necessario aggiungere al computer i pacchetti Linux necessari, se non sono già installati. Immettere le righe seguenti in un terminale Linux. È possibile omettere i pacchetti già installati.

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

Installare Azure Sphere SDK

Seguire questa procedura:

Scaricare lo script di installazione.
Passare alla cartella in cui è stato scaricato il file compresso.
Estrarre il contenuto del file compresso. Ad esempio: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Il file .tar.gz contiene il file install_azure_sphere_sdk.sh.
Eseguire lo script di installazione usando sudo il comando seguente:
```
sudo ./install_azure_sphere_sdk.sh
```
Se viene visualizzato l'errore command not found durante l'esecuzione dello script, abilitare l'esecuzione dello script di installazione con questo comando:
```
chmod +x install_azure_sphere_sdk.sh
```

Durante l'installazione, lo script visualizza i messaggi di conferma. I messaggi di conferma possono essere ignorati richiamando lo script con il -y flag :

sudo ./install_azure_sphere_sdk.sh -y

Senza il -y flag, lo script prevede risposte alle richieste seguenti:

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)

Passare al sito dell'impronta digitale a chiave pubblica di Microsoft e verificare che il valore dell'impronta digitale esadecimale visualizzato durante l'installazione corrisponda all'impronta digitale della chiave pubblica Microsoft visualizzata nella pagina. Se le due impronte digitali non corrispondono, non continuare.

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)

Selezionare questa opzione Y per impostare l'interfaccia della riga di comando di Azure Sphere come interfaccia della riga di comando predefinita o N impostare l'interfaccia della riga di comando classica di Azure Sphere come interfaccia della riga di comando predefinita.

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)

Selezionare questa opzione per configurare Y il gruppo azsphere e creare la regola udev.

Al termine dell'installazione, è necessario accedere di nuovo all'applicazione desktop o alla shell di accesso per inizializzare l'interfaccia della riga di comando.

Dopo l'installazione, il comando azsphere si trova nel percorso e le nuove regole udev per il dispositivo si trovano in /etc/udev/rules.d/.

Lo script installa l'SDK nel percorso /opt/azurespheresdk e le toolchain in /opt/azurespheresdk/Sysroots/sysroot-version/tools, dove sysroot-version identifica una versione di sysroot in cui l'SDK supporta lo sviluppo di app.

Il programma di installazione installa sia l'interfaccia della riga di comando di Azure Sphere che le versioni classiche dell'interfaccia della riga di comando di Azure Sphere . Non è necessario disinstallare la versione corrente perché l'installazione aggiornerà qualsiasi versione esistente. L'interfaccia della riga di comando di Azure Sphere è installata in /opt/azurespheresdk/Tools_v2 e l'interfaccia della riga di comando classica di Azure Sphere è installata in /opt/azurespheresdk/Tools.

In Linux è possibile eseguire l'interfaccia della riga di comando di Azure Sphere da un terminale usando azsphere_v2 e azsphere se è stata selezionata come interfaccia della riga di comando predefinita durante l'installazione.

Dopo aver installato l'interfaccia della riga di comando per la prima volta, verificare che sia installata e che la versione sia corretta eseguendo azsphere show-version.

Regole Udev

Azure Sphere SDK specifica le regole udev per le informazioni sul dispositivo del computer. L'SDK crea un nuovo gruppo denominato azsphere e aggiunge l'utente attualmente connesso al gruppo. La regola udev concede la proprietà dei dispositivi USB corrispondenti alla descrizione del dispositivo Azure Sphere. Dopo aver installato l'SDK e riavviato il computer, non sarà necessario usare sudo per il ripristino del dispositivo o il debug di ARM Cortex-M4.

Il gruppo azsphere viene aggiunto per concedere le autorizzazioni con la regola udev. Non modificare il gruppo manualmente.

Installare l'SDK senza connessione Internet

Se non si dispone di una connessione Internet nel computer in cui si sta installando l'SDK, è necessario scaricare questi file in un computer connesso a Internet e trasferirli nel computer di installazione.

Scaricare questi file e trasferirli nel computer di installazione:
- Azure Sphere SDK per Linux: scegliere Tra Ubuntu 24.04 (versione non rilasciata), Ubuntu 22.04 LTS o Ubuntu 20.04 LTS.
  
  Il file scaricato è un file tar compresso (file .tar.gz ) con un nome che inizia Azure_Sphere_SDK_Bundle.
- Script di installazione: si tratta di un file tar compresso (file .tar.gz) con un nome che inizia install_azure_sphere_sdk.
- Chiave pubblica gpg di Microsoft: si tratta di un file di testo ASCII.
Nel computer di installazione passare alla cartella in cui sono stati trasferiti i file.
Estrarre il contenuto del file di script di installazione compresso. Ad esempio: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Il file .tar.gz contiene il file install_azure_sphere_sdk.sh. Lasciare il bundle azure Sphere SDK come file tar compresso (file tar.gz ).
Eseguire lo script di installazione usando sudo. Includere il -i parametro per specificare il percorso del bundle SDK e il -k parametro per specificare il percorso della chiave. Il comando dovrà essere simile a questo:

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

Se viene visualizzato l'errore command not found durante l'esecuzione dello script, abilitare l'esecuzione dello script di installazione con questo comando:
```
chmod +x install_azure_sphere_sdk.sh
```

Procedere con l'installazione come descritto in Installare Azure Sphere SDK.

Configurare l'ambiente di sviluppo

È possibile sviluppare app Azure Sphere in Linux usando Visual Studio Code o l'interfaccia della riga di comando. Indipendentemente dallo strumento usato, è necessario installare CMake e Ninja nel computer di sviluppo, se non sono già presenti. Vedere le istruzioni per aggiungere il repository APT kitware all'installazione.

Installare CMake e Ninja

Per installare CMake e Ninja, vedere prima di tutto le istruzioni per aggiungere il repository APT kitware all'installazione e quindi usare il comando seguente:

sudo apt-get install cmake ninja-build

Nota

Non installare CMake o Ninja usando snap.

Installare l'estensione Azure Sphere per Visual Studio Code

Se si vuole usare Visual Studio Code come ambiente di sviluppo, è necessario installarlo e l'estensione Azure Sphere.

Usare i collegamenti in Scaricare Visual Studio Code per installare Visual Studio Code , se non è già stato fatto.
Per installare l'estensione Azure Sphere, cercare "Azure Sphere" in Extension Marketplace da un browser o in Visual Studio Code. Verranno visualizzati due risultati, Azure Sphere e l'interfaccia utente di Azure Sphere. Selezionare Installa per uno dei due. L'altro deve essere installato automaticamente.
Dopo l'installazione nel riquadro delle estensioni abilitate dell'IDE di Visual Studio Code verranno visualizzati Azure Sphere, C/ C++ e le estensioni di CMake Tools.

Al termine dell'installazione, verrà aperta la pagina Leggimi per l'estensione. La pagina Leggimi fornisce informazioni utili sulla configurazione e i requisiti di Visual Studio Code e viene aggiornata insieme all'estensione . È possibile visualizzare la pagina Leggimi in qualsiasi momento aprendo il riquadro Estensioni e selezionando Azure Sphere.

Passaggi successivi

Richiedere il dispositivo

Condividi tramite