Rövid útmutató: A Linuxhoz készült Azure Sphere SDK telepítése

Cikk
03/27/2024

Az Azure Sphere SDK linuxos operációs rendszert futtató számítógépre telepítheti az Azure Sphere-alkalmazások fejlesztéséhez, üzembe helyezéséhez és hibakereséséhez.

Előfeltételek

Az Azure Sphere SDK telepítéséhez a következő előfeltételek szükségesek:

Egy Azure Sphere fejlesztői készlet.
Egy 64 bites Ubuntu 24.04 (előzetes kiadás), Ubuntu 22.04 LTS vagy Ubuntu 20.04 LTS rendszert futtató x86-64-alapú processzorral rendelkező számítógép. Csak Intel-kompatibilis x86-64 processzorok támogatottak; más architektúrák, például az ARM (beleértve a Raspberry Pi-t), az Itanium vagy a SPARC nem támogatottak. Az x86-64 architektúra más néven x64, x86_64, AMD64 és Intel 64.
Linux-engedély sudo .
Internetkapcsolat vagy fájlok átvitelének módja internetkapcsolattal rendelkező számítógépről a számítógépre. További információ: Az SDK telepítése internetkapcsolat nélkül.

Szükséges Linux-csomagok hozzáadása

Az SDK telepítési szkript futtatása előtt hozzá kell adnia a szükséges Linux-csomagokat a számítógéphez, ha még nincsenek telepítve. Adja meg a következő sorokat egy Linux-terminálban. Kihagyhatja a már telepített csomagokat.

sudo apt-get update
sudo apt-get install -y net-tools curl

Az Azure Sphere SDK telepítése

Kövesse az alábbi lépéseket:

Töltse le a telepítési szkriptet.
Keresse meg azt a mappát, amelybe letöltötte a tömörített fájlt.
Bontsa ki a tömörített fájl tartalmát. Például: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. A .tar.gz fájl tartalmazza a install_azure_sphere_sdk.sh fájlt.
Futtassa a telepítési szkriptet a paranccsal sudo az alábbiak szerint:
```
sudo ./install_azure_sphere_sdk.sh
```
Ha a szkript futtatásakor hibaüzenet command not found jelenik meg, engedélyezze a telepítési szkript végrehajtását a következő paranccsal:
```
chmod +x install_azure_sphere_sdk.sh
```

A telepítés során a szkript megerősítő üzeneteket jelenít meg. A megerősítő üzenetek kihagyhatók a szkript jelölővel történő meghívásával -y :

sudo ./install_azure_sphere_sdk.sh -y

A jelző nélkül a -y szkript a következő kérdésekre vár válaszokat:

The SDK tarball signature is valid. The fingerprint of the key used is:

Primary key fingerprint: <hexadecimal>

Please check that this fingerprint matches the Microsoft GPG public key fingerprint shown on https://aka.ms/AzureSphereSDKVerification/Linux before proceeding. Do not proceed if these values do not match.
Proceed with installation? (Y/N)

Lépjen a Microsoft nyilvános kulcsú ujjlenyomat-webhelyére , és ellenőrizze, hogy a telepítés során megjelenített hexadecimális ujjlenyomat értéke megegyezik-e az oldalon látható Microsoft nyilvánoskulcs-ujjlenyomattal. Ne folytassa, ha a két ujjlenyomat nem egyezik.

Installing CLI.
This SDK contains two versions of the Azure Sphere CLI: the new Azure Sphere CLI (recommended) and Azure Sphere classic CLI (retiring). See https://aka.ms/AzureSphereCLIVersions for more information on the versions.

You can choose which version is available through the command 'azsphere'.

Note that the Azure Sphere classic CLI will always be available to use with 'azsphere_v1' and the new Azure Sphere CLI will always be available to use with 'azsphere_v2'.
Use the recommended (new) CLI for 'azsphere'? (Y/N)

