pacote de imagem
Importante
Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).
Gerencia imagens do Azure Sphere em disco.
| Operação | Descrição |
|---|---|
| pack-application | Cria um pacote de imagens. |
| pack-board-config | Cria um pacote de imagens de configuração do board. |
| show | Exibe detalhes sobre um pacote de imagens. |
pack-application
Cria um aplicativo executável de uma imagem de compilada e vinculada e um arquivo app_manifest.json.
Aplicativos com capacidade em tempo real (RTApps) são criados como arquivos ELF ou AXF e não como binários brutos. Antes de empacotar um RTApp, edite o arquivo de manifesto do aplicativo, de modo que ApplicationType é definido como "RealTimeCapable", e EntryPoint é definido como o nome do arquivo ELF ou AXF, que deve ser na raiz das diretório de aplicativo.
Dica
Esse comando é executado quando você cria um aplicativo de alto nível ou um aplicativo com capacidade em tempo real usando o Visual Studio Code ou o Visual Studio.
- O processo de build cria um diretório approot<app-name> , que é o diretório de entrada especificado no
--package-directoryparâmetro. - O arquivo de manifesto do aplicativo é fornecido no
--application-manifestparâmetro. - Para aplicativos de alto nível, uma versão de tempo de execução do aplicativo é fornecida no
--target-api-setparâmetro.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --destino | Caminho para o pacote de imagem | Especifica um caminho e um nome de arquivo para o pacote de imagem de saída. |
| --diretório-de-pacote | Caminho para approot_folder | Identifica o diretório de entrada, que é usado como a raiz do sistema para o arquivo de imagem do Azure Sphere. O arquivo app_manifest.json para o aplicativo deve estar neste diretório. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| -a, --manifesto-do-aplicativo | String | Especifica o caminho para o arquivo de manifesto do aplicativo. Pode ser um arquivo JSON ou um diretório que contém app_manifest.json. Você pode fornecer um caminho relativo ou absoluto. |
| --definições de hardware | String | Especifica uma lista opcional separada por espaços de caminhos para os diretórios que contêm arquivos JSON (definição de hardware). Os valores dos arquivos são usados para mapear nomes periféricos em app_manifest.json para valores subjacentes. Você pode fornecer um caminho relativo ou absoluto. Ver definição de hardware para obter mais informações. |
| --target-api-set | String | Especifica o nome do conjunto de APIs de destino usado durante a compilação. Necessário para aplicativos de alto nível se não for especificado no manifesto do aplicativo. Não é necessário para RTApps. |
| --target-definition-nome do arquivo | String | Especifica o nome do arquivo de definição de destino de hardware usado para mapear nomes de periféricos no app_manifest.json. Ele deve ser fornecido se o aplicativo usar definições de hardware. |
| -x, --executáveis | executável1,executável2 ... | Especifica os caminhos para um ou mais arquivos a serem marcados como executáveis no pacote de imagens. O EntryPoint listado nos arquivos app_manifest é sempre marcado como executável, portanto o sinalizador -x só será necessário se houver outros executáveis. Por padrão, os arquivos não são executáveis quando empacotados em uma imagem. Os subcaminhos são relativos ao caminho dos executáveis. Os caminhos podem usar a sintaxe de nome de arquivo do Windows (barras invertidas) ou a sintaxe de nome de arquivo do Linux (barras); espaços, vírgulas e ponto e vírgula não são permitidos. Você pode especificar -x para cada arquivo executável ou usá-lo apenas uma vez e fornecer vários caminhos separados por vírgulas sem espaços. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --debug | Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs. |
| -h, --help | Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis. |
| --only-show-errors | Mostra apenas erros, suprimindo avisos. |
| -o, --output | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --query | Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos. |
| --verbose | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos. |
Observação
Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.
Exemplo
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
Cria um pacote de imagens de configuração do board. Você pode usar uma imagem de configuração de board predefinida ou fornecer uma imagem de configuração personalizada.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --destino | String | Especifica um caminho para o nome do arquivo de saída para o pacote de imagens resultante. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --board-config-arquivo | Caminho | Identifica o caminho até a imagem de configuração do board. Se isso for incluído, --preset não deve ser usado; os dois parâmetros são mutuamente exclusivos. |
| -n, --name | String | Define o nome do pacote de imagens nos metadados do arquivo criado. Se não for fornecido, um novo nome será gerado com base na configuração de board fornecida, incorporando parte da ID do componente para exclusividade. |
| -p, --preset | String | Fornece a ID da imagem de configuração do quadro predefinido a ser aplicado. Insira o ID de um pacote predefinido ou forneça um caminho para o arquivo de configuração da placa usando o --board-config-file parâmetro para uma imagem de configuração de placa personalizada. A ID é um valor de enumeração e atualmente está fixada no valor lan-enc28j60-isu0-int5único. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --debug | Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs. |
| -h, --help | Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis. |
| --only-show-errors | Mostra apenas erros, suprimindo avisos. |
| -o, --output | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --query | Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos. |
| --verbose | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos. |
Observação
Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.
Exemplo
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
show
Exibe informações sobre um pacote de imagens.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| -f, --pacote-de-imagem | String | Especifica o caminho para o pacote de imagem. Você pode fornecer um caminho relativo ou absoluto. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --debug | Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs. |
| -h, --help | Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis. |
| --only-show-errors | Mostra apenas erros, suprimindo avisos. |
| -o, --output | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --query | Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos. |
| --verbose | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos. |
Observação
Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.
Exemplo
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