Magas szintű alkalmazás létrehozása

Ez a szakasz egy magas szintű Azure Sphere-alkalmazás létrehozását, csomagolását és üzembe helyezését ismerteti.

Ezek az utasítások példaként a HelloWorld_HighLevelApp mintaalkalmazást használják.

Előfeltételek

• Az Azure Sphere-eszköz csatlakoztatása a számítógéphez
• Az Azure Sphere telepítése

Az eszköz előkészítése a fejlesztéshez és a hibakereséshez

Mielőtt létrehozhat egy mintaalkalmazást az Azure Sphere-eszközön, vagy új alkalmazásokat fejleszthet hozzá, engedélyeznie kell a fejlesztést és a közvetlen telepítést. Alapértelmezés szerint az Azure Sphere-eszközök "zárolva" vannak; vagyis nem engedélyezik a fejlesztés alatt álló alkalmazások betöltését a számítógépről, és nem teszik lehetővé az alkalmazások hibakeresését. Az eszköz közvetlen telepítésre való előkészítése eltávolítja ezt a korlátozást.

Az az sphere device enable-development parancs úgy konfigurálja az eszközt, hogy fogadja a hibakeresési alkalmazásokat, betölti a hibakereső kiszolgálót az eszközre, és hozzárendeli az eszközt egy olyan eszközcsoporthoz , amely nem engedélyezi a felhőalkalmazások frissítését. Az alkalmazásfejlesztés és a hibakeresés során az eszközt ebben a csoportban kell hagynia, hogy a felhőalapú alkalmazásfrissítések ne írja felül a fejlesztés alatt álló alkalmazást.

1. Győződjön meg arról, hogy az Azure Sphere-eszköz csatlakoztatva van a számítógéphez, a számítógép pedig az internethez.

2. Nyisson meg egy parancssori felületet a PowerShell, a Windows parancssor vagy a Linux parancshéj használatával.

3. Adja meg a következő parancsot:

   az sphere device enable-development --resource-group <ResourceGroupName> --catalog <CatalogName> --device <DeviceIdValue>
   

   A következőhöz hasonló kimenetnek kell megjelennie:

   Getting device capability configuration for application development.
   Downloading device capability configuration for device ID '<device ID>'.
   Successfully downloaded device capability configuration.
   Successfully wrote device capability configuration file 'C:\Users\user\AppData\Local\Temp\tmpD732.tmp'.
   Setting device group ID 'a6df7013-c7c2-4764-8424-00cbacb431e5' for device with ID '<device ID>'.
   Successfully disabled over-the-air updates.
   Enabling application development capability on attached device.
   Applying device capability configuration to device.
   Successfully applied device capability configuration to device.
   The device is rebooting.
   Installing debugging server to device.
   Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
   Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
   Application development capability enabled.
   Successfully set up device '<device ID>' for application development, and disabled over-the-air updates.
   Command completed successfully in 00:00:38.3299276.
   

Ha az az sphere device enable-development parancs sikertelen, segítségért tekintse meg az Azure Sphere-problémák hibaelhárítását ismertető cikket.

Az alkalmazás létrehozása és üzembe helyezése a Visual Studióban hibakereséssel

1. Győződjön meg arról, hogy az eszköz USB-n keresztül csatlakozik a számítógéphez. Az Indítási elem beállítása menüben válassza az Azure Sphere-alkalmazás (HLCore) lehetőséget, ahol az Azure Sphere-alkalmazás az aktuális magas szintű alkalmazás neve, vagy nyomja le az F5 billentyűt.

   

2. Ha a rendszer kéri a projekt összeállítását, válassza az Igen lehetőséget. A Visual Studio lefordítja az alkalmazást, létrehoz egy képcsomagot, közvetlenül betölti a táblára, és hibakeresési módban elindítja. A közvetlen telepítés azt jelenti, hogy az alkalmazás közvetlenül a számítógépről, vezetékes kapcsolaton keresztül érkezik, nem pedig a felhőn keresztül.

   Jegyezze fel a képcsomag képazonosítóját aKimenet>megjelenítése kimeneténekmegtekintése> innen: Build kimenetében. A rendszerkép-azonosítót később, az Oktatóanyag: Felhőbeli üzemelő példány létrehozása című témakörben fogja használni.

