Szybki start: instalowanie zestawu Azure Sphere SDK dla systemu Linux

Zestaw SDK usługi Azure Sphere można zainstalować na komputerze z systemem operacyjnym Linux, aby opracowywać, wdrażać i debugować aplikacje usługi Azure Sphere.

Wymagania wstępne

Instalacja zestawu SDK usługi Azure Sphere wymaga następujących wymagań wstępnych:

Zestaw deweloperów usługi Azure Sphere.
Komputer z procesorem opartym na architekturze x86-64 z 64-bitowym systemem Ubuntu 24.04 LTS lub Ubuntu 22.04 LTS. Obsługiwane są tylko procesory Intel zgodne z procesorami 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, który ma połączenie internetowe z komputerem. Aby uzyskać więcej informacji, zobacz Instalowanie zestawu SDK bez połączenia internetowego.

Dodawanie wymaganych pakietów systemu Linux

Przed uruchomieniem skryptu instalacji zestawu SDK należy dodać wymagane pakiety systemu Linux na komputerze, 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

Instalacja zestawu Azure Sphere SDK

Wykonaj te kroki:

Pobierz skrypt instalacji.
Przejdź do folderu, w którym 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 błąd 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 potwierdzające. Komunikaty potwierdzające można pominąć, wywołując skrypt z flagą -y :

sudo ./install_azure_sphere_sdk.sh -y

Bez flagi -y 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)

Wybierz Y, aby rozpocząć instalację.

Przejdź do witryny odcisku palca klucza publicznego firmy Microsoft i sprawdź, czy wartość odcisku palca szesnastkowego wyświetlana podczas instalacji jest zgodna z odciskiem palca klucza publicznego firmy Microsoft wyświetlanym na stronie. Nie należy kontynuować, jeśli dwa odciski palców nie są zgodne.

By proceeding with this installation you agree to the license terms available at https://aka.ms/AzureSphereSDKLicense/Linux and which will be installed to /opt/azurespheresdk. Proceed? (Y/N) y
Uninstalling previous instance.
Installing SDK files.
Installing toolchain version 'xx'.
Installing toolchain version 'xx'.
Installing toolchain version 'xx'.
Installing toolchain version 'xx+Betaxxxx'.
Installing CLI.
SDK installed to '/opt/azurespheresdk'.
Installing Device Communication service.
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 (xxx) to it? (Y/N) y
Add the Azure Sphere CLI to the PATH for all users (this will add a file to /etc/profile.d/)? (Y/N) y
Azure Sphere CLI added to PATH for all users. You will need to restart your user session for this change to take effect.
Azure Sphere SDK installation complete. Visit https://aka.ms/AzureSphereSDK for documentation and samples.

Wskazówka

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

Po zakończeniu instalacji musisz zalogować się ponownie do aplikacji klasycznej lub powłoki logowania, aby zainicjować interfejs wiersza polecenia usługi Azure Sphere (starsza wersja).

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

Skrypt instaluje zestaw SDK do katalogu /opt/azurespheresdk i łańcuchów narzędzi do katalogu /opt/azurespheresdk/Sysroots/sysroot-version/tools, gdzie sysroot-version identyfikuje katalog sysroot, względem którego zestaw SDK obsługuje tworzenie aplikacji.

Instalator instaluje Azure Sphere (Legacy) CLI. Nie musisz odinstalować bieżącej wersji, ponieważ instalacja zaktualizuje istniejącą wersję.

Interfejs CLI Azure Sphere (legacy) jest zainstalowany w katalogu /opt/azurespheresdk/Tools_v2.

Reguły udev

Zestaw SDK usługi Azure Sphere określa udev reguły informacji o urządzeniu komputera. Zestaw SDK tworzy nową grupę o nazwie azsphere i dodaje aktualnie zalogowanego użytkownika do grupy. Reguła udev przyznaje własność urządzeń USB pasujących do opisu urządzenia usługi Azure Sphere. Po zainstalowaniu zestawu SDK i ponownym uruchomieniu komputera nie trzeba używać sudo do odzyskiwania urządzenia ani debugowania usługi ARM Cortex-M4.

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

