Delen via

image-package

  • Artikel

Beheert Azure Sphere-installatiekopieën op schijf.

Bewerking Beschrijving
pack-application Hiermee maakt u een installatiekopieënpakket.
pack-board-config Hiermee maakt u een installatiekopieënpakket voor de boardconfiguratie.
Toon Geeft details weer over een installatiekopieënpakket.

pack-application

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

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 EntryPoint is 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 behulp van Visual Studio Code of Visual Studio.

  • Tijdens het buildproces wordt een approot-map<met app-naam> gemaakt. 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 runtimeversie van de toepassing opgegeven in de --target-api-set parameter.

Vereiste parameters

Parameter Type Beschrijving
--Bestemming Pad naar installatiekopieënpakket 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 bestand app_manifest.json voor de toepassing moet zich in deze map bevinden.

Optionele parameters

Parameter Type Beschrijving
-a, --application-manifest Tekenreeks Hiermee geeft u het pad naar het manifestbestand van de toepassing. Dit kan een JSON-bestand zijn of een map die app_manifest.json bevat. U kunt een relatief of absoluut pad opgeven.
--hardware-definities Tekenreeks Hiermee geeft u een optionele door spaties gescheiden lijst met paden naar de mappen met JSON-bestanden (Hardware Definition). De waarden uit de bestanden worden gebruikt om namen van randapparatuur in app_manifest.json toe te wijzen aan onderliggende waarden. U kunt een relatief of absoluut pad opgeven. Zie hardwaredefinitie voor meer informatie.
--target-api-set Tekenreeks Hiermee geeft u de naam van de doel-API-set die wordt gebruikt tijdens de compilatie. Vereist voor apps op hoog niveau als deze niet zijn opgegeven in het app-manifest. Niet vereist voor RTApps.
--target-definition-bestandsnaam Tekenreeks Hiermee geeft u de naam van het hardwaredoeldefinitiebestand dat wordt gebruikt om randapparatuurnamen toe te wijzen 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 te markeren als uitvoerbaar in het installatiekopieënpakket. Het EntryPoint dat wordt vermeld in de app_manifest-bestanden is altijd gemarkeerd als uitvoerbaar, dus de vlag -x is alleen vereist als er andere uitvoerbare bestanden aanwezig zijn.
Standaard zijn bestanden niet uitvoerbaar wanneer ze in een afbeelding worden 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 Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

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

Voorbeeld

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 installatiekopieënpakket voor de boardconfiguratie. U kunt een vooraf ingestelde installatiekopieën voor bordconfiguratie gebruiken of een aangepaste configuratie-installatiekopieën opgeven.

Vereiste parameters

Parameter Type Beschrijving
--Bestemming Tekenreeks Hiermee geeft u een pad naar de uitvoer bestandsnaam voor het resulterende installatiekopieënpakket.

Optionele parameters

Parameter Type Beschrijving
--board-config-file Pad Hiermee wordt het pad naar de configuratie-installatiekopieën van het bord geïdentificeerd. Als dit is opgenomen, --preset mag niet worden gebruikt; de twee parameters sluiten elkaar uit.
-n, --name Tekenreeks Hiermee stelt u de naam van het installatiekopieënpakket in de metagegevens van het gemaakte bestand in. Als dit niet wordt opgegeven, wordt er een nieuwe naam gegenereerd op basis van de opgegeven bordconfiguratie, waarbij een deel van de onderdeel-id voor uniekheid wordt opgenomen.
-p, --preset Tekenreeks Geeft de id op van de vooraf ingestelde kaartconfiguratie-installatiekopieën die moeten worden toegepast. Voer de id van een vooraf ingesteld pakket in of geef een pad op voor het configuratiebestand van het bord met behulp van de --board-config-file parameter voor een aangepaste installatiekopieën voor bordconfiguratie. De id is een opsommingswaarde en is momenteel vastgesteld op de enkele waarde lan-enc28j60-isu0-int5.
Globale parameters

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

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

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

Voorbeeld

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

Toon

Geeft informatie weer over een afbeeldingspakket.

Vereiste parameters

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

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

Parameter Beschrijving
--Debug Vergroot de uitgebreidheid van logboekregistratie om alle foutopsporingslogboeken weer te geven. Als u een fout vindt, geeft u de uitvoer op die is gegenereerd met de --debug vlag aan bij het indienen van een foutenrapport.
-h, --help Cli-referentie-informatie over opdrachten en hun argumenten en lijsten met beschikbare subgroepen en opdrachten.
--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 voert de CLI uit table. Zie Uitvoerindeling voor Azure Sphere CLI-opdrachten voor meer informatie over de beschikbare uitvoerindelingen.
--Query Gebruikt de JMESPath-querytaal om de uitvoer te filteren die wordt geretourneerd door Azure Sphere Security Services. Zie de JMESPath-zelfstudie en Query uitvoeren op Azure CLI-opdrachtuitvoer voor meer informatie en voorbeelden.
--Uitgebreide Hiermee wordt informatie afgedrukt over resources die tijdens een bewerking in Azure Sphere zijn gemaakt en andere nuttige informatie. Gebruik --debug voor volledige foutopsporingslogboeken.

Opmerking

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

Voorbeeld

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