Inicio rápido: Instalar el SDK de Azure Sphere para Linux

Artículo
03/27/2024

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

Requisitos previos

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

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

Agregar paquetes de Linux necesarios

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

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

Instalar el SDK de Azure Sphere

Sigue 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 de install_azure_sphere_sdk.sh.
Ejecute el script de instalación de sudo la siguiente manera:
```
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 los siguientes avisos:

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)

Ve al sitio de huellas digitales de clave pública de Microsoft y comprueba 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. No continúes si las dos huellas digitales no coinciden.

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 su CLI predeterminada o N para establecer la CLI clásica de Azure Sphere como su 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 volver a iniciar sesión en la aplicación de escritorio o shell de inicio de sesión para inicializar la CLI de Azure Sphere (heredada).

Después de la instalación, el comando azsphere está en la ruta de acceso y las nuevas reglas de udev para su dispositivo se encuentran en /etc/udev/rules.d/.

El script instala el SDK en /opt/azurespheresdk y los toolchains en /opt/azurespheresdk/Sysroots/sysroot-version/tools, donde sysroot-version identifica una sysroot con la que el SDK admite el desarrollo de aplicaciones.

El instalador instala las versiones de la CLI de Azure Sphere (heredada) 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 (heredada) se instala en /opt/azurespheresdk/Tools_v2 y la CLI clásica de Azure Sphere (heredada) está instalada en /opt/azurespheresdk/Tools.

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

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

Reglas de Udev

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

El azsphere grupo se agrega para conceder permisos mediante la udev regla. No modifique el grupo manualmente.

Instalar el SDK sin conexión a Internet

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

Descarga estos archivos y transfórgalos al equipo de instalación:
- Azure Sphere SDK para Linux: elige entre Ubuntu 24.04 (versión preliminar) o Ubuntu 22.04 LTS o Ubuntu 20.04 LTS.
  
  El archivo descargado es un archivo tar comprimido (archivo .tar.gz ) con un nombre que comienza Azure_Sphere_SDK_Bundle.
- Script de instalación: se trata de un archivo tar comprimido (archivo .tar.gz ) 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 a la que transfirieron 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 de install_azure_sphere_sdk.sh. Deje el paquete azure sphere SDK como un archivo tar comprimido (tar.gz archivo).
Ejecute el script de instalación con sudo. Incluye el -i parámetro para especificar la ruta de acceso al paquete SDK y el -k parámetro para especificar la ruta de acceso a la clave. El comando debe ser similar a este:

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 y como se describe en Instalar el SDK de Azure Sphere.

Instalar la extensión Azure Sphere para la CLI de Azure

La herramienta de línea de comandos para administrar los dispositivos adjuntos de Azure Sphere y las implementaciones en la nube se distribuye como una extensión de la CLI de Azure. Sigue estos pasos para agregar o actualizar la extensión:

Si aún no lo ha hecho, instale la CLI de Azure.

Para agregar la extensión Azure Sphere, ejecute el siguiente comando:
```
az extension add --name azure-sphere
```
Para actualizar la extensión Azure Sphere, ejecute el siguiente comando:
```
az extension udpate --name azure-sphere
```

Debe iniciar sesión con la CLI de Azure para iniciar sesión en la suscripción de Azure que desea usar para administrar dispositivos Azure Sphere.

Para obtener más información, consulte Descargar y ejecutar la extensión Azure Sphere.

Configurar el entorno de desarrollo

Puede desarrollar aplicaciones Azure Sphere en Linux mediante Visual Studio Code o la interfaz de línea de comandos (CLI). No importa lo que uses, tendrás que instalar CMake y Ninja en tu máquina de desarrollo, si aún no los tienes. Consulte las instrucciones para agregar el repositorio de APT de Kitware a su instalación.

Instalar CMake y Ninja

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

sudo apt-get install cmake ninja-build

Nota

No instales cmake o ninja usando snap.

Instalar la extensión Azure Sphere para Visual Studio Code

Si desea usar Visual Studio Code como su entorno de desarrollo, debe instalarlo y Azure Sphere Extension.

Si aún no lo ha hecho, use los vínculos de Descargar Visual Studio Code para instalar Visual Studio Code.
Para instalar la extensión Azure Sphere, busque "Azure Sphere" en el Catálogo de extensiones desde un explorador o dentro de Visual Studio Code. Verá dos resultados: Azure Sphere y Azure Sphere UI. Selecciona Instalar para cualquiera de los dos; la otra debería instalarse automáticamente.
Después de la instalación, debería ver las extensiones Azure Sphere, C/C++, y CMake Tools en el panel Extensiones HABILITADAs del IDE de Visual Studio Code.

Cuando se complete la instalación, se abrirá la página Léame de la extensión. La página Léame proporciona información útil sobre Visual Studio Code configuración y los requisitos, 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

Reclama tu dispositivo