Een toepassing op hoog niveau maken

Belangrijk

Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.

De eenvoudigste manier om een nieuwe toepassing op hoog niveau te maken, is door te beginnen met de lege sjabloon vanuit de Azure Sphere-extensie van Visual Studio Code en de configuratie aan te passen aan uw project door de volgende stappen uit te voeren:

1. Visual Studio Code starten. Selecteer het opdrachtenpalet Weergeven>en typ vervolgens Azure Sphere: Nieuw project genereren.

   

2. Kies HL Blank in het menu Sjablonen.

   

3. Visual Studio Code geeft vervolgens een Bestandenverkenner venster weer. Navigeer naar de map waarin u de lege toepassing wilt plaatsen en geef een naam op voor uw project, bijvoorbeeld NewHLApp. Visual Studio Code maakt de map NewHLApp op uw geselecteerde locatie en genereert de buildbestanden voor de lege toepassing. U ziet berichten van CMake.

4. Open het CMakeLists.txt-bestand en geef de map op die definities bevat voor de hardware die u gebruikt. De HL Blank-toepassing bevat standaard geen hardwaredefinities. U kunt voorbeeldhardwaredefinities vinden in de opslagplaats azure Sphere-voorbeelden of er een maken zoals beschreven in hardwaredefinities.

   Hieronder ziet u hoe u de voorbeeldhardwaredefinities voor de Seeed Azure Sphere MT3620 Development Kit toevoegt:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Deze regel moet worden ingevoegd voordat de laatste opdracht begint azsphere_target_add_image_package.

U kunt ook een nieuwe toepassing op hoog niveau maken op basis van een van de Azure Sphere-voorbeelden op hoog niveau:

1. Kloon de opslagplaats voor voorbeelden als u dit nog niet hebt gedaan. Kopieer een van de toepassingsmappen op hoog niveau en wijzig de naam ervan voor uw project.

2. Wijzig in het CMakeLists.txt bestand de projectnaam in de naam van de nieuwe map. Voorbeeld:

   PROJECT(NewHLApp C)

De eenvoudigste manier om een nieuwe toepassing op hoog niveau te maken, is door te beginnen met de lege sjabloon vanuit de Visual Studio Azure Sphere-extensie en de configuratie aan uw project aan te passen door de volgende stappen uit te voeren:

1. Start Visual Studio en selecteer Een nieuw project maken.

2. Typ Azure Sphere het zoekvak met het label Zoeken naar sjablonen. Selecteer Azure Sphere HLCore Blank in de geretourneerde lijst en selecteer vervolgens Volgende.

3. Geef een projectnaam (bijvoorbeeld NewHLApp), een locatie van een projectbestand en een oplossingsnaam op (die hetzelfde kan zijn als de projectnaam) en selecteer Vervolgens Maken. Visual Studio maakt de map NewHLpp op uw geselecteerde locatie en genereert de buildbestanden voor de lege toepassing. U ziet berichten van CMake.

4. Open het CMakeLists.txt-bestand en geef de map op die definities bevat voor de hardware die u gebruikt. De HL Blank-toepassing bevat standaard geen hardwaredefinities. U kunt voorbeeldhardwaredefinities vinden in de opslagplaats azure Sphere-voorbeelden of er een maken zoals beschreven in hardwaredefinities.

   Hieronder ziet u hoe u de voorbeeldhardwaredefinities voor de Seeed Azure Sphere MT3620 Development Kit toevoegt:

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Deze regel moet worden ingevoegd voordat de laatste opdracht begint azsphere_target_add_image_package.

U kunt ook een nieuwe toepassing op hoog niveau maken op basis van een van de Azure Sphere-voorbeelden op hoog niveau:

1. Kloon de opslagplaats voor voorbeelden als u dit nog niet hebt gedaan. Kopieer een van de toepassingsmappen op hoog niveau en wijzig de naam ervan voor uw project.

2. Wijzig in het CMakeLists.txt bestand de projectnaam in de naam van de nieuwe map. Voorbeeld:

   PROJECT(NewHLApp C)

De eenvoudigste manier om een nieuwe toepassing op hoog niveau te maken, is om te beginnen met een van de Azure Sphere-voorbeelden op hoog niveau:

1. Kloon de opslagplaats voor voorbeelden als u dit nog niet hebt gedaan. Kopieer een van de toepassingsmappen op hoog niveau en wijzig de naam ervan voor uw project.

2. Wijzig in het CMakeLists.txt bestand de projectnaam in de naam van de nieuwe map. Voorbeeld:

   PROJECT(NewHLApp C)

Basisbestandsstructuur van een toepassing op hoog niveau

Ongeacht hoe u uw toepassing maakt, delen alle Azure Sphere-toepassingen de volgende kernbestanden:

• Broncode van toepassing in een of meer bestanden. Momenteel wordt alleen de broncode van de C-taal ondersteund.
• CMake-buildbestanden. CMakeLists.txt is vereist. CMake wordt samen met het ninja lightweight build-hulpprogramma gebruikt om het buildproces van de Azure Sphere-toepassing te beheren.
• Een app-manifestbestand met een beschrijving van de mogelijkheden die beschikbaar zijn voor de toepassing.

Toepassingen op hoog niveau hebben doorgaans ten minste drie andere bestanden:

• Een bestand applibs-versions.h om de versieniveaus van verschillende Azure Sphere-API's op te geven
• Twee hardwaredefinitiebestanden (een bewerkbare versie in JSON-indeling en een C-taal bevatten bestand dat ermee wordt gegenereerd) die een handige manier bieden om te verwijzen naar hardwareonderdelen in uw code. Met een consistente set hardwaredefinitiebestanden kunt u hardwareonafhankelijke broncode schrijven en vervolgens toepassingsinstallatiekopieën bouwen voor specifieke hardware door eenvoudigweg opnieuw te richten op het juiste hardwaredefinitiebestand in uw CMakeLists.txt-bestand.

Uw code schrijven

1. Schrijf uw toepassingscode met behulp van de azure Sphere-app-voorbeelden op hoog niveau als handleidingen. In de volgende onderwerpen worden specifieke implementatiescenario's beschreven:
   • Randapparatuur gebruiken in een toepassing op hoog niveau
   • Verbinding maken met webservices
   • WolfSSL gebruiken voor TLS-verbindingen
   • Certificaten beheren
   • Inzicht in geheugengebruik
   • Apparaatupdates uitstellen
   • Tijd beheren en de realtime klok gebruiken
   • Apparaatopslag gebruiken
   • Communiceren met een toepassing die geschikt is voor realtime
   • Power Down-status beheren
   • Energieprofielen instellen
   • Servicedetectie uitvoeren
2. In het bestand CMakeLists.txt:
   • Revisie van Azure Sphere SDK-hulpprogramma's opgeven
   • Doel-API-set opgeven
   • De doelhardware opgeven
3. In het bestand app_manifest.json:
   • Stel Name in op uw projectnaam.
   • Voeg toepassingsspecifieke mogelijkheden toe die uw code nodig heeft, zoals hardwarebronnen of verbindingen. Als de app op hoog niveau communiceert met een RTApp, voegt u de onderdeel-id van de toepassing op hoog niveau toe aan de AllowedApplicationConnections mogelijkheid.

Als u uw app op hoog niveau naast een realtime compatibele partner-app wilt implementeren, voegt u de onderdeel-id van de partner toe aan het veld partnerComponents van de configuratiesectie van het bestand launch.vs.json (Visual Studio) of .vscode/launch.json (Visual Studio Code):

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

Zie ook

• Bouw een toepassing op hoog niveau.

• Fouten opsporen in een toepassing op hoog niveau.