Válassza az Y Azure Sphere CLI alapértelmezett parancssori felületként való beállítását, vagy N a klasszikus Azure Sphere parancssori felület alapértelmezett parancssori felületként való beállítását.

Some device operations require root permissions, or permissions granted by a udev rule. Set up the default udev rule and group (azsphere), and add the current user to it? (Y/N)

Válassza a lehetőséget Y az azsphere csoport beállításához és az udev-szabály létrehozásához.

A telepítés befejezése után újra be kell jelentkeznie az asztali alkalmazásba vagy a bejelentkezési felületre az Azure Sphere (örökölt) parancssori felületének inicializálásához.

A telepítés után az azsphere parancs a PATH-on van, és az eszköz új udev-szabályai a következő helyen találhatók: /etc/udev/rules.d/.

A szkript telepíti az SDK-t az /opt/azurespheresdk helyre, az eszközláncokat pedig az /opt/azurespheresdk/Sysroots/sysroot-version/tools helyre, ahol a sysroot-version azonosítja azt a sysrootot , amelyhez az SDK támogatja az alkalmazásfejlesztést.

A telepítő telepíti a parancssori felület Azure Sphere (örökölt) CLI-verzióit. Nem kell eltávolítania az aktuális verziót, mert a telepítés frissíti a meglévő verziót. Az Azure Sphere (örökölt) parancssori felülete az /opt/azurespheresdk/Tools_v2 és az Azure Sphere (örökölt) klasszikus parancssori felületét az /opt/azurespheresdk/Tools helyen telepíti.

Linuxon futtathatja az Azure Sphere (örökölt) parancssori felületet egy terminálról a használatával azsphere_v2 , és azsphere ha a telepítés során alapértelmezett parancssori felületként lett kiválasztva.

A parancssori felület első telepítése után az azsphere show-version futtatásával ellenőrizze, hogy telepítve van-e, és hogy a megfelelő verzióval rendelkezik-e.

Udev-szabályok

Az Azure Sphere SDK szabja meg udev a számítógép eszközadataira vonatkozó szabályokat. Az SDK létrehoz egy nevű azsphere új csoportot, és hozzáadja a jelenleg bejelentkezett felhasználót a csoporthoz. A udev szabály az Azure Sphere-eszköz leírásának megfelelő USB-eszközök tulajdonjogát adja meg. Miután telepítette az SDK-t, és újraindította a számítógépet, nem kell használnia sudo az eszközt az eszköz helyreállításához vagy az ARM Cortex-M4 hibakereséséhez.

A azsphere rendszer hozzáadja a csoportot, hogy engedélyeket adjon a udev szabály használatával. Ne módosítsa manuálisan a csoportot.

Az SDK telepítése internetkapcsolat nélkül

Ha nincs internetkapcsolata azon a számítógépen, amelyre az SDK-t telepíti, le kell töltenie a fájlokat egy internetkapcsolattal rendelkező számítógépre, és át kell vinnie őket a telepítő számítógépre.

Töltse le ezeket a fájlokat, és vigye át őket a telepítő számítógépre:
- Linuxhoz készült Azure Sphere SDK: az Ubuntu 24.04 (előzetes verzió) vagy az Ubuntu 22.04 LTS vagy az Ubuntu 20.04 LTS közül választhat.
  
  A letöltött fájl egy tömörített kátrányfájl (.tar.gz fájl), amelynek neve Azure_Sphere_SDK_Bundle kezdődik.
- Telepítési szkript: ez egy tömörített kátrányfájl (.tar.gz fájl), amelynek neve install_azure_sphere_sdk kezdődik.
- A Microsoft GPG nyilvános kulcsa: ez egy ASCII-szövegfájl.
A telepítő számítógépen keresse meg azt a mappát, amelybe a fájlokat átvitte.
Bontsa ki a tömörített telepítési szkriptfájl tartalmát. Például: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. A .tar.gz fájl tartalmazza a install_azure_sphere_sdk.sh fájlt. Hagyja az Azure Sphere SDK-csomagot tömörített kátrányfájlként (tar.gz fájlként).
Futtassa a telepítési szkriptet a paranccsal sudo. Adja meg a paramétert -i az SDK-csomag elérési útjának és a -k kulcs elérési útjának megadásához. A parancsnak a következőhöz hasonlónak kell lennie:

