Inicio rápido: Instalación del SDK de Azure Sphere para Linux

Artículo
09/27/2024

Importante

Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).

Puede instalar el SDK de Azure Sphere en un equipo que ejecuta el sistema operativo Linux para desarrollar, implementar y depurar aplicaciones de Azure Sphere.

Requisitos previos

La instalación del SDK de Azure Sphere tiene los siguientes requisitos previos:

Un kit de desarrollo de Azure Sphere.
Un equipo con un procesador basado en x86-64 que ejecuta Ubuntu 24.04 de 64 bits (versión preliminar), Ubuntu 22.04 LTS o Ubuntu 20.04 LTS. Solo se admiten procesadores x86-64 compatibles con Intel; No se admiten otras arquitecturas como ARM (incluido Raspberry Pi), Itanium o SPARC. La arquitectura x86-64 también se conoce como x64, x86_64, AMD64 e Intel 64.
Permiso sudo de Linux.
Una conexión a Internet o una manera de transferir archivos desde un equipo que tenga una conexión a Internet a su equipo. Para más información, consulte Instalación del SDK sin conexión a Internet.

Incorporación de los paquetes de Linux requeridos

Antes de ejecutar el script de instalación del SDK, debe agregar los paquetes de Linux requeridos al equipo si aún no están instalados. Escriba las líneas siguientes en un terminal de Linux. Puede omitir los paquetes que ya estén instalados.

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

Instalación del SDK de Azure Sphere

Siga estos pasos:

Descargue el script de instalación.
Vaya a la carpeta en la que descargó el archivo comprimido.
Extraiga el contenido del archivo comprimido. Por ejemplo, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. El archivo .tar.gz contiene el archivo install_azure_sphere_sdk.sh.
Ejecute el script de instalación mediante sudo lo siguiente:
```
sudo ./install_azure_sphere_sdk.sh
```
Si ve el error command not found al ejecutar el script, habilite la ejecución del script de instalación con este comando:
```
chmod +x install_azure_sphere_sdk.sh
```

Durante la instalación, el script muestra mensajes de confirmación. Los mensajes de confirmación se pueden omitir invocando el script con la -y marca :

sudo ./install_azure_sphere_sdk.sh -y

Sin la -y marca , el script esperará respuestas a las siguientes indicaciones:

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)

Vaya al sitio de huellas digitales de clave pública de Microsoft y compruebe que el valor de huella digital hexadecimal que se muestra durante la instalación coincide con la huella digital de clave pública de Microsoft que se muestra en la página. Si las dos huellas digitales no coinciden, no continúe.

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)

Seleccione Y esta opción para establecer la CLI de Azure Sphere como la CLI predeterminada o N para establecer la CLI clásica de Azure Sphere como la CLI predeterminada.

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)

Seleccione Y esta opción para configurar el grupo azsphere y crear la regla udev.

Cuando se complete la instalación, debe iniciar sesión de nuevo en la aplicación de escritorio o el shell de inicio de sesión para inicializar la CLI.

Después de la instalación, el comando azsphere se encuentra en path y las nuevas reglas udev del dispositivo se encuentran en /etc/udev/rules.d/.

El script instala el SDK en /opt/azurespheresdk y las cadenas de herramientas en /opt/azurespheresdk/Sysroots/sysroot-version/tools, donde sysroot-version identifica una versión de sysroot en la que el SDK admite el desarrollo de aplicaciones.

El instalador instala la CLI de Azure Sphere y las versiones clásicas de la CLI de Azure Sphere de la CLI. No es necesario desinstalar la versión actual porque la instalación actualizará cualquier versión existente. La CLI de Azure Sphere se instala en /opt/azurespheresdk/Tools_v2 y la CLI clásica de Azure Sphere se instala en /opt/azurespheresdk/Tools.

En Linux, puede ejecutar la CLI de Azure Sphere desde un terminal mediante azsphere_v2 y azsphere si se seleccionó como la CLI predeterminada durante la instalación.

Después de instalar la CLI por primera vez, compruebe que está instalado y que tiene la versión correcta mediante la ejecución de azsphere show-version.

Reglas udev

