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

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 LTS o Ubuntu 22.04 LTS de 64 bits. 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)

Seleccione Y para iniciar la instalació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.

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.

Sugerencia

Seleccione Y 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 de Azure Sphere (heredado).

Después de la instalación, el azsphere comando 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 (heredado). 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.

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 una conexión a Internet en el equipo en el que va a instalar el SDK, debe descargar los 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 LTS o Ubuntu 22.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.

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

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

Instale la CLI de Azure si aún no lo ha hecho.

Para agregar la extensión de Azure Sphere, ejecute el siguiente comando:
```
az extension add --name azure-sphere
```
Para actualizar la extensión de Azure Sphere, ejecute el siguiente comando:
```
az extension update --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 de Azure Sphere.

Para más información, consulte Descarga y ejecución de la extensión 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