Ładowanie bezpośrednie pakietu obrazu aplikacji na potrzeby testowania
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ą).
Podczas programowania może być konieczne bezpośrednie załadowanie pakietu obrazu na urządzenie usługi Azure Sphere na potrzeby testowania. Podczas tworzenia aplikacji przy użyciu zintegrowanego środowiska projektowego (IDE) programu Visual Studio lub Visual Studio Code zestaw SDK pakuje obraz aplikacji. Jeśli masz bezpośredni dostęp do urządzenia usługi Azure Sphere, zestaw SDK może również usunąć istniejące aplikacje, które nie są oznaczone jako partnerzy, załadować nowy pakiet obrazu na urządzenie, uruchomić go i włączyć debugowanie. Pakiet obrazu można również załadować 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. Przypisanie urządzeń do takiej grupy gwarantuje, że ładowane bezpośrednio aplikacje nie zostaną zastąpione przez wdrożenia w chmurze. Aby przygotować urządzenie, użyj polecenia azsphere device enable-development. Następnie można załadować obraz bezpośrednio.
Ładowanie bezpośrednie i debugowanie pakietu obrazu z poziomu wiersza polecenia
Aby załadować pakiet obrazów bezpośrednio z wiersza polecenia, należy usunąć wszystkie istniejące aplikacje na urządzeniu, a następnie załadować nowy.
Aby zatrzymać i usunąć wszystkie aplikacje na urządzeniu:
azsphere device sideload delete
Aby usunąć jedną aplikację, dodaj opcję --component-id w następujący sposób:
azsphere device sideload delete --component-id <ComponentID>
Następnie załaduj bezpośrednio nowy pakiet obrazów:
azsphere device sideload deploy --image-package <imagepackagepath>
Zastąp ciąg imagepackagepath ścieżką do pakietu obrazów. Jeśli używasz programu Visual Studio lub Visual Studio Code, pakiet obrazu można znaleźć w podfolderze bin\ARM\Debug lub bin\ARM\Release folderu projektu aplikacji. Domyślnie polecenie uruchamia aplikację po jej wdrożeniu.
Aby debugować aplikację, dodaj flagę --manual-start do polecenia azsphere device sideload deploy , aby pominąć automatyczne uruchamianie, a następnie uruchomić aplikację do debugowania:
azsphere device sideload deploy --manual-start --image-package <imagepackagepath>
azsphere 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 powiązane powinny być oznaczone jako aplikacje partnerskie. Istnieje wiele sytuacji, w których można załadować wiele aplikacji, takich jak para aplikacji wysokiego poziomu i aplikacji w czasie rzeczywistym, które komunikują się ze sobą. Oznaczanie aplikacji jako partnerów uniemożliwi usunięcie jednego z nich po załadowaniu drugiego. Gdy środowiska IDE programu Visual Studio i Programu Visual Studio Code ładowają bezpośrednio 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 narzędzia CMake w programie Visual Studio:
Edytuj plik launch.vs.json dla aplikacji.
Dodaj następujący wiersz:
"partnerComponents": [ "<Component ID>" ]Zastąp 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 za pomocą polecenia azsphere device image list-installed lub azsphere device app show-status.
Aby oznaczyć aplikację jako partnera przy użyciu narzędzia CMake w programie Visual Studio Code:
Edytuj plik .vscode\launch.json dla aplikacji.
Dodaj następujący wiersz:
"partnerComponents": [ "<Component ID>" ]Zastąp 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 za pomocą polecenia azsphere device image list-installed lub azsphere device app show-status.