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

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

Необходимые условия

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

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

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

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

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

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

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

1. Скачайте скрипт установки.

2. Перейдите в папку, в которую вы скачали сжатый файл.

3. Извлеките содержимое сжатого файла. Например, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Файл .tar.gz содержит файл install_azure_sphere_sdk.sh.

4. Запустите сценарий установки следующим sudo образом:

   sudo ./install_azure_sphere_sdk.sh
   

   Если при выполнении скрипта появляется ошибка command not found , включите выполнение скрипта установки с помощью следующей команды:

   chmod +x install_azure_sphere_sdk.sh
   

5. Во время установки скрипт отображает сообщения подтверждения. Сообщения подтверждения можно пропустить, вызвав скрипт с флагом -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)
   

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

   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)
   
   

   Выберите Y , чтобы задать Azure Sphere CLI в качестве интерфейса командной строки по умолчанию или N классический интерфейс командной строки Azure Sphere в качестве интерфейса командной строки по умолчанию.

   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)
   
   

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

6. После завершения установки необходимо снова войти в классическое приложение или оболочку входа, чтобы инициализировать интерфейс командной строки 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, а классический интерфейс командной строки Azure Sphere (устаревшая версия) устанавливается в /opt/azurespheresdk/Tools.

В Linux вы можете запустить Azure Sphere (устаревшая версия) CLI из терминала, используя azsphere_v2 и azsphere , если он был выбран в качестве интерфейса командной строки по умолчанию во время установки.

После первой установки интерфейса командной строки проверка, что он установлен, и вы получите правильную версию, запустив azsphere show-version.

Правила Udev

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

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

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

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

1. Скачайте эти файлы и перенесите их на компьютер установки:

   • Пакет SDK Azure Sphere для Linux: выберите Ubuntu 24.04 (предварительная версия) или Ubuntu 22.04 LTS или Ubuntu 20.04 LTS.

     Скачанный файл представляет собой сжатый tar-файл (.tar.gz файл) с именем, начинающийся Azure_Sphere_SDK_Bundle.

   • Скрипт установки: это сжатый tar-файл (.tar.gz файл) с именем, начинающийся install_azure_sphere_sdk.

   • Открытый ключ GPG корпорации Майкрософт: это текстовый файл ASCII.

2. На компьютере установки перейдите в папку, в которую были перенесены файлы.

3. Извлеките содержимое сжатого файла скрипта установки. Например, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Файл .tar.gz содержит файл install_azure_sphere_sdk.sh. Оставьте пакет SDK Для Azure Sphere как сжатый tar-файл (tar.gz файл).

4. Запустите сценарий установки с помощью 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. Чтобы добавить или обновить расширение, сделайте следующее:

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

• Чтобы добавить расширение Azure Sphere, выполните следующую команду:

  az extension add --name azure-sphere
  

• Чтобы обновить расширение Azure Sphere, выполните следующую команду:

  az extension udpate --name azure-sphere
  

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

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

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

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

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

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

sudo apt-get install cmake ninja-build

Примечание

Не устанавливайте cmake или ninja с помощью snap.

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

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

1. Если вы еще этого не сделали, воспользуйтесь ссылками в разделе Скачать Visual Studio Code, чтобы установить Visual Studio Code.

2. Чтобы установить расширение Azure Sphere, найдите "Azure Sphere" в Extension Marketplace в браузере или в Visual Studio Code. Вы должны увидеть два результата: Azure Sphere и пользовательский интерфейс Azure Sphere. Выберите Установить для любого из них. другой должен быть установлен автоматически.

3. После установки вы должны увидеть расширения Azure Sphere, C/C++ и CMake Tools в области Включено расширения в интегрированной среде разработки Visual Studio Code.

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

Дальнейшие действия

Утверждение устройства

Примечание

Не устанавливайте cmake или ninja с помощью snap.