Краткое руководство. Установка пакета SDK Azure Sphere для Linux

Статья
03/01/2025

Пакет SDK для Azure Sphere можно установить на компьютере под управлением операционной системы Linux для разработки, развертывания и отладки приложений Azure Sphere.

Необходимые компоненты

Для установки пакета SDK Azure Sphere требуются следующие компоненты.

Пакет средств разработки Azure Sphere.
Компьютер с процессором на основе x86-64 с 64-разрядной версией Ubuntu 24.04 LTS, Ubuntu 22.04 LTS или Ubuntu 20.04 LTS. Поддерживаются только процессоры, совместимые с Intel x86-64; другие архитектуры, такие как ARM (включая Raspberry Pi), Itanium или SPARC, не поддерживаются. Архитектура x86-64 также называется x64, x86_64, AMD64 и Intel 64.
Разрешение sudo Linux.
Подключение к Интернету или способ передачи файлов с компьютера, подключенного к Интернету, на ваш компьютер. Дополнительные сведения см. в статье об установке пакета SDK без подключения к Интернету.

Добавление необходимых пакетов Linux

Перед запуском сценария установки пакета SDK необходимо добавить необходимые пакеты Linux на компьютер, если они еще не установлены. Введите следующие строки в терминале Linux. Уже установленные пакеты можно опустить.

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

Установка пакета SDK для Azure Sphere

Выполните следующие действия:

Скачайте скрипт установки.
Перейдите в папку, в которую вы скачали сжатый файл.
Извлеките содержимое сжатого файла. Например, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Файл .tar.gz содержит файл install_azure_sphere_sdk.sh .
Запустите скрипт sudo установки следующим образом:
```
sudo ./install_azure_sphere_sdk.sh
```
Если при запуске скрипта возникает ошибка command not found , включите выполнение скрипта установки с помощью следующей команды:
```
chmod +x install_azure_sphere_sdk.sh
```

Во время установки скрипт отображает сообщения подтверждения. Сообщения подтверждения можно пропустить, вызвав скрипт с флагом -y :

sudo ./install_azure_sphere_sdk.sh -y

Без флага -y скрипт ожидает ответы на следующие запросы:

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)

Выберите Y, чтобы начать установку.

Перейдите на общедоступный отпечаток ключа сайт Корпорации Майкрософт и убедитесь, что шестнадцатеричное значение отпечатка пальца, отображаемое во время установки, соответствует отпечатку открытого ключа Майкрософт, который отображается на странице. Если отпечатки не совпадают, не продолжайте процедуру.

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.

Совет

Выберите Y, чтобы настроить группу azsphere и создать правило udev.

По завершении установки необходимо снова войти в классическое приложение или оболочку входа, чтобы инициализировать интерфейс командной строки Azure Sphere (устаревшая версия).

После установки команда azsphere находится в PATH, а новые правила udev для устройства находятся в /etc/udev/rules.d/.

Скрипт устанавливает пакет SDK в каталог /opt/azurespheresdk, а цепочки инструментов в каталог /opt/azurespheresdk/Sysroots/sysroot-version/tools, где sysroot-version определяет sysroot, для которого пакет SDK поддерживает разработку приложений.

Установщик устанавливает интерфейс командной строки Azure Sphere (устаревшая версия). Не нужно удалять текущую версию, так как установка обновит существующую версию.

Интерфейс командной строки Azure Sphere (устаревшая версия) устанавливается в /opt/azurespheresdk/Tools_v2.

Правила Udev

В пакете SDK Azure Sphere указаны правила udev для сведений об устройстве компьютера. Пакет SDK создает группу с именем azsphere и добавляет в нее текущего пользователя, выполнившего вход в систему. Правило udev предоставляет право собственности USB-устройств, соответствующих описанию устройства Azure Sphere. После установки пакета SDK и перезагрузки компьютера вам не потребуется использовать sudo для восстановления устройства или отладки ARM Cortex-M4.

Группа azsphere добавляется, чтобы предоставить разрешения с помощью правила udev. Не изменяйте группу вручную.

Установка пакета SDK без подключения к Интернету