sudo ./install_azure_sphere_sdk.sh -i [pathtopackage]/[sdkbundle] -k [pathtokey]/microsoft.asc

Ha a szkript futtatásakor hibaüzenet command not found jelenik meg, engedélyezze a telepítési szkript végrehajtását a következő paranccsal:
```
chmod +x install_azure_sphere_sdk.sh
```

Folytassa a telepítést az Azure Sphere SDK telepítése című cikkben leírtak szerint.

Az Azure Sphere-bővítmény telepítése az Azure CLI-hez

Az Azure Sphere-hez csatlakoztatott eszközök és felhőbeli üzemelő példányok felügyeletére szolgáló parancssori eszköz Azure CLI-bővítményként van elosztva. A bővítmény hozzáadásához vagy frissítéséhez kövesse az alábbi lépéseket:

Ha még nem tette meg, telepítse az Azure CLI-t.

Az Azure Sphere-bővítmény hozzáadásához futtassa a következő parancsot:
```
az extension add --name azure-sphere
```
Az Azure Sphere-bővítmény frissítéséhez futtassa a következő parancsot:
```
az extension udpate --name azure-sphere
```

Az Azure Sphere-eszközök kezeléséhez használni kívánt Azure-előfizetésbe való bejelentkezéshez be kell jelentkeznie az Azure CLI-vel .

További információ: Az Azure Sphere-bővítmény letöltése és futtatása.

A fejlesztési környezet beállítása

Azure Sphere-alkalmazásokat Fejleszthet Linuxon a Visual Studio Code vagy a parancssori felület (CLI) használatával. Függetlenül attól, hogy melyiket használja, telepítenie kell a CMake-t és a Ninja-t a fejlesztői gépére, ha még nem rendelkezik velük. Tekintse meg a Kitware APT-adattár telepítéshez való hozzáadásának utasításait.

A CMake és a Ninja telepítése

A CMake és a Ninja telepítéséhez először tekintse meg a Kitware APT-adattár telepítéshez való hozzáadására vonatkozó utasításokat, majd használja a következő parancsot:

sudo apt-get install cmake ninja-build

Megjegyzés

Ne telepítse a cmake-t vagy a nindzsát a snap használatával.

A Visual Studio Code-hoz készült Azure Sphere-bővítmény telepítése

Ha a Visual Studio Code-ot szeretné használni fejlesztési környezetként, telepítenie kell azt és az Azure Sphere-bővítményt.

Ha még nem tette meg, telepítse a Visual Studio Code letöltési hivatkozásait.
Az Azure Sphere-bővítmény telepítéséhez keressen rá az "Azure Sphere" kifejezésre a bővítmények piacterén egy böngészőből vagy a Visual Studio Code-ban. Két eredménynek kell megjelennie, az Azure Sphere-nek és az Azure Sphere felhasználói felületének. Válassza a Telepítés lehetőséget bármelyikhez; a másikat automatikusan telepíteni kell.
A telepítés után a Visual Studio Code IDE ENABLED Extensions paneljén meg kell jelennie az Azure Sphere, C/C++ és CMake Tools bővítményeknek.

A telepítés befejezése után megnyílik a bővítmény Readme oldala. A Readme oldal hasznos információkat nyújt a Visual Studio Code konfigurációjáról és követelményeiről, és a bővítménnyel együtt frissül. A Readme oldalt bármikor megtekintheti a Bővítmények panel megnyitásával és az Azure Sphere kiválasztásával.

Következő lépések

Az eszköz igénylése