Szybki start: instalowanie pakietu Azure Sphere SDK dla systemu Linux

Artykuł
04/03/2024

Pakiet Azure Sphere SDK można zainstalować na komputerze z systemem operacyjnym Linux, aby tworzyć, wdrażać i debugować aplikacje Azure Sphere.

Wymagania wstępne

Instalacja narzędzia Azure Sphere SDK wymaga następujących wymagań wstępnych:

Zestaw deweloperski Azure Sphere.
Komputer z procesorem x86-64 z 64-bitowym Ubuntu 24.04 (wersja wstępna), Ubuntu 22.04 LTS lub Ubuntu 20.04 LTS. Obsługiwane są tylko procesory zgodne z procesorem Intel x86-64; inne architektury, takie jak ARM (w tym Raspberry Pi), Itanium lub SPARC nie są obsługiwane. Architektura x86-64 jest również znana jako x64, x86_64, AMD64 i Intel 64.
Uprawnienia systemu Linux sudo .
Połączenie internetowe lub sposób przesyłania plików z komputera z połączeniem internetowym do komputera. Aby uzyskać więcej informacji, zobacz Instalowanie zestawie SDK bez połączenia internetowego.

Dodawanie wymaganych pakietów systemu Linux

Przed uruchomieniem skryptu instalacji zestawu SDK należy dodać do komputera wymagane pakiety systemu Linux, jeśli nie zostały jeszcze zainstalowane. Wprowadź następujące wiersze w terminalu systemu Linux. Możesz pominąć pakiety, które są już zainstalowane.

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

Instalowanie pakietu Azure Sphere SDK

Wykonaj następujące czynności:

Pobierz skrypt instalacji.
Przejdź do folderu, do którego pobrano skompresowany plik.
Wyodrębnij zawartość skompresowanego pliku. Na przykład tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Plik .tar.gz zawiera plik install_azure_sphere_sdk.sh.
Uruchom skrypt instalacji w sudo następujący sposób:
```
sudo ./install_azure_sphere_sdk.sh
```
Jeśli podczas uruchamiania skryptu zostanie wyświetlony komunikat o błędzie command not found , włącz wykonywanie skryptu instalacji za pomocą tego polecenia:
```
chmod +x install_azure_sphere_sdk.sh
```

Podczas instalacji skrypt wyświetla komunikaty potwierdzenia. Komunikaty potwierdzające można pominąć, wywołując skrypt z flagą -y :

sudo ./install_azure_sphere_sdk.sh -y

-y Bez flagi skrypt będzie oczekiwać odpowiedzi na następujące monity:

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)

Przejdź do witryny firmy Microsoft z publicznymi odciskami palców i sprawdź, czy szesnastkowa wartość linii papilarnych wyświetlana podczas instalacji jest zgodna z publicznym odciskiem palca firmy Microsoft wyświetlanym na stronie. Nie kontynuuj, jeśli dwa linie papilarne nie są zgodne.

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)

Wybierz, Y aby ustawić cli azure sphere jako domyślny cli lub N ustawić Azure Sphere klasyczny cli jako domyślny cli.

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)

Wybierz, Y aby skonfigurować grupę azsphere i utworzyć regułę wydechu.

Po zakończeniu instalacji musisz zalogować się ponownie w aplikacji klasycznej lub powłoce logowania, aby zainicjować środowisko platformy Azure Sphere (Starsza wersja).

Po zakończeniu instalacji polecenie azsphere znajduje się na ścieżce, a nowe reguły udev dla twojego urządzenia znajdują się na stronie /etc/udev/rules.d/.

Skrypt instaluje zestaw SDK na /opt/azurespheresdk i toolchains na /opt/azurespheresdk/Sysroots/sysroot-version/tools, gdzie wersja sysroot identyfikuje sysroot , przeciwko któremu zestaw SDK obsługuje tworzenie aplikacji.

Instalator instaluje wersje interfejsu cli platformy Azure Sphere (Starsze) interfejsu cli. Nie musisz odinstalowywać bieżącej wersji, ponieważ instalacja zaktualizuje wszystkie istniejące wersje. Azure Sphere (Legacy) CLI jest instalowany w /opt/azurespheresdk/Tools_v2 a azure Sphere (Starsza) klasyczna platforma CLI jest zainstalowana w /opt/azurespheresdk/Tools.

W systemie Linux możesz uruchomić platformę Azure Sphere (Starsza wersja) cli z terminalu przy użyciu azsphere_v2 i azsphere jeśli został wybrany jako domyślny interfejs cli podczas instalacji.

Po zainstalowaniu cli po raz pierwszy, sprawdź, czy jest zainstalowany i masz poprawną wersję, uruchamiając azsphere show-version.

Reguły Udev

Azure Sphere SDK określa reguły udev dla informacji o urządzeniu komputera. W zestawie SDK zostanie utworzona nowa grupa o nazwie azsphere i doda do niej obecnie zalogowanego użytkownika. Reguła udev zapewnia własność urządzeń USB zgodnych z opisem urządzenia Azure Sphere. Po zainstalowaniu klawiatury SDK i ponownym uruchomieniu komputera nie trzeba używać sudo do odzyskiwania urządzenia ani debugowania ARM Cortex-M4.