3. Alapértelmezés szerint a Kimenet ablakban az Eszközkimenet kimenete látható. A hibakereső üzeneteinek megtekintéséhez válassza a Hibakeresés lehetőséget a Kimenet megjelenítése innen: legördülő menüben. AWindowshibakeresési> menüjében a program szétbontását, regisztrációit vagy memóriáját is megvizsgálhatja.

Az alkalmazás létrehozása és üzembe helyezése a Visual Studióban hibakeresés nélkül

1. Győződjön meg arról, hogy az eszköz USB-n keresztül csatlakozik a számítógéphez. A Hibakeresés menüben válassza az Indítás hibakeresés nélkül lehetőséget, vagy nyomja le a Ctrl+F5 billentyűkombinációt.

2. Ha a rendszer kéri a projekt összeállítását, válassza az Igen lehetőséget. A Visual Studio lefordítja az alkalmazást, létrehoz egy képcsomagot, közvetlenül betölti a táblára, és elindítja. A közvetlen telepítés azt jelenti, hogy az alkalmazás közvetlenül a számítógépről, vezetékes kapcsolaton keresztül érkezik, nem pedig a felhőn keresztül.

3. Alapértelmezés szerint a Kimenet ablakban az Eszközkimenet kimenete látható.

Az alkalmazás létrehozása és üzembe helyezése a Visual Studio Code-ban hibakereséssel

1. Nyomja le az F5 billentyűt a projekt létrehozásához és hibakereséséhez. Ha a projekt még nem készült el, vagy ha a fájlok megváltoztak, és újra kell építeni, a Visual Studio Code a hibakeresés megkezdése előtt létrehozza a projektet.

2. Várjon néhány másodpercet, amíg a Visual Studio Code létrehozza az alkalmazást, létrehoz egy rendszerképcsomagot, üzembe helyezi a táblán, és hibakeresési módban elindítja. Az állapotfrissítések az út mentén, a Kimenet panelen láthatók.

   Először a CMake határozza meg, hogy létre kell-e építeni az alkalmazást. Ha igen, a fókusz a kimeneti ablakra kerül, amely a CMake/Build kimenetét jeleníti meg.

   Ezután a Kimenet panel megjeleníti az eredményt, amint a rendszerképcsomag üzembe van helyezve az eszközön. Végül a hibakeresési konzol megkapja a fókuszt, és megjeleníti a hibakereső kimenetét.

Az alkalmazás létrehozása és üzembe helyezése a Visual Studio Code-ban hibakeresés nélkül

1. Győződjön meg arról, hogy az eszköz USB-n keresztül csatlakozik a számítógéphez. A Futtatás menüben válassza a Start hibakeresés nélkül lehetőséget, vagy nyomja le a Ctrl+F5 billentyűkombinációt a projekt létrehozásához és futtatásához. Ha a projekt még nem készült el, vagy ha a fájlok megváltoztak, és újraépítésre van szükség, a Visual Studio Code létrehozza a projektet.

2. Várjon néhány másodpercet, amíg a Visual Studio Code létrehozza az alkalmazást, létrehoz egy rendszerképcsomagot, üzembe helyezi a táblán, és elindítja. Az állapotfrissítések az út mentén, a Kimenet panelen láthatók.

   Először a CMake határozza meg, hogy létre kell-e építeni az alkalmazást. Ha igen, a fókusz a kimeneti ablakra kerül, amely a CMake/Build kimenetét jeleníti meg.

   Ezután a kimeneti ablak az azsphere kimenetét jeleníti meg, amikor üzembe helyezi a lemezképcsomagot az eszközön. Az alkalmazás automatikusan elindul, miután üzembe helyezte az eszközön.

Az alkalmazás létrehozása

Az alkalmazás létrehozásához meg kell találnia a megfelelő fordítási eszközöket, fejléceket és kódtárakat – együttesen a sysrootot – a számítógépen. Az Azure Sphere SDK több sysroottal rendelkezik, így az alkalmazások különböző API-készleteket célozhatnak meg az alkalmazás futtatókörnyezetének verziójáról, a sysrootsról és a béta API-król. A sysroots az Azure Sphere SDK telepítési mappájában, a Sysroots alatt található.

