Delen via

image-package

  • Artikel

Belangrijk

Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.

Beheert Azure Sphere-installatiekopieën op schijf.

Operation Omschrijving
pack-application Hiermee maakt u een installatiekopieënpakket.
pack-board-config Hiermee maakt u een installatiekopiepakket voor de boardconfiguratie.
tonen Geeft details weer over een afbeeldingspakket.

pack-application

Hiermee maakt u een uitvoerbare toepassing op basis van een gecompileerde en gekoppelde installatiekopieën en een app_manifest.json-bestand.

Realtime compatibele toepassingen (RTApps) worden gebouwd als ELF- of AXF-bestanden en niet als onbewerkte binaire bestanden. Voordat u een RTApp inpakt, bewerkt u het manifestbestand van de toepassing, zodat ApplicationType is ingesteld op RealTimeCapable en wordt EntryPoint ingesteld op de naam van het ELF- of AXF-bestand, dat zich in de hoofdmap van de toepassingsmap moet bevinden.

Tip

Deze opdracht wordt uitgevoerd wanneer u een toepassing op hoog niveau of een realtime toepassing bouwt met visual Studio Code of Visual Studio.

  • Het buildproces maakt een app-naammap<> in de approot. Dit is de invoermap die is opgegeven in de --package-directory parameter.
  • Het manifestbestand van de toepassing wordt opgegeven in de --application-manifest parameter.
  • Voor toepassingen op hoog niveau wordt een versie van de toepassingsruntime opgegeven in de --target-api-set parameter.

Vereiste parameters

Parameter Type Description
--bestemming Pad naar afbeeldingspakket Hiermee geeft u een pad en bestandsnaam voor het uitvoerinstallatiekopieënpakket.
--package-directory Pad naar approot_folder Identificeert de invoermap, die wordt gebruikt als de systeemhoofdmap voor het Azure Sphere-installatiekopieënbestand. Het app_manifest.json-bestand voor de toepassing moet zich in deze map bevinden.

Optionele parameters

Parameter Type Description
-a, --application-manifest String Hiermee geeft u het pad naar het manifestbestand van de toepassing. Dit kan een JSON-bestand of een map zijn die app_manifest.json bevat. U kunt een relatief of absoluut pad opgeven.
--hardware-definities String Hiermee geeft u een optionele door spaties gescheiden lijst met paden naar de mappen met JSON-bestanden (Hardware Definition) op. De waarden uit de bestanden worden gebruikt om randapparatuurnamen in app_manifest.json toe te wijzen aan onderliggende waarden. U kunt een relatief of absoluut pad opgeven. Zie de hardwaredefinitie voor meer informatie.
--target-api-set String Hiermee geeft u de naam op van de doel-API-set die tijdens de compilatie wordt gebruikt. Vereist voor apps op hoog niveau als deze niet zijn opgegeven in het app-manifest. Niet vereist voor RTApps.
--target-definition-bestandsnaam String Hiermee geeft u de naam van het hardwaredoeldefinitiebestand dat wordt gebruikt voor het toewijzen van randapparatuurnamen in app_manifest.json. Deze moet worden opgegeven als de toepassing hardwaredefinities gebruikt.
-x, --uitvoerbare bestanden uitvoerbaar1,uitvoerbaar2 ... Hiermee geeft u de paden naar een of meer bestanden die moeten worden gemarkeerd als uitvoerbaar in het installatiekopieënpakket. Het EntryPoint in de app_manifest bestanden wordt altijd gemarkeerd als uitvoerbaar, dus de vlag -x is alleen vereist als andere uitvoerbare bestanden aanwezig zijn.
Bestanden zijn standaard niet uitvoerbaar wanneer ze in een installatiekopieën zijn verpakt. De subpaden zijn relatief ten opzichte van het pad van de uitvoerbare bestanden. De paden kunnen de syntaxis van de Windows-bestandsnaam (backslashes) of de syntaxis van de Linux-bestandsnaam (slashes) gebruiken; spaties, komma's en puntkomma's zijn niet toegestaan. U kunt -x opgeven voor elk uitvoerbaar bestand of slechts één keer gebruiken en meerdere paden opgeven, gescheiden door komma's zonder tussenliggende spaties.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Description
--debug Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd.
-h, --help Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--vraag Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden.
--verbose Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing.

Notitie

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.

Opmerking

azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage

pack-board-config

Hiermee maakt u een installatiekopiepakket voor de boardconfiguratie. U kunt een vooraf ingestelde installatiekopie van een bordconfiguratie gebruiken of een aangepaste configuratie-installatiekopie opgeven.

Vereiste parameters

Parameter Type Description
--bestemming String Hiermee geeft u een pad naar de uitvoerbestandsnaam voor het resulterende installatiekopieënpakket.

Optionele parameters

Parameter Type Description
--board-config-file Pad Identificeert het pad naar de installatiekopie van de bordconfiguratie. Als dit is opgenomen, --preset mag niet worden gebruikt; de twee parameters sluiten elkaar wederzijds uit.
-n, --name String Hiermee stelt u de naam van het installatiekopieënpakket in de metagegevens van het gemaakte bestand in. Als deze niet wordt opgegeven, wordt er een nieuwe naam gegenereerd op basis van de opgegeven bordconfiguratie, waarin een deel van de onderdeel-id voor uniekheid wordt opgenomen.
-p, --preset String Biedt de id van de vooraf ingestelde installatiekopie van de bordconfiguratie die moet worden toegepast. Voer de id van een vooraf ingestelde pakket in of geef een pad op voor het bordconfiguratiebestand met behulp van de --board-config-file parameter voor een aangepaste installatiekopie van een bordconfiguratie. De id is een opsommingswaarde en wordt momenteel vastgezet op de ene waarde lan-enc28j60-isu0-int5.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Description
--debug Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd.
-h, --help Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--vraag Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden.
--verbose Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing.

Notitie

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.

Opmerking

azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage

weergeven

Geeft informatie weer over een afbeeldingspakket.

Vereiste parameters

Parameter Type Description
-f, --image-package String Hiermee geeft u het pad naar het installatiekopieënpakket. U kunt een relatief of absoluut pad opgeven.
Globale parameters

De volgende globale parameters zijn beschikbaar voor de Azure Sphere CLI:

Parameter Description
--debug Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven. Als u een fout vindt, kunt u een foutenrapport indienen op basis van de uitvoer die met de vlag --debug wordt gegeneerd.
-h, --help Cli-referentiegegevens over opdrachten en de bijbehorende argumenten en lijsten met beschikbare subgroepen en opdrachten afdrukken.
--only-show-errors Geeft alleen fouten weer, waarbij waarschuwingen worden onderdrukt.
-o, --output Hiermee wijzigt u de uitvoerindeling. De beschikbare uitvoerindelingen zijn json, jsonc (gekleurde JSON), tsv (door tabs gescheiden waarden), tabel (door mensen leesbare ASCII-tabellen) en yaml. Standaard is table de uitvoer van de CLI. Zie De uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--vraag Hiermee wordt de JMESPath-querytaal gebruikt om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de zelfstudie JMESPath en Voer uitvoer van Azure CLI-opdrachten uit voor meer informatie en voorbeelden.
--verbose Hiermee wordt informatie afgedrukt over resources die zijn gemaakt in Azure Sphere tijdens een bewerking en andere nuttige informatie. Gebruik --debug voor de volledige logboeken voor foutopsporing.

Notitie

Als u de klassieke Cli van Azure Sphere gebruikt, raadpleegt u globale parameters voor meer informatie over beschikbare opties.

Opmerking

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