Rövid útmutató: Az Azure Sphere SDK telepítése Linuxhoz

Cikk
10/17/2024

Az Azure Sphere SDK-t 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.
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 x64, x86_64, AMD64 és Intel 64 néven is ismert.
Linux-engedély sudo .
Internetkapcsolat vagy fájlok átvitelének módja egy olyan számítógépről, amely internetkapcsolattal rendelkezik a számítógéphez. 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 szkriptjének 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

Tegye a következők egyikét:

Töltse le a telepítési szkriptet.
Lépjen arra a mappára, 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 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ést kérő üzenetek kihagyhatók a szkript jelölővel való meghívásával -y :

sudo ./install_azure_sphere_sdk.sh -y

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

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ános kulcs ujjlenyomatával. 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 az Azure Sphere klasszikus parancssori felületének 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 ki Y az azsphere-csoportot, és hozza létre az udev szabályt.

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 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 /etc/udev/rules.d/találhatók: .

A szkript telepíti az SDK-t az /opt/azurespheresdk fájlba, 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) CLI telepítve van az /opt/azurespheresdk/Tools_v2 és az Azure Sphere (örökölt) klasszikus parancssori felület az /opt/azurespheresdk/Tools alkalmazásban.

Linuxon futtathatja az Azure Sphere (örökölt) parancssori felületet egy terminálról 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 ellenőrizze, hogy telepítve van-e, és az azsphere show-version futtatásával a megfelelő verziót használja.

Udev-szabályok

Az Azure Sphere SDK a számítógép eszközadataira vonatkozó szabályokat határozza meg udev . Az SDK létrehoz egy új csoportot, amelyet meghív azsphere , é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 biztosítja. Miután telepítette az SDK-t, és újraindította a számítógépet, nem kell használnia sudo az eszköz helyreállítását vagy az ARM Cortex-M4 hibakeresését.

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 nem rendelkezik internetkapcsolattal 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 helyeznie ő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:
- Azure Sphere SDK Linuxhoz: az Ubuntu 24.04 (előzetes kiadás) 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.
- Szkript telepítése: 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öveges fá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 következővel 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ésével.

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

Az Azure Sphere-hez csatlakoztatott eszközök és felhőtelepítések kezelésé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 hajtsa végre 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ára vonatkozó utasításokat.

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

Feljegyzés

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

Az Azure Sphere-bővítmény telepítése a Visual Studio Code-hoz

Ha a Visual Studio Code-ot szeretné fejlesztési környezetként használni, 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ény marketplace-en egy böngészőből vagy a Visual Studio Code-ban. Két eredményt kell látnia, az Azure Sphere-t és az Azure Sphere felhasználói felületét. Válassza a Telepítés lehetőséget az egyikhez, a másikat pedig automatikusan telepíteni kell.
A telepítés után az Azure Sphere, a C/C++ és a CMake Tools bővítményeknek a Visual Studio Code IDE ENABLED Extensions paneljén kell megjelennie.

Ha a telepítés befejeződött, megnyílik a bővítmény Readme oldala. A Readme oldal hasznos információkat nyújt a Visual Studio Code konfigurálásáról és követelményeiről, és a bővítménysel együtt frissül. Az Olvasási lap bármikor megtekinthető a Bővítmények panel megnyitásával és az Azure Sphere kiválasztásával.

Következő lépések

Eszköz igénylése