1. Hozza létre vagy keresse meg azt a könyvtárat, amely a buildelési folyamat során létrehozandó fájlokat tartalmazza.

2. Ha az alkalmazás egy másik alkalmazástól függ, jelölje meg az alkalmazásokat partnerként a app_manifest.md fájljaiban.

3. Szükség esetén adja hozzá vagy frissítse az alkalmazás CMakeLists.txt fájlját az Azure Sphere CMake-függvények meghívásához.

4. Futtassa a CMake parancsot a projekt buildkönyvtárában a parancssorban a következő paraméterekkel:

   cmake --preset <preset-name> <source-path>
   

   • --preset <preset-name>

     A buildkonfiguráció előzetes neve a CMakePresets.json fájlban meghatározott módon.

   • --build <cmake-path>

     A CMake-gyorsítótárat tartalmazó bináris könyvtár. Ha például a CMake-et egy Azure Sphere-mintán futtatja, a build parancs a következő lesz cmake --build out/ARM-Debug: .

   • <source-path>

     A mintaalkalmazás forrásfájljait tartalmazó könyvtár elérési útja. A példában az Azure Sphere-mintaadattár egy AzSphere nevű könyvtárba lett letöltve.

     A CMake-paraméterek szóközökkel vannak elválasztva. A sorfolytatási karakter (Windows parancssor esetén^, Linux parancssor esetén \ vagy PowerShell esetén ' ) használható az olvashatósághoz, de nem kötelező.

   Az alábbi példák a "Helló világ!" alkalmazás magas szintű alkalmazás CMake-parancsait mutatják be.

   Windows

   Windows parancssor

   cmake ^
    --preset "ARM-Debug" ^
    "C:\AzSphere\azure-sphere-samples\Samples\HelloWorld\HelloWorld_HighLevelApp"
   

   Windows PowerShell

   cmake `
    --preset "ARM-Debug" `
    "C:\AzSphere\azure-sphere-samples\Samples\HelloWorld\HelloWorld_HighLevelApp"
   

   Linux

   cmake \
    --preset "ARM-Debug" \
    ./AzSphere/azure-sphere-samples/Samples/HelloWorld/HelloWorld_HighLevelApp
   

5. Futtassa a Ninja parancsot az alkalmazás létrehozásához és a képcsomagfájl létrehozásához:

   ninja -C out/ARM-Debug
   

   A Ninja elhelyezi az eredményként kapott alkalmazást és .imagepackage fájlokat a megadott könyvtárban.

   A Nindzsát a CMake-n keresztül is meghívhatja a következő paranccsal:

   cmake --build out/<binary-dir>
   

   Állítsa a <binary-dir> CMake-gyorsítótárat tartalmazó bináris könyvtárra. Ha például a CMake-et egy Azure Sphere-mintán futtatja, a build parancs a következő lesz cmake --build out/ARM-Debug: .

Az alkalmazás üzembe helyezése

Győződjön meg arról, hogy az eszköz rendelkezik az appDevelopment képességgel, így közvetlenül betöltheti az alkalmazást, és meggyőződhet arról, hogy a hibakereső kiszolgáló jelen van. Szükség esetén használja a az sphere device enable-development parancsot.

1. Ha az eszközön már fut egy vagy több alkalmazás, törölje őket.

   az sphere device sideload delete
   

   Vegye figyelembe, hogy ez a parancs törli az eszközön lévő összes alkalmazást. Ha már üzembe helyezett egy RTAppot, amely a magas szintű alkalmazás partnere, a --component-id paraméterrel adja meg, hogy melyik alkalmazást szeretné törölni. Az alkalmazás összetevő-azonosítóját a app_manifest.json fájlban találja.

2. Töltse be a képcsomagot az eszközre az az sphere device sideload deploy parancs futtatásával és a képcsomag megadásával. Például:

   az sphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
   

   Az alkalmazásnak futnia kell.

Az és a parancsokkal később leállíthatja és újraindíthatja az az sphere device app stop --component-id <component-ID>az sphere device app start --component-id <component ID> alkalmazást.