Guida introduttiva: Installare Azure Sphere SDK per Linux

È 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 LTS a 64 bit o Ubuntu 22.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)

Selezionare questa opzione Y per avviare l'installazione.

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.

By proceeding with this installation you agree to the license terms available at https://aka.ms/AzureSphereSDKLicense/Linux and which will be installed to /opt/azurespheresdk. Proceed? (Y/N) y
Uninstalling previous instance.
Installing SDK files.
Installing toolchain version 'xx'.
Installing toolchain version 'xx'.
Installing toolchain version 'xx'.
Installing toolchain version 'xx+Betaxxxx'.
Installing CLI.
SDK installed to '/opt/azurespheresdk'.
Installing Device Communication service.
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 (xxx) to it? (Y/N) y
Add the Azure Sphere CLI to the PATH for all users (this will add a file to /etc/profile.d/)? (Y/N) y
Azure Sphere CLI added to PATH for all users. You will need to restart your user session for this change to take effect.
Azure Sphere SDK installation complete. Visit https://aka.ms/AzureSphereSDK for documentation and samples.

Suggerimento

Selezionare Y per configurare 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 di Azure Sphere (legacy).

Dopo l'installazione, il azsphere comando 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 l'interfaccia della riga di comando di Azure Sphere (Legacy). Non è necessario disinstallare la versione corrente perché l'installazione aggiornerà qualsiasi versione esistente.

L'interfaccia della riga di comando di Azure Sphere (legacy) è installata in /opt/azurespheresdk/Tools_v2.

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 i 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 LTS o Ubuntu 22.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.

Installare l'estensione Azure Sphere per l'interfaccia della riga di comando di Azure

Lo strumento da riga di comando per la gestione di dispositivi collegati e distribuzioni cloud di Azure Sphere viene distribuito come estensione dell'interfaccia della riga di comando di Azure. Per aggiungere o aggiornare l'estensione, seguire questa procedura:

Se non è ancora stato fatto, installare l'interfaccia della riga di comando di Azure.

Per aggiungere l'estensione Azure Sphere, eseguire il comando seguente:
```
az extension add --name azure-sphere
```
Per aggiornare l'estensione Azure Sphere, eseguire il comando seguente:
```
az extension update --name azure-sphere
```

È necessario accedere con l'interfaccia della riga di comando di Azure per accedere alla sottoscrizione di Azure che si vuole usare per gestire i dispositivi Azure Sphere.

Per altre informazioni, vedere Scaricare ed eseguire l'estensione Azure Sphere.

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