pakiet obrazów

Zarządza obrazami w usłudze Azure Sphere na dysku.

Operacji	Opis
aplikacja pakietu	Tworzy pakiet obrazów.
pack-board-config	Tworzy pakiet obrazów konfiguracji tablicy.
Pokaż	Wyświetla szczegółowe informacje o pakiecie obrazów.

aplikacja pakietu

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

Aplikacje obsługują czas rzeczywisty (RTApps) są tworzone jako pliki ELF lub AXF, a nie jako pliki binarne na surowo. Przed zapakowaniem pliku manifestu aplikacji edytuj plik manifestu aplikacji tak, aby typ aplikacji był ustawiony na wartość "RealTimeCapable", a w programie EntryPoint jest ustawiona nazwa pliku ELF lub AXF, który musi znajdować się w katalogu głównym katalogu aplikacji.

Wskazówka

To polecenie jest uruchamiane podczas tworzenia aplikacji wysokiego poziomu lub aplikacji z obsługą czasu rzeczywistego przy użyciu programu Visual Studio Code lub Visual Studio.

• Proces tworzenia tworzy przybliżony<katalog nazwy> aplikacji, który jest katalogiem wejściowym określonym w parametrze --package-directory .
• Plik manifestu aplikacji jest podany w parametrze --application-manifest .
• W przypadku aplikacji wysokiego poziomu w parametrze jest dostępna wersja środowiska wykonawczego --target-api-set aplikacji.

Wymagane parametry

Parametr	Typu	Opis
--Docelowy	Ścieżka do pakietu obrazów	Określa ścieżkę i nazwę pliku dla pakietu obrazów wyjściowych.
--package-directory	Ścieżka do approot_folder	Identyfikuje katalog wejściowy, który jest używany jako katalog główny systemu dla pliku obrazu Azure Sphere. Plik app_manifest.json aplikacji musi znajdować się w tym katalogu.

Parametry opcjonalne

Parametr	Typu	Opis
-a, --application-manifest	Ciąg	Określa ścieżkę do pliku manifestu aplikacji. Może to być plik JSON lub katalog zawierający plik app_manifest.json. Możesz podać ścieżkę względną lub bezwzględną.
--hardware-definitions	Ciąg	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 urządzeń peryferyjnych w formacie app_manifest.json na wartości źródłowe. Możesz podać ścieżkę względną lub bezwzględną. Aby uzyskać więcej informacji, zobacz definicja sprzętu .
--target-api-set	Ciąg	Określa nazwę docelowego zestawu interfejsu API używanego podczas kompilacji. Wymagane dla aplikacji wysokiego poziomu, jeśli nie zostały określone w manifeście aplikacji. Nie jest to wymagane w przypadku aplikacji RTApps.
--target-definition-filename	Ciąg	Określa nazwę pliku definicji docelowej sprzętu używanego do mapowania nazw peryferyjnych w formacie app_manifest.json. Musi być podana, jeśli aplikacja używa definicji sprzętu.
-x, --executables	plik wykonywalny1,plikwykonywalny2 ...	Określa ścieżki do jednego lub kilku plików do oznaczenia jako wykonywalne w pakiecie obrazów. Element EntryPoint wymieniony w app_manifest plikach jest zawsze oznaczony jako wykonywalny, więc flaga -x jest wymagana tylko wtedy, gdy istnieją inne pliki wykonywalne. Domyślnie pliki nie są wykonywalne, gdy są spakowane do obrazu. Podrzędne ścieżki są względem ścieżki plików wykonywalnych. W ścieżkach może być użyta składnia nazwy pliku systemu Windows (ukośniki odwrotne) lub składnia nazwy pliku systemu Linux (ukośniki); Spacje, przecinki i średniki nie są dozwolone. Możesz określić -x dla każdego pliku wykonywalnego lub użyć go tylko raz i podać wiele ścieżek rozdzielonych przecinkami bez interweniujących spacji.

Parametry globalne

Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:

