image-package
Importante
Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).
Administra imágenes de Azure Sphere del disco.
| Operación | Descripción |
|---|---|
| pack-application | Crea un paquete de imágenes. |
| pack-board-config | Crea un paquete de imagen de configuración de placa. |
| show | Muestra detalles sobre un paquete de imágenes. |
pack-application
Crea una aplicación ejecutable a partir de una imagen compilada y vinculada y de un archivo app_manifest.json.
Las aplicaciones con respuesta en tiempo real (RTApp) se crean como archivos ELF o AXF y no como archivos binarios sin formato. Antes de empaquetar una RTApp, edite el archivo de manifiesto de aplicación para que ApplicationType esté establecido en "RealTimeCapable" y EntryPoint esté establecido en el nombre del archivo ELF o AXF, que debe estar en la raíz del directorio de la aplicación.
Sugerencia
Este comando se ejecuta al compilar una aplicación de alto nivel o una aplicación con respuesta en tiempo real mediante 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 aplicación se proporciona en el
--application-manifestparámetro . - En el caso de las 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 obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| --destino | Ruta de acceso al paquete de imágenes | 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 raíz del sistema para el archivo de imagen de Azure Sphere. El archivo app_manifest.json para 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 aplicación. Puede ser un archivo JSON o un directorio que contiene app_manifest.json. Puede proporcionar una ruta de acceso relativa o absoluta. |
| --hardware-definitions | Cadena | Especifica una lista opcional separada por espacios de rutas de acceso a los directorios que contienen archivos de definición de hardware (JSON). Los valores de los archivos se usan para asignar nombres periféricos en app_manifest.json a valores subyacentes. Puede proporcionar una ruta de acceso relativa o absoluta. Consulte hardware definition (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 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 usado para asignar nombres periféricos en app_manifest.json. Se debe proporcionar si la aplicación usa definiciones de hardware. |
| -x, --ejecutables | ejecutable1,ejecutable2 ... | Especifica las rutas de acceso a uno o varios archivos que se van a marcar como ejecutables en el paquete de imágenes. El EntryPoint enumerado en los archivos app_manifest siempre está marcado como ejecutable, por lo que la marca -x solo es necesaria si existen otros ejecutables. De forma predeterminada, los archivos no son ejecutables cuando se empaquetan en una imagen. Las subrutas son relativas a la ruta de acceso de los ejecutables. Las rutas de acceso pueden usar la sintaxis de nombre de archivo de Windows (barras diagonales inversas) o la sintaxis de nombre de archivo de Linux (barras diagonales); no se permite espacios, comas ni punto y coma. Puede especificar -x para cada archivo ejecutable o usarla una sola 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 |
|---|---|
| --debug | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca --debug activada al enviar un informe de errores. |
| -h, --help | Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Muestra solo errores, supresión de advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera table. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere. |
| --query | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos. |
| --verbose | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use --debug para los registros de depuración completos. |
Nota:
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para 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 usar una imagen de configuración predefinida de la placa o proporcionar una imagen de configuración personalizada.
Parámetros obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| --destino | Cadena | Especifica una ruta de acceso al nombre de archivo de salida del paquete de imagen resultante. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| --board-config-file | Path | Identifica la ruta de acceso a la imagen de configuración de placa. Si se incluye esto, --preset no se debe usar; los dos parámetros son mutuamente excluyentes. |
| -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 según la configuración de la placa proporcionado, que incorporará una parte del identificador del componente, con el fin de que sea exclusivo. |
| -p, --preset | Cadena | Proporciona el identificador de la imagen de configuración de placa preestablecida que se va a aplicar. Escriba el identificador de un paquete preestablecido o proporcione una ruta de acceso para el archivo de configuración de la placa mediante el --board-config-file parámetro para una imagen de configuración de placa personalizada. El identificador es un valor de enumeración y actualmente se fija en el 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 |
|---|---|
| --debug | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca --debug activada al enviar un informe de errores. |
| -h, --help | Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Muestra solo errores, supresión de advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera table. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere. |
| --query | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos. |
| --verbose | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use --debug para los registros de depuración completos. |
Nota:
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para 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 imágenes.
Parámetros obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -f, --image-package | Cadena | Especifica la ruta de acceso al paquete de imágenes. 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 |
|---|---|
| --debug | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca --debug activada al enviar un informe de errores. |
| -h, --help | Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Muestra solo errores, supresión de advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera table. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere. |
| --query | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos. |
| --verbose | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use --debug para los registros de depuración completos. |
Nota:
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para 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