Een toepassingsinstallatiekopieënpakket sideloaden voor testen
Tijdens de ontwikkeling moet u mogelijk een installatiekopieënpakket sideloaden naar het Azure Sphere-apparaat om te testen. Wanneer u een toepassing bouwt met de Visual Studio of Visual Studio Code Integrated Development Environment (IDE), verpakt de SDK de toepassingsinstallatiekopieën voor u. Als u directe toegang hebt tot een Azure Sphere-apparaat, kan de SDK ook bestaande toepassingen verwijderen die niet zijn gemarkeerd als partners, het nieuwe installatiekopieënpakket op het apparaat laden, starten en foutopsporing inschakelen. U kunt een installatiekopiepakket ook rechtstreeks vanaf de opdrachtregel sideloaden.
U moet eerst de appDevelopment-mogelijkheid voor het apparaat inschakelen en het apparaat toevoegen aan een apparaatgroep die geen ondersteuning biedt voor updates van cloudtoepassingen. Als u apparaten toewijst aan een dergelijke groep, zorgt u ervoor dat uw sideload-toepassingen niet worden overschreven door cloudimplementaties. Gebruik de opdracht az sphere device enable-development om uw apparaat voor te bereiden. Vervolgens kunt u de installatiekopieën sideloaden.
Een installatiekopiepakket sideloaden en fouten opsporen vanaf de opdrachtregel
Als u het installatiekopiepakket wilt sideloaden vanaf de opdrachtregel, verwijdert u alle bestaande toepassingen op het apparaat en laadt u vervolgens de nieuwe.
Alle toepassingen op het apparaat stoppen en verwijderen:
az sphere device sideload delete
Als u één toepassing wilt verwijderen, voegt u de optie --component-id als volgt toe:
az sphere device sideload delete --component-id <ComponentID>
Vervolgens sideloadt u het nieuwe installatiekopieënpakket:
az sphere device sideload deploy --image-package <imagepackagepath>
Vervang imagepackagepath door het pad naar het installatiekopieënpakket. Als u Visual Studio of Visual Studio Code gebruikt, vindt u het installatiekopieënpakket in de submap bin\ARM\Debug of bin\ARM\Release van de projectmap van de toepassing. Standaard wordt de toepassing met de opdracht gestart nadat deze is geïmplementeerd.
Als u fouten in de toepassing wilt opsporen, voegt u de vlag --manual-start toe aan de opdracht az sphere device sideload deploy om automatisch starten te onderdrukken en start u de toepassing voor foutopsporing:
az sphere device sideload deploy --manual-start --image-package <imagepackagepath>
az sphere device app start --debug --component-id <ComponentID>
Met de opdracht worden de uitvoer- en foutopsporingspoorten voor toepassingen op hoog niveau weergegeven:
Output Port: 2342
GDB Port: 2345
Toepassingen markeren als partners
Toepassingen die gerelateerd zijn, moeten worden gemarkeerd als partnertoepassingen. Er zijn veel situaties waarin u meerdere toepassingen laadt, zoals een paar toepassingen op hoog niveau en realtime toepassingen die met elkaar communiceren. Als u de toepassingen markeert als partners, voorkomt u dat een toepassing wordt verwijderd wanneer de tweede wordt geladen. Wanneer de IDE's van Visual Studio en Visual Studio Code een nieuw installatiekopieënpakket sideloaden, worden alle bestaande toepassingen verwijderd die niet zijn gemarkeerd als partnertoepassingen.
Een toepassing markeren als een partner met CMake in Visual Studio:
Bewerk het bestand launch.vs.json voor de toepassing.
Voeg de volgende regel toe:
"partnerComponents": [ "<Component ID>" ]Vervang de onderdeel-id van de partnertoepassing door
<Component ID>en sla het bestand op. U vindt de onderdeel-id van elke toepassing in het bijbehorende bestand app_manifest.json of met behulp van az sphere device image list-installed of az sphere device app show-status.
Een toepassing markeren als een partner met CMake in Visual Studio Code:
Bewerk het bestand .vscode\launch.json voor de toepassing.
Voeg de volgende regel toe:
"partnerComponents": [ "<Component ID>" ]Vervang de onderdeel-id van de partnertoepassing door
<Component ID>en sla het bestand op. U vindt de onderdeel-id van elke toepassing in het bijbehorende bestand app_manifest.json of met behulp van az sphere device image list-installed of az sphere device app show-status.