pacote de imagens
Importante
Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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 no disco.
| Operation | Description |
|---|---|
| embalagem-aplicação | Cria um pacote de imagens. |
| pack-board-config | Cria um pacote de imagem de configuração da placa. |
| programa | Exibe detalhes sobre um pacote de imagens. |
embalagem-aplicação
Cria um aplicativo executável a partir de uma imagem compilada e vinculada e um arquivo app_manifest.json.
Aplicativos capazes de tempo real (RTApps) são construídos 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 ApplicationType seja definido como "RealTimeCapable" e EntryPoint seja definido como o nome do arquivo ELF ou AXF, que deve estar na raiz do diretório do aplicativo.
Gorjeta
Este comando é executado quando você cria um aplicativo de alto nível ou um aplicativo capaz de tempo real usando Visual Studio Code ou Visual Studio.
- O processo de compilação cria um diretório approot<app-name> , que é o
--package-directorydiretório de entrada especificado no parâmetro. - O arquivo de manifesto do
--application-manifestaplicativo é fornecido no parâmetro. - Para aplicativos de alto nível, uma versão de tempo de execução do
--target-api-setaplicativo é fornecida no parâmetro.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| --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-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 | Description |
|---|---|---|
| -a, --manifesto de aplicação | String | Especifica o caminho para o arquivo de manifesto do aplicativo. Pode ser um arquivo JSON ou um diretório que contenha 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 de definição de hardware (JSON). 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 APIs de destino usado durante a compilação. Necessário para aplicativos de alto nível, se não 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 no app_manifest.json. Ele deve ser fornecido se o aplicativo usa 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 é 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 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 para 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 espaços intervenientes. |
Parâmetros globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte 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 do comando Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos 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 imagem de configuração da placa. Você pode usar uma imagem de configuração de placa predefinida ou fornecer uma imagem de configuração personalizada.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| --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 | Description |
|---|---|---|
| --board-config-file | Caminho | Identifica o caminho para a imagem de configuração da placa. Se isso estiver incluído, não deve ser usado, --preset os dois parâmetros são mutuamente exclusivos. |
| -n, --nome | 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 da placa fornecida, incorporando parte do ID do componente para exclusividade. |
| -p, --predefinido | String | Fornece o ID da imagem de configuração da placa predefinida a ser aplicada. 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 personalizada da placa. O ID é um valor de enumeração e está atualmente fixado para o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte 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 do comando Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos 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
mostrar
Exibe informações sobre um pacote de imagens.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -f, --pacote de imagem | String | Especifica o caminho para o pacote de imagens. 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte 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 do comando Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos 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