pacchetto di immagini
Gestisce le immagini di Azure Sphere su disco.
| Operazione | Descrizione |
|---|---|
| pack-application | Crea un pacchetto di immagini. |
| configurazione delle bacheca | Crea un pacchetto immagine di configurazione della bacheca. |
| Visualizza | Visualizza i dettagli su un pacchetto di immagini. |
pack-application
Crea un'applicazione eseguibile da un'immagine compilata e collegata e da un file app_manifest.json.
Le applicazioni in tempo reale (RTApps) sono create come file ELF o AXF e non come file binari RAW. Prima di creare il pacchetto di un'RTApp, modificare il file manifesto dell'applicazione in modo che ApplicationType sia impostato su "RealTimeCapable" e EntryPoint sia impostato sul nome del file ELF o AXF, che deve trovarsi nella radice della directory dell'applicazione.
Mancia
Questo comando viene eseguito quando si crea un'applicazione di alto livello o un'applicazione in tempo reale che supporta Visual Studio Code o Visual Studio.
- Il processo di compilazione crea una directory approot<nome-app> , che è la directory di input specificata nel
--package-directoryparametro. - Il file manifesto dell'applicazione viene fornito nel
--application-manifestparametro. - Per le applicazioni di alto livello, nel parametro viene fornita una versione di runtime dell'applicazione
--target-api-set.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| --Destinazione | Percorso del pacchetto di immagini | Specifica un percorso e un nome file per il pacchetto dell'immagine di output. |
| --package-directory | Percorso di approot_folder | Identifica la directory di input, che viene utilizzata come radice di sistema per il file di immagine Azure Sphere. Il file app_manifest.json per l'applicazione deve trovarsi in questa directory. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| -a, --application-manifest | Stringa | Specifica il percorso del file manifesto dell'applicazione. Può trattarsi di un file JSON o di una directory che contiene app_manifest.json. È possibile fornire un percorso relativo o assoluto. |
| --definizioni hardware | Stringa | Specifica un elenco facoltativo di percorsi separati da spazio per le directory contenenti file di definizione hardware (JSON). I valori dei file vengono utilizzati per eseguire il mapping dei nomi delle periferiche in app_manifest.json ai valori sottostanti. È possibile fornire un percorso relativo o assoluto. Per altre informazioni, vedere la definizione hardware . |
| --target-api-set | Stringa | Specifica il nome del set di API di destinazione utilizzato durante la compilazione. Obbligatorio per le app di alto livello se non specificato nel manifesto dell'app. Non richiesto per RTApps. |
| --target-definition-filename | Stringa | Specifica il nome del file di definizione della destinazione hardware usato per eseguire il mapping dei nomi delle periferiche in app_manifest.json. Deve essere fornito se l'applicazione utilizza definizioni hardware. |
| -x, --eseguibili | eseguibile1,eseguibile2 ... | Specifica i percorsi di uno o più file da contrassegnare come eseguibili nel pacchetto di immagini. EntryPoint elencato nei file app_manifest è sempre contrassegnato come eseguibile, quindi il flag -x è necessario solo se sono presenti altri file eseguibili. Per impostazione predefinita, i file non sono eseguibili quando vengono inseriti in un pacchetto in un'immagine. I percorsi secondari sono relativi al percorso degli eseguibili. I percorsi possono utilizzare la sintassi del nome file di Windows (barre rovesciate) o la sintassi del nome file Linux (barre); spazi, virgole e punti e virgola non sono consentiti. È possibile specificare -x per ogni file eseguibile oppure usarlo una sola volta e fornire più percorsi separati da virgole senza intervenire in spazi. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
configurazione delle bacheca
Crea un pacchetto immagine di configurazione della bacheca. È possibile usare un'immagine di configurazione della scheda preimpostata o fornire un'immagine di configurazione personalizzata.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| --Destinazione | Stringa | Specifica un percorso del nome file di output per il pacchetto di immagini risultante. |
Parametri facoltativi
| Parametro | Digitare | Descrizione |
|---|---|---|
| --board-config-file | Percorso | Identifica il percorso dell'immagine di configurazione della bacheca. Se questo parametro è incluso, --preset non deve essere utilizzato; i due parametri si escludono a vicenda. |
| -n, --name | Stringa | Imposta il nome del pacchetto di immagini nei metadati del file creato. Se non viene fornito, verrà generato un nuovo nome in base alla configurazione della scheda fornita, che incorpora parte dell'ID componente per l'univocità. |
| -p, --preset | Stringa | Fornisce l'ID dell'immagine di configurazione della scheda preimpostata da applicare. Immettere l'ID di un pacchetto preimpostato o fornire un percorso per il file di configurazione della bacheca usando il --board-config-file parametro per un'immagine di configurazione della scheda personalizzata. L'ID è un valore di enumerazione ed è attualmente fisso sul singolo valore lan-enc28j60-isu0-int5. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
Visualizza
Visualizza informazioni su un pacchetto di immagini.
Parametri obbligatori
| Parametro | Digitare | Descrizione |
|---|---|---|
| -f, --image-package | Stringa | Specifica il percorso del pacchetto di immagini. È possibile fornire un percorso relativo o assoluto. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
| Parametro | Descrizione |
|---|---|
| --debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
| -h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
| --only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
| -o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
| --Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
| --Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere image-package show --image-package C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage
Image package metadata:
Section: Identity
Image Type: Application
Component ID: 99d419ef-296d-43b0-ade1-809efe3a7aba
Image ID: d788fdd1-28eb-4477-9818-a4734289f2f1
Section: Signature
Signing Type: ECDsa256
Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5df0
Section: Debug
Image Name: QuickStart-AzureSphereBlink1
Built On (UTC): 09/07/2020 13:18:52
Built On (Local): 09/07/2020 14:18:52
Section: Temporary Image
Remove image at boot: False
Under development: True
Section: ABI Depends
Depends on: ApplicationRuntime, version 5