El SDK de Azure Sphere especifica reglas de udev para la información del dispositivo del equipo. El SDK crea un nuevo grupo denominado azsphere y agrega al usuario que ha iniciado la sesión al grupo. La regla de udev concede la propiedad de los dispositivos USB que coinciden con la descripción del dispositivo de Azure Sphere. Después de instalar el SDK y reiniciar el equipo, no necesitará usar sudo para la recuperación del dispositivo ni para la depuración de ARM Cortex-M4.

Se agrega el grupo azsphere para conceder permisos con la regla udev. No modifique el grupo manualmente.

Instalación del SDK sin una conexión a Internet

Si no tiene conexión a Internet en el equipo en el que va a instalar el SDK, debe descargar estos archivos en un equipo conectado a Internet y transferirlos al equipo de instalación.

Descargue estos archivos y los transfiera al equipo de instalación:
- SDK de Azure Sphere para Linux: elija entre Ubuntu 24.04 (versión preliminar), Ubuntu 22.04 LTS o Ubuntu 20.04 LTS.
  
  El archivo descargado es un archivo tar comprimido (.tar.gz archivo) con un nombre que comienza Azure_Sphere_SDK_Bundle.
- Script de instalación: se trata de un archivo tar comprimido (.tar.gz archivo) con un nombre que comienza install_azure_sphere_sdk.
- Clave pública GPG de Microsoft: se trata de un archivo de texto ASCII.
En el equipo de instalación, vaya a la carpeta en la que transfirió los archivos.
Extraiga el contenido del archivo de script de instalación comprimido. Por ejemplo, tar xvfz install_azure_sphere_sdk_<version>.tar.gz. El archivo .tar.gz contiene el archivo install_azure_sphere_sdk.sh. Deje el paquete del SDK de Azure Sphere como un archivo tar comprimido (tar.gz archivo).
Ejecute el script de instalación mediante sudo. Incluya el -i parámetro para especificar la ruta de acceso a la agrupación del SDK y el -k parámetro para especificar la ruta de acceso a la clave. El comando debe ser similar al siguiente:

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

Si ve el error command not found al ejecutar el script, habilite la ejecución del script de instalación con este comando:
```
chmod +x install_azure_sphere_sdk.sh
```

Continúe con la instalación tal como se describe en Instalación del SDK de Azure Sphere.

Configurado su entorno de desarrollo

Puede desarrollar aplicaciones para Azure Sphere en Linux con Visual Studio Code o la interfaz de la línea de comandos (CLI). Con independencia de lo que use, deberá instalar CMake y Ninja en la máquina de desarrollo, si aún no los tiene. Consulte las instrucciones para agregar el repositorio APT de Kitware a la instalación.

Instalación de CMake y Ninja

Para instalar CMake y Ninja, consulte primero las instrucciones para agregar el repositorio APT de Kitware a la instalación y, a continuación, use el siguiente comando:

sudo apt-get install cmake ninja-build

Nota:

No instale Cmake ni Ninja con Snap.

Instalación de la extensión de Azure Sphere para Visual Studio Code

Si quiere usar Visual Studio Code como entorno de desarrollo, debe instalarlo y la extensión de Azure Sphere.

Use los vínculos de Descarga de Visual Studio Code para instalar Visual Studio Code, si aún no lo ha hecho.
Para instalar la extensión de Azure Sphere, busque "Azure Sphere" en El Marketplace de extensiones desde un explorador o en Visual Studio Code. Debería ver dos resultados, la interfaz de usuario de Azure Sphere y Azure Sphere. Seleccione Instalar para cualquiera de los dos; el otro debe instalarse automáticamente.
Después de la instalación, debería ver las extensiones Azure Sphere, C/C++ y Herramientas de CMake en el panel Extensiones habilitadas en el IDE de Visual Studio Code.

Una vez completada la instalación, se abrirá la página Léame de la extensión. La página Léame proporciona información útil sobre la configuración y los requisitos de Visual Studio Code y se actualiza junto con la extensión. Puede ver la página Léame en cualquier momento abriendo el panel Extensiones y seleccionando Azure Sphere.

Pasos siguientes

Reclame su dispositivo

Compartir vía