Ładowanie bezpośrednie pakietu obrazów aplikacji do testowania

Podczas opracowywania może być konieczne załadowanie pakietu obrazów na urządzenie Azure Sphere w celu przeprowadzenia testów. Podczas tworzenia aplikacji za pomocą programu Visual Studio lub Visual Studio Code zintegrowanego środowiska programistycznego (IDE) zestaw SDK udostępnia obraz aplikacji. Jeśli masz bezpośredni dostęp do urządzenia Azure Sphere, zestaw SDK może również usunąć istniejące aplikacje, które nie są oznaczone jako partnerzy, załadować nowy pakiet obrazów na urządzenie, uruchomić go i włączyć debugowanie. Pakiet obrazów można także pobrać bezpośrednio z wiersza polecenia.

Najpierw należy włączyć funkcję appDevelopment dla urządzenia i dodać urządzenie do grupy urządzeń , która nie obsługuje aktualizacji aplikacji w chmurze. Przypisywanie urządzeń do takiej grupy zapewnia, że aplikacje ładowane lokalnie nie zostaną zastąpione przez wdrożenia w chmurze. Aby przygotować urządzenie, użyj polecenia az sphere device enable-development. Następnie możesz załadować obraz obok siebie.

Ładowanie bezpośrednie i debugowanie pakietu obrazów z wiersza polecenia

Aby pobrać pakiet obrazów z wiersza polecenia, usuń wszystkie istniejące aplikacje na urządzeniu, a następnie załaduj nową.

Aby zatrzymać i usunąć wszystkie aplikacje na urządzeniu:

az sphere device sideload delete

Aby usunąć jedną aplikację, dodaj opcję --component-id w następujący sposób:

az sphere device sideload delete --component-id <ComponentID>

Następnie załaduj ponownie nowy pakiet obrazów:

az sphere device sideload deploy --image-package <imagepackagepath>

Zastąp ścieżkę imagepackagepath ścieżką do pakietu obrazów. Jeśli używasz programu Visual Studio lub Visual Studio Code, pakiet obrazów znajduje się w podfolderze bin\ARM\Debug or bin\ARM\Release folderu projektu aplikacji. Domyślnie polecenie uruchamia aplikację po jej wdrożeniu.

Aby debugować aplikację, dodaj flagę --manual-start do polecenia wdrażania urządzenia az sphere w celu pominięcia automatycznego uruchamiania, a następnie uruchom aplikację do debugowania:

az sphere device sideload deploy --manual-start --image-package <imagepackagepath>
az sphere device app start --debug --component-id <ComponentID>

Polecenie wyświetla porty wyjściowe i debugowania dla aplikacji wysokiego poziomu:

   Output Port: 2342
   GDB Port: 2345

Oznaczanie aplikacji jako partnerów

Aplikacje, które są powiązane, powinny być oznaczone jako aplikacje partnerskie. Istnieje wiele sytuacji, w których można załadować wiele aplikacji, na przykład parę aplikacji wysokiego poziomu i aplikacji w czasie rzeczywistym, które komunikują się ze sobą. Oznaczenie aplikacji jako partnerów zapobiegnie usunięciu jednego z nich po załadowaniu drugiego. Gdy programy Visual Studio i Visual Studio Code IDEs pobierają nowy pakiet obrazów, usuwają wszystkie istniejące aplikacje, które nie są oznaczone jako aplikacje partnerskie.

Aby oznaczyć aplikację jako partnera przy użyciu usługi CMake w programie Visual Studio:

  1. Edytuj plik launch.vs.json dla aplikacji.

  2. Dodaj następujący wiersz:

    "partnerComponents": [ "<Component ID>" ]
    

    Podstaw identyfikator składnika aplikacji <Component ID> partnerskiej i zapisz plik. Identyfikator składnika każdej aplikacji można znaleźć w pliku app_manifest.json lub przy użyciu zainstalowanej listy obrazów urządzenia az sphere lub stanu wyświetlania aplikacji urządzenia azsphere.

Aby oznaczyć aplikację jako partnera korzystającego z usługi CMake w Visual Studio Code:

  1. Edytuj plik vscode\launch.json aplikacji.

  2. Dodaj następujący wiersz:

    "partnerComponents": [ "<Component ID>" ]
    

    Podstaw identyfikator składnika aplikacji <Component ID> partnerskiej i zapisz plik. Identyfikator składnika każdej aplikacji można znaleźć w pliku app_manifest.json lub przy użyciu zainstalowanej listy obrazów urządzenia az sphere lub stanu wyświetlania aplikacji urządzenia azsphere.