Parametr	Opis
--Debugowania	Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help	Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń.
--only-show-errors	Wyświetla tylko błędy, pomijając ostrzeżenia.
-o, --output	Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI.
--Kwerendy	Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI.
--Pełne	Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania.

Uwaga

Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.

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 obrazów konfiguracji tablicy. Możesz użyć wstępnie ustawionego obrazu konfiguracji tablicy lub udostępnić niestandardowy obraz konfiguracji.

Wymagane parametry

Parametr	Typu	Opis
--Docelowy	Ciąg	Określa ścieżkę do nazwy pliku wyjściowego dla otrzymanego pakietu obrazów.

Parametry opcjonalne

Parametr	Typu	Opis
--board-config-file	Ścieżka	Identyfikuje ścieżkę do obrazu konfiguracji tablicy. Jeśli ta opcja jest uwzględniona, --preset nie wolno jej używać; te dwa parametry wzajemnie się wykluczają.
-n, --name	Ciąg	Ustawia nazwę pakietu obrazów w metadanych utworzonego pliku. Jeśli nie podano, nowa nazwa zostanie wygenerowana na podstawie podanej konfiguracji tablicy, zawierającej część identyfikatora składnika dla unikatowości.
-p, --preset	Ciąg	Zawiera identyfikator wstępnie ustawionego obrazu konfiguracji tablicy do zastosowania. Wprowadź identyfikator wstępnie ustawionego pakietu lub podaj ścieżkę do pliku konfiguracji tablicy, używając parametru --board-config-file dla niestandardowego obrazu konfiguracji tablicy. Identyfikator jest wartością wyliczbowania i jest obecnie stałą wartością pojedynczą lan-enc28j60-isu0-int5.

Parametry globalne

Następujące parametry globalne są dostępne dla środowiska Azure Sphere CLI:

Parametr	Opis
--Debugowania	Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help	Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń.
--only-show-errors	Wyświetla tylko błędy, pomijając ostrzeżenia.
-o, --output	Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI.
--Kwerendy	Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI.
--Pełne	Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania.

Uwaga

Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.

Przykład

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

Pokaż

Wyświetla informacje o pakiecie obrazów.

Wymagane parametry

Parametr	Typu	Opis
-f, --pakiet obrazów	Ciąg	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 środowiska Azure Sphere CLI:

Parametr	Opis
--Debugowania	Zwiększa poziom szczegółowości rejestrowania, aby wyświetlić wszystkie dzienniki debugowania. Jeśli znajdziesz błąd, podaj dane wyjściowe wygenerowane z flagą --debug podczas przesyłania raportu o usterce.
-h, --help	Umożliwia drukowanie informacji odwołań do poleceń i ich argumentów oraz list dostępnych podgrup i poleceń.
--only-show-errors	Wyświetla tylko błędy, pomijając ostrzeżenia.
-o, --output	Zmienia format wyjściowy. Dostępne formaty wyjściowe to json, jsonc (kolorowy JSON), tsv (wartości oddzielone tabulatorami), tabela (czytelne dla człowieka tabele ASCII) i yaml. Domyślnie wynik tableinterfejsu. Aby dowiedzieć się więcej o dostępnych formatach wyjściowych, zobacz Format wyjściowy dla poleceń platformy Azure Sphere CLI.
--Kwerendy	Używa języka zapytań JMESPath do filtrowania danych wyjściowych zwróconych przez usługi zabezpieczeń Azure Sphere. Aby uzyskać więcej informacji i przykładów, zobacz Samouczek programu JMESPath i Dane wyjściowe poleceń interfejsu platformy Azure CLI.
--Pełne	Drukowanie informacji o zasobach utworzonych w usłudze Azure Sphere podczas operacji i innych przydatnych informacji. Służy --debug do pełnego tworzenia dzienników debugowania.

Uwaga

Jeśli używasz klasycznej platformy Azure Sphere, zobacz Parametry globalne , aby uzyskać więcej informacji na temat dostępnych opcji.

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