paquete de imagen
Administra imágenes de Azure Sphere en disco.
| Operación | Descripción |
|---|---|
| aplicación de paquete | Crea un paquete de imagen. |
| pack-board-config | Crea un paquete de imagen de configuración de placa. |
| Mostrar | Muestra detalles sobre un paquete de imagen. |
aplicación de paquete
Crea una aplicación ejecutable a partir de una imagen compilada y vinculada y un archivo app_manifest.json.
Las aplicaciones compatibles con tiempo real (RTApps) se crean como archivos ELF o AXF y no como archivos binarios sin procesar. Antes de empaquetar una RTApp, edite el archivo de manifiesto de la aplicación para que ApplicationType se establezca en "RealTimeCapable", y EntryPoint se establece en el nombre del archivo ELF o AXF, que debe estar en la raíz del directorio de la aplicación.
Propina
Este comando se ejecuta al crear una aplicación de alto nivel o una aplicación compatible con tiempo real con Visual Studio Code o Visual Studio.
- El proceso de compilación crea un directorio approot<app-name> , que es el directorio de entrada especificado en el
--package-directoryparámetro. - El archivo de manifiesto de la aplicación se proporciona en el
--application-manifestparámetro. - Para aplicaciones de alto nivel, se proporciona una versión en tiempo de ejecución de la aplicación en el
--target-api-setparámetro.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| --Destino | Ruta de acceso al paquete de imagen | Especifica una ruta de acceso y un nombre de archivo para el paquete de imagen de salida. |
| --package-directory | Ruta de acceso a approot_folder | Identifica el directorio de entrada, que se usa como la raíz del sistema para el archivo de imagen de Azure Sphere. El archivo app_manifest.json de la aplicación debe estar en este directorio. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a, --application-manifest | Cadena | Especifica la ruta de acceso al archivo de manifiesto de la aplicación. Puede ser un archivo JSON o un directorio que contiene app_manifest.json. Puede proporcionar una ruta relativa o absoluta. |
| --hardware-definitions | Cadena | Especifica una lista opcional de rutas de acceso separadas por espacio a los directorios que contienen archivos de definición de hardware (JSON). Los valores de los archivos se usan para asignar nombres de periféricos en app_manifest.json a los valores subyacentes. Puede proporcionar una ruta de acceso relativa o absoluta. Consulta definición de hardware para obtener más información. |
| --target-api-set | Cadena | Especifica el nombre del conjunto de API de destino usado durante la compilación. Necesario para las aplicaciones de alto nivel si no se especifica en el manifiesto de la aplicación. No es necesario para RTApps. |
| --target-definition-filename | Cadena | Especifica el nombre del archivo de definición de destino de hardware que se usa para asignar nombres de periféricos en app_manifest.json. Debe proporcionarse si la aplicación usa definiciones de hardware. |
| -x, --ejecutables | ejecutable1,ejecutable2 ... | Especifica las rutas de acceso a uno o más archivos que se marcan como ejecutables en el paquete de imagen. El EntryPoint enumerado en los archivos app_manifest siempre se marca como ejecutable, por lo que la marca -x solo es necesaria si hay otros ejecutables presentes. De forma predeterminada, los archivos no son ejecutables cuando se empaquetan en una imagen. Las sub rutas de acceso son relativas a la ruta de acceso de los archivos ejecutables. Las rutas pueden usar la sintaxis del nombre de archivo de Windows (barras diagonales inversas) o la sintaxis del nombre de archivo de Linux (barras diagonales); no se permiten espacios, comas ni punto y coma. Puede especificar -x para cada archivo ejecutable o usarlo solo una vez y proporcionar varias rutas de acceso separadas por comas sin espacios intermedios. |
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
Crea un paquete de imagen de configuración de placa. Puede utilizar una imagen de configuración de placa preestablecida o proporcionar una imagen de configuración personalizada.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| --Destino | Cadena | Especifica una ruta de acceso al nombre de archivo de salida para el paquete de imagen resultante. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| --board-config-file | Camino | Identifica la ruta de acceso a la imagen de configuración de la placa. Si esto se incluye, --preset no se debe usar; los dos parámetros se excluyen mutuamente. |
| -n, --name | Cadena | Establece el nombre del paquete de imagen en los metadatos del archivo creado. Si no se proporciona, se generará un nuevo nombre en función de la configuración de placa proporcionada, incorporando parte del id. de componente para unicidad. |
| -p, --preset | Cadena | Proporciona el id. de la imagen de configuración preestablecida de la placa para aplicarla. Escriba el id. de un paquete preestablecido o proporcione una ruta de acceso para el archivo de configuración del panel mediante el --board-config-file parámetro de una imagen de configuración de placa personalizada. El id. es un valor de enumeración y actualmente se fija al valor lan-enc28j60-isu0-int5único . |
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
Mostrar
Muestra información sobre un paquete de imagen.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -f, --image-package | Cadena | Especifica la ruta de acceso al paquete de imagen. Puede proporcionar una ruta de acceso relativa o absoluta. |
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
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