image-package

Ważne

Jest to dokumentacja usługi Azure Sphere (starsza wersja). Usługa Azure Sphere (starsza wersja) zostanie wycofana 27 września 2027 r., a użytkownicy muszą przeprowadzić migrację do usługi Azure Sphere (zintegrowanej) do tej pory. Użyj selektora wersji znajdującego się powyżej spisu treści, aby wyświetlić dokumentację usługi Azure Sphere (zintegrowaną).

Zarządza obrazami usługi Azure Sphere na dysku.

Działanie	opis
pack-application	Tworzy pakiet obrazów.
pack-board-config	Tworzy pakiet obrazu konfiguracji tablicy.
pokazać	Wyświetla szczegółowe informacje o pakiecie obrazów.

pack-application

Tworzy aplikację wykonywalną na podstawie skompilowanego i połączonego obrazu oraz pliku app_manifest.json.

Aplikacje obsługujące w czasie rzeczywistym (RTApps) są tworzone jako pliki ELF lub AXF, a nie jako nieprzetworzone pliki binarne. Przed opakowaniem aplikacji RTApp zmodyfikuj plik manifestu aplikacji, tak aby parametr ApplicationType został ustawiony na wartość "RealTimeCapable", a program EntryPoint ma ustawioną nazwę pliku ELF lub AXF, który musi znajdować się w katalogu głównym katalogu aplikacji.

Napiwek

To polecenie jest uruchamiane podczas tworzenia aplikacji wysokiego poziomu lub aplikacji obsługującej w czasie rzeczywistym przy użyciu programu Visual Studio Code lub Visual Studio.

• Proces kompilacji tworzy katalog approot<app-name> , który jest katalogiem wejściowym określonym w parametrze --package-directory .
• Plik manifestu aplikacji jest udostępniany w parametrze --application-manifest .
• W przypadku aplikacji wysokiego poziomu wersja środowiska uruchomieniowego aplikacji jest udostępniana w parametrze --target-api-set .

Parametry wymagane

Parametr	Type	opis
--cel	Ścieżka	Określa ścieżkę i nazwę pliku dla pakietu obrazu wyjściowego.
--package-directory	Ścieżka	Identyfikuje katalog wejściowy, który jest używany jako katalog główny systemu dla pliku obrazu usługi Azure Sphere. Plik app_manifest.json aplikacji musi znajdować się w tym katalogu.

Parametry opcjonalne

Parametr	Type	opis
-a, --application-manifest	String	Określa ścieżkę do pliku manifestu aplikacji. Może to być plik JSON lub katalog zawierający app_manifest.json. Możesz podać ścieżkę względną lub bezwzględną.
--hardware-definitions	String	Określa opcjonalną listę ścieżek rozdzielanych spacjami do katalogów zawierających pliki definicji sprzętu (JSON). Wartości z plików są używane do mapowania nazw peryferyjnych w app_manifest.json na wartości bazowe. Możesz podać ścieżkę względną lub bezwzględną. Aby uzyskać więcej informacji, zobacz definicję sprzętu.
--target-api-set	String	Określa nazwę docelowego zestawu interfejsu API używanego podczas kompilacji. Wymagana dla aplikacji wysokiego poziomu, jeśli nie zostanie określona w manifeście aplikacji. Aplikacja RTApps nie jest wymagana.
--target-definition-filename	String	Określa nazwę pliku definicji docelowej sprzętu używanego do mapowania nazw peryferyjnych w app_manifest.json. Należy go podać, jeśli aplikacja używa definicji sprzętu.
-x, --wykonywalne	wykonywalny1,wykonywalny2 ...	Określa ścieżki do co najmniej jednego pliku, które mają być oznaczone jako plik wykonywalny w pakiecie obrazów. Program EntryPoint wymieniony w plikach app_manifest jest zawsze oznaczony jako plik wykonywalny, dlatego flaga -x jest wymagana tylko wtedy, gdy istnieją inne pliki wykonywalne. Domyślnie pliki nie są pliki wykonywalne, gdy są pakowane do obrazu. Ścieżki podrzędne są względne względem ścieżki plików wykonywalnych. Ścieżki mogą używać składni nazwy pliku systemu Windows (ukośników odwrotnych) lub składni nazwy pliku systemu Linux (ukośniki do przodu); spacje, przecinki i średniki są niedozwolone. Można określić -x dla każdego pliku wykonywalnego lub użyć go tylko raz i podać wiele ścieżek rozdzielonych przecinkami bez interweniowania spacji.

Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr	opis
--debugować	Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help	Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors	Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output	Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie	Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy	Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Przykład

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

pack-board-config

Tworzy pakiet obrazu konfiguracji tablicy. Możesz użyć wstępnie ustawionego obrazu konfiguracji tablicy lub udostępnić niestandardowy obraz konfiguracji.

Parametry wymagane

Parametr	Type	opis
--cel	String	Określa ścieżkę do nazwy pliku wyjściowego dla wynikowego pakietu obrazów.

Parametry opcjonalne

Parametr	Type	opis
--board-config-file	Ścieżka	Identyfikuje ścieżkę do obrazu konfiguracji tablicy. Jeśli jest to uwzględnione, nie może być używane; --preset dwa parametry wzajemnie się wykluczają.
-n, --name	String	Ustawia nazwę pakietu obrazu w metadanych utworzonego pliku. Jeśli nie zostanie podana, zostanie wygenerowana nowa nazwa na podstawie podanej konfiguracji tablicy zawierającej część identyfikatora składnika w celu uzyskania unikatowości.
-p, --preset	String	Zawiera identyfikator obrazu konfiguracji tablicy wstępnie ustawionej do zastosowania. Wprowadź identyfikator wstępnie ustawionego pakietu lub podaj ścieżkę do pliku konfiguracji tablicy przy użyciu parametru --board-config-file niestandardowego obrazu konfiguracji tablicy. Identyfikator jest wartością wyliczenia i jest obecnie stały dla pojedynczej wartości lan-enc28j60-isu0-int5.

Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr	opis
--debugować	Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help	Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors	Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output	Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie	Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy	Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Przykład

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

pokaż

Wyświetla informacje o pakiecie obrazów.

Parametry wymagane

Parametr	Type	opis
-f, --image-package	String	Określa ścieżkę do pakietu obrazów. Możesz podać ścieżkę względną lub bezwzględną.

Parametry globalne

Następujące parametry globalne są dostępne dla interfejsu wiersza polecenia usługi Azure Sphere:

Parametr	opis
--debugować	Zwiększa szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz usterkę, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help	Drukuje informacje referencyjne dotyczące poleceń oraz ich argumentów i list dostępnych podgrup i poleceń.
--only-show-errors	Pokazuje tylko błędy, pomijając ostrzeżenia.
-o, --output	Zmienia format danych wyjściowych. Dostępne formaty danych wyjściowych to json, jsonc (kolorowy kod JSON), tsv (wartości rozdzielane tabulatorami), tabela (tabele ASCII czytelne dla człowieka) i yaml. Domyślnie interfejs wiersza polecenia zwraca format table. Aby dowiedzieć się więcej o dostępnych formatach danych wyjściowych, zobacz Format danych wyjściowych dla poleceń interfejsu wiersza polecenia usługi Azure Sphere.
--zapytanie	Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych z usług zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek JMESPath i Wykonywanie zapytań o dane wyjściowe polecenia interfejsu wiersza polecenia platformy Azure.
--gadatliwy	Drukuje informacje o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Użyj parametru --debug, aby uzyskać pełne dzienniki debugowania.

Przykład

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