Creare un'applicazione di alto livello

Il modo più semplice per creare una nuova applicazione di alto livello consiste nell'iniziare con il modello Vuoto dall'estensione Visual Studio Code Azure Sphere e modificare la configurazione al progetto seguendo questa procedura:

1. Avvia Visual Studio Code. Seleziona Visualizza>tavolozza comandi, quindi digita Azure Sphere: Genera nuovo progetto.

   

2. Scegliere HL Blank dal menu Modelli.

   

3. Visual Studio Code visualizza quindi una finestra Esplora file. Passare alla cartella in cui si vuole inserire l'applicazione vuota e specificare un nome per il progetto, ad esempio NewHLApp. Visual Studio Code crea la cartella NewHLApp nella posizione selezionata e genera i file di compilazione per l'applicazione vuota. Dovrebbero essere visualizzati i messaggi da CMake.

4. Aprire il file CMakeLists.txt e specificare la cartella contenente le definizioni per l'hardware in uso. Per impostazione predefinita, l'applicazione HL Blank non contiene definizioni hardware. È possibile trovare definizioni hardware di esempio nel repository Azure Sphere Samples o crearne una come descritto in Definizioni hardware.

   Di seguito viene illustrato come aggiungere le definizioni hardware di esempio per il Kit di sviluppo Seeed Azure Sphere MT3620:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Questa riga deve essere inserita prima dell'inizio azsphere_target_add_image_packagedel comando finale.

Puoi anche creare una nuova applicazione di alto livello da uno dei campioni azure sphere di alto livello:

1. Clonare il repository dei campioni , se non l'hai già fatto. Copiare una delle cartelle di applicazioni di alto livello e rinominarla per il progetto.

2. Nel file CMakeLists.txt modificare il nome del progetto con il nome della nuova cartella. Per esempio:

   PROJECT(NewHLApp C)

Il modo più semplice per creare una nuova applicazione di alto livello consiste nell'iniziare con il modello Vuoto dall'estensione Visual Studio Azure Sphere e modificare la configurazione al progetto seguendo questa procedura:

1. Avviare Visual Studio e selezionare Crea un nuovo progetto.

2. Digitare Azure Sphere nella casella di ricerca cerca modelli. Seleziona Azure Sphere HLCore Blank dall'elenco restituito, quindi seleziona Avanti.

3. Specificare un nome di progetto (ad esempio, NewHLApp), un percorso del file di progetto e un nome di soluzione (che può essere uguale al nome del progetto), quindi selezionare Crea. Visual Studio crea la cartella NewHLpp nella posizione selezionata e genera i file di compilazione per l'applicazione vuota. Dovrebbero essere visualizzati i messaggi da CMake.

4. Aprire il file CMakeLists.txt e specificare la cartella contenente le definizioni per l'hardware in uso. Per impostazione predefinita, l'applicazione HL Blank non contiene definizioni hardware. È possibile trovare definizioni hardware di esempio nel repository Azure Sphere Samples o crearne una come descritto in Definizioni hardware.

   Di seguito viene illustrato come aggiungere le definizioni hardware di esempio per il Kit di sviluppo Seeed Azure Sphere MT3620:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Questa riga deve essere inserita prima dell'inizio azsphere_target_add_image_packagedel comando finale.

Puoi anche creare una nuova applicazione di alto livello da uno dei campioni azure sphere di alto livello:

1. Clonare il repository dei campioni , se non l'hai già fatto. Copiare una delle cartelle di applicazioni di alto livello e rinominarla per il progetto.

2. Nel file CMakeLists.txt modificare il nome del progetto con il nome della nuova cartella. Per esempio:

   PROJECT(NewHLApp C)

Il modo più semplice per creare una nuova applicazione di alto livello consiste nell'iniziare con uno dei campioni azure sphere di alto livello:

1. Clonare il repository dei campioni , se non l'hai già fatto. Copiare una delle cartelle di applicazioni di alto livello e rinominarla per il progetto.

2. Nel file CMakeLists.txt modificare il nome del progetto con il nome della nuova cartella. Per esempio:

   PROJECT(NewHLApp C)

Struttura di file di base di un'applicazione di alto livello

Indipendentemente da come crei l'applicazione, tutte le applicazioni Azure Sphere condividono i seguenti file di base:

• Codice sorgente dell'applicazione in uno o più file. Attualmente è supportato solo il codice sorgente della lingua C.
• CMake file di compilazione. CMakeLists.txt è obbligatorio. CMake, insieme all'utilità di compilazione leggera ninja, viene utilizzata per controllare il processo di compilazione dell'applicazione Azure Sphere.
• Un file manifesto di app che descrive le funzionalità disponibili per l'applicazione.

Le applicazioni di alto livello in genere hanno almeno altri tre file:

• Un file applibs-versions.h per specificare i livelli di versione delle varie API Azure Sphere
• Due file di definizione hardware (una versione modificabile in formato JSON e un linguaggio C includono file generati da esso) che forniscono un modo pratico per fare riferimento ai componenti hardware nel codice. Con un set coerente di file di definizione hardware, è possibile scrivere codice sorgente indipendente dall'hardware e quindi creare immagini dell'applicazione per hardware specifico semplicemente reindirizzando il file di definizione hardware appropriato nel file di CMakeLists.txt.

Scrivere il codice

1. Scrivi il codice dell'applicazione usando gli esempi di app di alto livello Azure Sphere come guide. Gli argomenti seguenti descrivono scenari di implementazione specifici:
   • Usare le periferiche in un'applicazione di alto livello
   • Connettersi ai servizi Web
   • Usare wolfSSL per connessioni TLS
   • Gestire i certificati
   • Informazioni sull'uso della memoria
   • Rinvia gli aggiornamenti dei dispositivi
   • Gestire l'ora e usare l'orologio in tempo reale
   • Usare l'archiviazione del dispositivo
   • Comunicare con un'applicazione in tempo reale
   • Gestisci lo stato Disacco attivo
   • Impostare i profili di alimentazione
   • Eseguire l'individuazione del servizio
2. Nel fileCMakeLists.txt:
   • Specificare la revisione degli strumenti di Azure Sphere SDK
   • Specificare il set di API di destinazione
   • Specificare l'hardware di destinazione
3. Nel file app_manifest.json:
   • Impostare Name il nome del progetto.
   • Aggiungere le funzionalità specifiche dell'applicazione necessarie al codice, ad esempio le risorse hardware o le connessioni. Se l'app di alto livello comunica con un'RTApp, aggiungi l'ID componente dell'applicazione di alto livello alla AllowedApplicationConnections funzionalità.

Se desideri distribuire l'app di alto livello insieme a un'app partner in tempo reale, aggiungi l'ID componente del partner al campo partnerComponents della sezione delle configurazioni del file launch.vs.json (Visual Studio) o .vscode/launch.json (Visual Studio Code):

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

Vedere anche

• Creare un'applicazione di alto livello.
• Eseguire il debug di un'applicazione di alto livello.