image-package
Gerencia imagens do Azure Sphere em disco.
| Operação | Descrição |
|---|---|
| pack-application | Cria um pacote de imagem. |
| pack-board-config | Cria um pacote de imagens de configuração de quadro. |
| programa | Exibe detalhes sobre um pacote de imagens. |
pack-application
Cria um aplicativo executável a partir de uma imagem compilada e vinculada e de um arquivo app_manifest.json.
Os RTApps (aplicativos com capacidade em tempo real) 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 para que o ApplicationType seja definido como "RealTimeCapable" e o EntryPoint seja definido como o nome do arquivo ELF ou AXF, que deve estar na raiz do diretório do aplicativo.
Ponta
Esse comando é executado quando você cria um aplicativo de alto nível ou um aplicativo capaz em tempo real usando Visual Studio Code ou Visual Studio.
- O processo de build cria um diretório app-name> approot<, 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 runtime do aplicativo é fornecida no
--target-api-setparâmetro.
Parâmetros necessários
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --Destino | Caminho para o pacote de imagens | Especifica um caminho e um nome de arquivo para o pacote de imagem de saída. |
| --package-directory | 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 do aplicativo deve estar neste diretório. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| -a, --application-manifest | String | Especifica o caminho para o arquivo de manifesto do aplicativo. Isso 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ço 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. Consulte a definição de hardware para obter mais informações. |
| --target-api-set | String | Especifica o nome do conjunto de API 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-filename | String | Especifica o nome do arquivo de definição de destino de hardware usado para mapear nomes periféricos em app_manifest.json. Ele deve ser fornecido se o aplicativo usar definições de hardware. |
| -x, --executables | executável1, executável2 ... | Especifica os caminhos para um ou mais arquivos para marcar como executáveis no pacote de imagem. O EntryPoint listado nos arquivos app_manifest sempre é marcado como executável, portanto, o sinalizador -x é necessário somente se outros executáveis estiverem presentes. Por padrão, os arquivos não são executáveis quando empacotados em uma imagem. Os sub-caminhos são relativos ao caminho dos executáveis. Os caminhos podem usar sintaxe de nome de arquivo do Windows (backslashes) ou sintaxe de nome de arquivo linux (barras para a frente); 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 intervir espaços. |
Parâmetros globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira Formato de saída para comandos da CLI do Azure Sphere. |
| --Consulta | 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 de comando da 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. |
Nota
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 de quadro. Você pode usar uma imagem de configuração de placa predefinida ou fornecer uma imagem de configuração personalizada.
Parâmetros necessários
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --Destino | String | Especifica um caminho para o nome do arquivo de saída para o pacote de imagem resultante. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --board-config-file | Caminho | Identifica o caminho para a imagem de configuração do quadro. Se isso estiver incluído, --preset não deverá ser usado; os dois parâmetros serão mutuamente exclusivos. |
| -n, --name | String | Define o nome do pacote de imagem nos metadados do arquivo criado. Se não for fornecido, um novo nome será gerado com base na configuração do quadro fornecido, incorporando parte da ID do componente para exclusividade. |
| -p, --preset | String | Fornece a ID da imagem de configuração de placa predefinida a ser aplicada. Insira a ID de um pacote predefinido ou forneça um caminho para o arquivo de configuração do quadro 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 é 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 |
|---|---|
| --Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira Formato de saída para comandos da CLI do Azure Sphere. |
| --Consulta | 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 de comando da 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. |
Nota
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
programa
Exibe informações sobre um pacote de imagens.
Parâmetros necessários
| Parâmetro | Tipo | Descrição |
|---|---|---|
| -f, --image-package | 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 |
|---|---|
| --Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira Formato de saída para comandos da CLI do Azure Sphere. |
| --Consulta | 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 de comando da 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. |
Nota
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