Если у вас нет подключения к Интернету на компьютере, на котором устанавливается пакет SDK, необходимо скачать файлы на компьютер, подключенный к Интернету, и передать их на компьютер установки.

Скачайте эти файлы и перенесите их на компьютер установки:
- Пакет SDK Azure Sphere для Linux: выберите Ubuntu 24.04 LTS или Ubuntu 22.04 LTS или Ubuntu 20.04 LTS.
  
  Скачанный файл — это сжатый tar-файл (.tar.gz файл) с именем, начинающийся Azure_Sphere_SDK_Bundle.
- Сценарий установки: это сжатый tar-файл (.tar.gz файл) с именем, начинающийся install_azure_sphere_sdk.
- Открытый ключ групповой политики Майкрософт: это текстовый файл ASCII.
На компьютере установки перейдите в папку, в которую вы передали файлы.
Извлеките содержимое сжатого файла скрипта установки. Например, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Файл .tar.gz содержит файл install_azure_sphere_sdk.sh . Оставьте пакет SDK Azure Sphere в виде сжатого tar-файла (tar.gz файла).
Запустите скрипт установки с помощью sudo. -i Включите параметр, чтобы указать путь к пакету SDK и -k параметру, чтобы указать путь к ключу. Команда должна выглядеть следующим образом:

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

Если при запуске скрипта возникает ошибка command not found , включите выполнение скрипта установки с помощью следующей команды:
```
chmod +x install_azure_sphere_sdk.sh
```

Перейдите к установке, как описано в разделе "Установка пакета SDK Azure Sphere".

Установка расширения Azure Sphere для Azure CLI

Средство командной строки для управления подключенными устройствами Azure Sphere и облачными развертываниями распространяется как расширение Azure CLI. Чтобы добавить или обновить расширение, сделайте следующее:

Установите Azure CLI , если вы еще не сделали этого.

Чтобы добавить расширение Azure Sphere, выполните следующую команду:
```
az extension add --name azure-sphere
```
Чтобы обновить расширение Azure Sphere, выполните следующую команду:
```
az extension update --name azure-sphere
```

Чтобы войти в подписку Azure, необходимо войти в подписку Azure, которую вы хотите использовать для управления устройствами Azure Sphere.

Дополнительные сведения см. в разделе "Скачать и запустить расширение Azure Sphere".

Настройка среды разработки

Вы можете разрабатывать приложения для Azure Sphere в Linux с помощью Visual Studio Code или интерфейса командной строки (CLI). Независимо от используемого способа, вам потребуется установить CMake и Ninja на компьютере разработки, если у вас их еще нет. Инструкции по добавлению репозитория APT Kitware в установку.

Установка CMake и Ninja

Чтобы установить CMake и Ninja, сначала ознакомьтесь с инструкциями по добавлению репозитория APT Kitware APT в установку, а затем выполните следующую команду:

sudo apt-get install cmake ninja-build

Примечание.

Не устанавливайте CMake или Ninja с помощью команды Snap.

Установка расширения Azure Sphere для Visual Studio Code

Если вы хотите использовать Visual Studio Code в качестве среды разработки, необходимо установить его и расширение Azure Sphere.

Используйте ссылки в разделе "Скачать Visual Studio Code", чтобы установить Visual Studio Code , если вы еще этого не сделали.
Чтобы установить расширение Azure Sphere, найдите "Azure Sphere" в Extension Marketplace из браузера или Visual Studio Code. Вы увидите два результата: пользовательский интерфейс Azure Sphere и Azure Sphere. Выберите " Установить " для одного из них; другой должен быть установлен автоматически.
После установки вы увидите Azure Sphere, C/C++ и расширения CMake Tools в области "Включенные расширения" в интегрированной среде разработки Visual Studio Code.

После завершения установки откроется страница Readme расширения. Страница Readme содержит полезные сведения о конфигурации и требованиях Visual Studio Code и обновляется вместе с расширением. Вы можете просматривать страницу readme в любое время, открыв панель расширений и выбрав Azure Sphere.

Следующие шаги

Утвердите устройство.