image-package
Gère les images Azure Sphere sur disque.
| Opération | Description |
|---|---|
| pack-application | Crée un package d’images. |
| pack-board-config | Crée un package d’image de configuration de carte. |
| Montrer | Affiche les détails d’un package d’images. |
pack-application
Crée une application exécutable à partir d’une image compilée et liée et d’un fichier app_manifest.json.
Les applications en temps réel (RTApps) sont générées en tant que fichiers ELF ou AXF et non en tant que fichiers binaires bruts. Avant d’empaqueter une application en temps réel, modifiez le fichier manifeste de l’application afin qu’ApplicationType soit défini sur « RealTimeCapable » et que EntryPoint soit défini sur le nom du fichier ELF ou AXF, qui doit se trouver à la racine du répertoire de l’application.
Pointe
Cette commande est exécutée lorsque vous générez une application de haut niveau ou une application en temps réel à l’aide de Visual Studio Code ou de Visual Studio.
- Le processus de génération crée un répertoire approot<app-name> , qui est le répertoire d’entrée spécifié dans le
--package-directoryparamètre . - Le fichier manifeste de l’application est fourni dans le
--application-manifestparamètre . - Pour les applications générales, une version du runtime d’application est fournie dans le
--target-api-setparamètre .
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| --Destination | Chemin d’accès au package d’image | Spécifie un chemin d’accès et un nom de fichier pour le package d’image de sortie. |
| --package-directory | Chemin d’accès à approot_folder | Identifie le répertoire d’entrée, qui est utilisé comme racine système pour le fichier image Azure Sphere. Le fichier app_manifest.json de l’application doit se trouver dans ce répertoire. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| -a, --application-manifest | String | Spécifie le chemin d’accès au fichier manifeste de l’application. Il peut s’agir d’un fichier JSON ou d’un répertoire qui contient app_manifest.json. Vous pouvez fournir un chemin d’accès relatif ou absolu. |
| --hardware-definitions | String | Spécifie une liste facultative de chemins d’accès séparés par des espaces aux répertoires contenant des fichiers de définition matérielle (JSON). Les valeurs des fichiers sont utilisées pour mapper des noms de périphériques dans app_manifest.json aux valeurs sous-jacentes. Vous pouvez fournir un chemin d’accès relatif ou absolu. Pour plus d’informations, consultez Définition matérielle . |
| --target-api-set | String | Spécifie le nom du jeu d’API cible utilisé pendant la compilation. Obligatoire pour les applications de haut niveau s’il n’est pas spécifié dans le manifeste de l’application. Non requis pour les applications en temps réel. |
| --target-definition-filename | String | Spécifie le nom du fichier de définition de cible matérielle utilisé pour mapper les noms de périphériques dans app_manifest.json. Elle doit être fournie si l’application utilise des définitions matérielles. |
| -x, --exécutables | exécutable1,exécutable2 ... | Spécifie les chemins d’accès à un ou plusieurs fichiers à marquer comme exécutables dans le package d’images. Le entryPoint répertorié dans les fichiers app_manifest est toujours marqué comme exécutable. L’indicateur -x est donc requis uniquement si d’autres exécutables sont présents. Par défaut, les fichiers ne sont pas exécutables lorsqu’ils sont empaquetés dans une image. Les sous-chemins d’accès sont relatifs au chemin des exécutables. Les chemins d’accès peuvent utiliser la syntaxe de nom de fichier Windows (barres obliques inverses) ou la syntaxe de nom de fichier Linux (barres obliques) ; les espaces, les virgules et les points-virgules ne sont pas autorisés. Vous pouvez spécifier -x pour chaque fichier exécutable ou l’utiliser une seule fois et fournir plusieurs chemins séparés par des virgules sans espace intermédiaire. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interroger la sortie de la commande Azure CLI . |
| --Verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
Crée un package d’image de configuration de carte. Vous pouvez utiliser une image de configuration de carte prédéfinie ou fournir une image de configuration personnalisée.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| --Destination | String | Spécifie un chemin d’accès au nom de fichier de sortie pour le package d’image obtenu. |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
| --board-config-file | Chemin | Identifie le chemin d’accès à l’image de configuration de la carte. Si cela est inclus, --preset ne doit pas être utilisé ; les deux paramètres s’excluent mutuellement. |
| -n, --name | String | Définit le nom du package d’image dans les métadonnées du fichier créé. S’il n’est pas fourni, un nouveau nom est généré en fonction de la configuration de la carte fournie, en incorporant une partie de l’ID du composant pour l’unicité. |
| -p, --preset | String | Fournit l’ID de l’image de configuration du tableau prédéfini à appliquer. Entrez l’ID d’un package prédéfini ou indiquez un chemin d’accès pour le fichier de configuration de tableau à l’aide du --board-config-file paramètre pour une image de configuration de carte personnalisée. L’ID est une valeur d’énumération et est actuellement fixe à la valeur lan-enc28j60-isu0-int5unique . |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interroger la sortie de la commande Azure CLI . |
| --Verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
Montrer
Affiche des informations sur un package d’images.
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
| -f, --image-package | String | Spécifie le chemin d’accès au package d’image. Vous pouvez fournir un chemin d’accès relatif ou absolu. |
Paramètres globaux
Les paramètres globaux suivants sont disponibles pour l’interface CLI Azure Sphere :
| Paramètre | Description |
|---|---|
| --Debug | Augmente le niveau de détail de la journalisation pour afficher tous les journaux de débogage. Si vous trouvez un bogue, fournissez la sortie générée avec l’indicateur activé lors de l’envoi --debug d’un rapport de bogue. |
| -h, --help | Imprime les informations de référence de l’interface CLI sur les commandes et leurs arguments et listes de sous-groupes et commandes disponibles. |
| --only-show-errors | Affiche uniquement les erreurs, en supprimant les avertissements. |
| -o, --output | Modifie le format de sortie. Les formats de sortie disponibles sont json, jsonc (JSON colorisé), tsv (Valeurs séparées par des tabulations), table (tables ASCII lisibles par l’utilisateur) et yaml. Par défaut, l’interface CLI génère table. Pour en savoir plus sur les formats de sortie disponibles, consultez Format de sortie pour les commandes CLI Azure Sphere. |
| --Requête | Utilise le langage de requête JMESPath pour filtrer la sortie retournée par les services de sécurité Azure Sphere. Pour plus d’informations et d’exemples, consultez le didacticiel JMESPath et interroger la sortie de la commande Azure CLI . |
| --Verbose | Imprime des informations sur les ressources créées dans Azure Sphere pendant une opération et d’autres informations utiles. Utilisez pour les --debug journaux de débogage complets. |
Note
Si vous utilisez l’interface CLI classique Azure Sphere, consultez Paramètres globaux pour plus d’informations sur les options disponibles.
Exemple
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