Instalowanie zestawu SDK bez połączenia internetowego

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

Pobierz te pliki i przenieś je na komputer instalacyjny:
- Zestaw SDK usługi Azure Sphere dla systemu Linux: wybierz jedną z wersji Ubuntu 24.04 LTS lub Ubuntu 22.04 LTS.
  
  Pobrany plik jest skompresowanym plikiem tar (.tar.gz ) o nazwie rozpoczynającej się Azure_Sphere_SDK_Bundle.
- Skrypt instalacji: jest to skompresowany plik tar (plik .tar.gz ) o nazwie rozpoczynającej się install_azure_sphere_sdk.
- Klucz publiczny GPG firmy Microsoft: jest to plik tekstowy ASCII.
Na komputerze instalacyjnym przejdź do folderu, do którego zostały przeniesione pliki.
Wyodrębnij zawartość skompresowanego pliku skryptu instalacji. Na przykład tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Plik .tar.gz zawiera plik install_azure_sphere_sdk.sh. Pozostaw pakiet zestawu SDK usługi Azure Sphere jako skompresowany plik tar (tar.gz pliku).
Uruchom skrypt instalacji przy użyciu polecenia sudo. Dołącz parametr , -i aby określić ścieżkę do pakietu ZESTAWU SDK i parametr w -k celu określenia ścieżki do 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 błąd 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 temacie Instalowanie zestawu Azure Sphere SDK.

Instalowanie rozszerzenia usługi Azure Sphere dla interfejsu wiersza polecenia platformy Azure

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 interfejsu wiersza polecenia platformy Azure. Wykonaj następujące kroki, aby dodać lub zaktualizować rozszerzenie:

Zainstaluj interfejs wiersza polecenia platformy Azure, jeśli jeszcze tego nie zrobiono.

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

Aby zalogować się do subskrypcji platformy Azure, której chcesz użyć do zarządzania urządzeniami usługi Azure Sphere, musisz zalogować się przy użyciu interfejsu wiersza polecenia platformy Azure.

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

Konfigurowanie środowiska projektowego

Aplikacje usługi Azure Sphere można tworzyć w systemie Linux przy użyciu programu Visual Studio Code lub interfejsu wiersza polecenia (CLI). Niezależnie od tego, którego używasz, musisz zainstalować narzędzia CMake i Ninja na maszynie deweloperów, jeśli jeszcze ich nie masz. Zapoznaj się z instrukcjami dotyczącymi dodawania repozytorium APT kitware do instalacji.

Instalowanie narzędzia CMake i ninja

Aby zainstalować narzędzia 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 narzędzia cmake ani ninja za pomocą przystawki.

Instalowanie rozszerzenia usługi Azure Sphere dla programu Visual Studio Code

Jeśli chcesz użyć programu Visual Studio Code jako środowiska programistycznego, musisz go zainstalować i rozszerzenie usługi Azure Sphere.

Użyj linków w sekcji Pobierz program Visual Studio Code, aby zainstalować program Visual Studio Code , jeśli jeszcze tego nie zrobiono.
Aby zainstalować rozszerzenie usługi Azure Sphere, wyszukaj ciąg "Azure Sphere" w witrynie Marketplace rozszerzeń z przeglądarki lub w programie Visual Studio Code. Powinny zostać wyświetlone dwa wyniki: Azure Sphere i Azure Sphere UI. Wybierz pozycję Zainstaluj dla jednej z nich. Druga powinna zostać zainstalowana automatycznie.
Po zakończeniu instalacji w okienku Rozszerzenia ENABLED w środowisku IDE programu Visual Studio Code 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 o konfiguracji i wymaganiach programu Visual Studio Code oraz jest aktualizowana wraz z rozszerzeniem. Stronę Readme można wyświetlić w dowolnym momencie, otwierając okienko Rozszerzenia i wybierając pozycję Azure Sphere.

Następne kroki

Przejmowanie urządzenia