Grupa azsphere zostanie dodana w celu udzielenia uprawnień przy użyciu reguły udev . Nie modyfikuj grupy ręcznie.

Instalowanie zestawie SDK bez połączenia internetowego

Jeśli nie masz połączenia internetowego na komputerze, na którym instalujesz pakiet SDK, musisz pobrać pliki na komputer, który jest połączony z Internetem, i przenieść je na komputer instalacyjny.

Pobierz te pliki i przenieś je na komputer instalacyjny:
- Azure Sphere SDK dla systemu Linux: do wyboru jest Ubuntu 24.04 (wersja wstępna) lub Ubuntu 22.04 LTS lub Ubuntu 20.04 LTS.
  
  Pobrany plik to skompresowany plik smoły (plik .tar.gz ) o nazwie początkowej Azure_Sphere_SDK_Bundle.
- Skrypt instalacji: jest to skompresowany plik smoły (plik .tar.gz ) z nazwą rozpoczynającą się install_azure_sphere_sdk.
- Klucz publiczny gpg firmy Microsoft: jest to plik tekstowy ASCII.
Na komputerze instalacyjnym przejdź do folderu, do którego przeniesiono pliki.
Wyodrębnij zawartość pliku skryptu instalacji skompresowanej. Na przykład tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Plik .tar.gz zawiera plik install_azure_sphere_sdk.sh. Pozostaw pakiet SDK Azure Sphere jako plik skompresowanej smoły (plik tar.gz ).
Uruchom skrypt instalacji przy użyciu .sudo -i Uwzględnij parametr określający ścieżkę do pakietu SDK i -k parametr określający ścieżkę klucza. Polecenie powinno być podobne do następującego:

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

Jeśli podczas uruchamiania skryptu zostanie wyświetlony komunikat o błędzie command not found , włącz wykonywanie skryptu instalacji za pomocą tego polecenia:
```
chmod +x install_azure_sphere_sdk.sh
```

Kontynuuj instalację zgodnie z opisem w artykule Instalowanie narzędzia Azure Sphere SDK.

Instalowanie rozszerzenia Azure Sphere dla platformy Azure CLI

Narzędzie wiersza polecenia do zarządzania urządzeniami dołączonymi do usługi Azure Sphere i wdrożeniami w chmurze jest dystrybuowane jako rozszerzenie Azure CLI. Aby dodać lub zaktualizować rozszerzenie, wykonaj następujące czynności:

Zainstaluj platformę Azure CLI , jeśli jeszcze tego nie zrobiono.

Aby dodać rozszerzenie Azure Sphere, uruchom następujące polecenie:
```
az extension add --name azure-sphere
```
Aby zaktualizować rozszerzenie Azure Sphere, uruchom następujące polecenie:
```
az extension udpate --name azure-sphere
```

Musisz zalogować się za pomocą platformy Azure CLI , aby zalogować się do subskrypcji Azure, za pomocą której chcesz zarządzać urządzeniami Usługi Azure Sphere.

Aby uzyskać więcej informacji, zobacz Pobieranie i uruchamianie rozszerzenia Azure Sphere.

Konfigurowanie środowiska programistyczne

Aplikacje Azure Sphere można tworzyć w systemie Linux przy użyciu Visual Studio Code lub interfejsu wiersza polecenia (CLI). Bez względu na to, którego z nich używasz, musisz zainstalować CMake i Ninja na komputerze deweloperskim, jeśli jeszcze ich nie masz. Zapoznaj się z instrukcjami dotyczącymi dodawania repozytorium APT Kitware do instalacji.

Zainstaluj CMake i Ninja

Aby zainstalować CMake i Ninja, najpierw zapoznaj się z instrukcjami dotyczącymi dodawania repozytorium APT Kitware do instalacji, a następnie użyj następującego polecenia:

sudo apt-get install cmake ninja-build

Uwaga

Nie instaluj polecenia cmake ani ninja za pomocą przyciągania.

Instalowanie rozszerzenia Azure Sphere dla Visual Studio Code

Jeśli chcesz używać Visual Studio Code jako środowiska programistyczne, musisz go zainstalować i rozszerzenie Azure Sphere.

Użyj linków w Visual Studio Code pobierania, aby zainstalować Visual Studio Code, jeśli jeszcze tego nie zrobiono.
Aby zainstalować rozszerzenie Azure Sphere, wyszukaj frazę "Azure Sphere" w witrynie Extension Marketplace w przeglądarce lub w obrębie Visual Studio Code. Powinny zostać wyświetlone dwa wyniki: Interfejs użytkownika usługi Azure Sphere i Azure Sphere. Wybierz pozycję Zainstaluj dla jednego z nich; drugi powinien zostać zainstalowany automatycznie.
Po zakończeniu instalacji w okienku WŁĄCZONE rozszerzenia w Visual Studio Code IDE powinny być widoczne rozszerzenia Azure Sphere, C/C++i CMake Tools.

Po zakończeniu instalacji zostanie otwarta strona Readme rozszerzenia. Strona Readme zawiera przydatne informacje na temat konfiguracji Visual Studio Code i wymagań oraz jest aktualizowana wraz z rozszerzeniem. Stronę Readme możesz wyświetlić w dowolnym momencie, otwierając okienko Rozszerzenia i wybierając pozycję Azure Sphere.

Następne kroki

Zdejmij swoje urządzenie