balíček image
Důležité
Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.
Spravuje image Azure Sphere na disku.
| Operation | Popis |
|---|---|
| pack-application | Vytvoří balíček image. |
| pack-board-config | Vytvoří balíček image konfigurace panelu. |
| ukázat | Zobrazí podrobnosti o balíčku image. |
pack-application
Vytvoří spustitelné aplikace z kompilované a propojené image a souboru app_manifest.json.
Aplikace podporující v reálném čase (RTApps) jsou vytvořené jako soubory ELF nebo AXF a ne jako nezpracované binární soubory. Před zabalením aplikace upravte soubor manifestu aplikace tak, aby applicationType byl nastaven na "RealTimeCapable" a EntryPoint je nastaven na název souboru ELF nebo AXF, který musí být v kořenovém adresáři aplikace.
Tip
Tento příkaz se spustí při vytváření aplikace vysoké úrovně nebo aplikace podporující v reálném čase pomocí editoru Visual Studio Code nebo sady Visual Studio.
- Proces sestavení vytvoří adresář názvu aplikace approot<, což je vstupní adresář zadaný v parametru>.
--package-directory - Soubor manifestu aplikace je k dispozici v parametru
--application-manifest. - Pro aplikace vysoké úrovně je v parametru
--target-api-setk dispozici verze modulu runtime aplikace.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| --cíl | Cesta | Určuje cestu a název souboru výstupního balíčku image. |
| --package-directory | Cesta | Identifikuje vstupní adresář, který se používá jako kořen systému pro soubor bitové kopie Azure Sphere. Soubor app_manifest.json aplikace musí být v tomto adresáři. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -a, --application-manifest | String | Určuje cestu k souboru manifestu aplikace. Může se jednat o soubor JSON nebo adresář, který obsahuje app_manifest.json. Můžete zadat relativní nebo absolutní cestu. |
| --hardware-definitions | String | Určuje volitelný seznam cest oddělených mezerami k adresářům obsahujícím soubory JSON (Hardware Definition). Hodnoty ze souborů se používají k mapování názvů periferních zařízení v app_manifest.json na podkladové hodnoty. Můžete zadat relativní nebo absolutní cestu. Další informace najdete v definici hardwaru. |
| --target-api-set | String | Určuje název cílové sady rozhraní API použitou při kompilaci. Vyžaduje se pro aplikace vysoké úrovně, pokud nejsou uvedené v manifestu aplikace. Pro RTApps se nevyžaduje. |
| --target-definition-filename | String | Určuje název definičního souboru cílového hardwaru, který se používá k mapování názvů periferních zařízení v app_manifest.json. Musí se zadat, pokud aplikace používá definice hardwaru. |
| -x, --spustitelné soubory | spustitelný soubor1,spustitelný2 ... | Určuje cesty k jednomu nebo více souborům, které se mají označit jako spustitelné v balíčku image. Vstupní bod uvedený v souborech app_manifest je vždy označen jako spustitelný, takže příznak -x je vyžadován pouze v případě, že jsou přítomny jiné spustitelné soubory. Ve výchozím nastavení nejsou soubory při zabalení do image spustitelné. Dílčí cesty jsou relativní vzhledem k cestě spustitelných souborů. Cesty můžou používat syntaxi názvu souboru Systému Windows (zpětné lomítka) nebo syntaxi názvu souboru Linuxu (lomítka); mezery, čárky a středníky nejsou povoleny. Pro každý spustitelný soubor můžete zadat -x, nebo ho použít pouze jednou a zadat více cest oddělených čárkami bez mezer. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Příklad
azsphere image-package pack-application --package-directory C:\AppSamples\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\approotHelloWorld_HighLevelApp --destination myimage.imagepackage
pack-board-config
Vytvoří balíček image konfigurace panelu. Můžete použít buď konfigurační image přednastavené desky, nebo zadat vlastní konfigurační image.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| --cíl | String | Určuje cestu k výstupnímu názvu souboru výsledného balíčku image. |
Volitelné parametry
| Parametr | Typ | Popis |
|---|---|---|
| --board-config-file | Cesta | Identifikuje cestu k konfigurační imagi panelu. Pokud je tato hodnota zahrnutá, --preset nesmí se použít; tyto dva parametry se vzájemně vylučují. |
| -n, --name | String | Nastaví název balíčku image v metadatech vytvořeného souboru. Pokud ho nezadáte, vygeneruje se nový název na základě zadané konfigurace panelu, který obsahuje část ID součásti pro jedinečnost. |
| -p, --přednastavení | String | Poskytuje ID konfigurační image přednastavené desky, která se má použít. Zadejte BUĎ ID přednastaveného balíčku, nebo zadejte cestu konfiguračního souboru panelu pomocí --board-config-file parametru pro vlastní konfigurační image panelu. ID je hodnota výčtu a je nyní pevně nastavena na jednu hodnotu lan-enc28j60-isu0-int5. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Příklad
azsphere image-package pack-board-config --preset lan-enc28j60-isu0-int5 --destination board2.imagepackage
zobrazit
Zobrazí informace o balíčku image.
Povinné parametry
| Parametr | Typ | Popis |
|---|---|---|
| -f, --image-package | String | Určuje cestu k balíčku image. Můžete zadat relativní nebo absolutní cestu. |
Globální parametry
Pro Rozhraní příkazového řádku Azure Sphere jsou k dispozici následující globální parametry:
| Parametr | Popis |
|---|---|
| --ladicí | Zvyšuje úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění. Pokud narazíte na chybu, při odesílání zprávy o chybě zadejte výstup vygenerovaný pomocí příznaku --debug. |
| -h, --help | Vytiskne referenční informace rozhraní příkazového řádku o příkazech a jejich argumentech a seznamech dostupných podskupin a příkazů. |
| --only-show-errors | Zobrazuje pouze chyby a potlačuje upozornění. |
| -o, --output | Změní formát výstupu. Dostupné výstupní formáty jsou json, jsonc (barevné JSON), tsv (hodnoty oddělené tabulátory), tabulka (tabulky ASCII čitelné pro člověka) a yaml. Ve výchozím nastavení je výstup rozhraní příkazového řádku ve formátu table. Další informace o dostupných formátech výstupu najdete v tématu Formát výstupu pro příkazy Rozhraní příkazového řádku Azure Sphere. |
| --dotaz | Použije dotazovací jazyk JMESPath k filtrování výstupu vráceného ze služeb zabezpečení Azure Sphere. Další informace a příklady najdete v kurzu JMESPath a dotazování výstupu příkazu Azure CLI. |
| --užvaněný | Vytiskne informace o prostředcích vytvořených v Azure Sphere během operace a dalších užitečných informací. Pokud chcete zobrazit úplné protokoly ladění, použijte parametr --debug. |
Příklad
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