빠른 시작: Linux용 Azure Sphere SDK 설치

Linux 운영 체제를 실행하는 컴퓨터에 Azure Sphere SDK를 설치하여 Azure Sphere 애플리케이션을 개발, 배포 및 디버그할 수 있습니다.

필수 구성 요소

Azure Sphere SDK를 설치하려면 다음 필수 구성 요소가 필요합니다.

  • Azure Sphere 개발 키트.
  • 64비트 Ubuntu 24.04(시험판), Ubuntu 22.04 LTS 또는 Ubuntu 20.04 LTS를 실행하는 x86-64 기반 프로세서가 있는 컴퓨터입니다. Intel 호환 x86-64 프로세서만 지원됩니다. 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

Azure Sphere SDK 설치

같이:

  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)
    

    Microsoft의 공개 키 지문 사이트로 이동하여 설치 중에 표시되는 16진수 지문 값이 페이지에 표시된 Microsoft 공개 키 지문과 일치하는지 확인합니다. 두 지문이 일치하지 않으면 진행하지 마세요.

    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)
    
    

    Azure Sphere CLI를 기본 CLI로 설정하거나 N Azure Sphere 클래식 CLI를 기본 CLI로 설정하려면 선택합니다Y.

    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. 설치가 완료되면 데스크톱 애플리케이션 또는 로그인 셸에 다시 로그인하여 CLI를 초기화해야 합니다.

설치 후 azsphere 명령은 PATH에 있고 디바이스에 대한 새 udev 규칙은/etc/udev/rules.d/있습니다.

스크립트는 SDK를 /opt/azurespheresdk에 설치하고 도구 체인을 /opt/azurespheresdk/Sysroots/sysroot-version/tools에 설치합니다. 여기서 sysroot-version 은 SDK가 앱 개발을 지원하는 sysroot 를 식별합니다.

설치 관리자는 Azure Sphere CLIAzure Sphere 클래식 CLI 버전의 CLI를 모두 설치합니다. 설치 시 기존 버전이 업데이트되므로 현재 버전을 제거할 필요가 없습니다. Azure Sphere CLI는 /opt/azurespheresdk/Tools_v2 설치되고 Azure Sphere 클래식 CLI는 /opt/azurespheresdk/Tools에 설치됩니다.

Linux에서는 설치 중에 및 azsphere 를 사용하여 azsphere_v2 기본 CLI로 선택한 경우 터미널에서 Azure Sphere CLI를 실행할 수 있습니다.

CLI를 처음 설치한 후에는 CLI가 설치되었음을 검사 azsphere show-version을 실행하여 올바른 버전을 사용할 수 있습니다.

Udev 규칙

Azure Sphere SDK는 컴퓨터의 디바이스 정보에 대한 규칙을 지정합니다 udev . SDK는 라는 azsphere 새 그룹을 만들고 현재 로그인한 사용자를 그룹에 추가합니다. 규칙은 udev Azure Sphere 디바이스 설명과 일치하는 USB 디바이스의 소유권을 부여합니다. SDK를 설치하고 컴퓨터를 다시 부팅한 후에는 디바이스 복구 또는 ARM Cortex-M4 디버깅에 사용할 sudo 필요가 없습니다.

azsphere 규칙을 사용하여 udev 권한을 부여하기 위해 그룹이 추가됩니다. 그룹을 수동으로 수정하지 마세요.

인터넷 연결 없이 SDK 설치

SDK를 설치하는 컴퓨터에 인터넷 연결이 없는 경우 인터넷에 연결된 컴퓨터에 이러한 파일을 다운로드하여 설치 컴퓨터로 전송해야 합니다.

  1. 다음 파일을 다운로드하고 설치 컴퓨터로 전송합니다.

  2. 설치 컴퓨터에서 파일을 전송한 폴더로 이동합니다.

  3. 압축된 설치 스크립트 파일의 내용을 추출합니다. 예를 들어 입니다 tar xvfz install_azure_sphere_sdk_<version>.tar.gz. .tar.gz 파일에는 install_azure_sphere_sdk.sh 파일이 포함되어 있습니다. Azure Sphere SDK 번들을 압축된 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
    

Azure Sphere SDK 설치에 설명된 대로 설치를 진행합니다.

개발 환경 설정

Visual Studio Code 또는 CLI(명령줄 인터페이스)를 사용하여 Linux에서 Azure Sphere 앱을 개발할 수 있습니다. 어떤 것을 사용하든 개발 머신에 CMake 및 Ninja를 설치해야 합니다(아직 없는 경우). 설치에 Kitware APT 리포지토리를 추가하는 지침을 참조하세요.

CMake 및 Ninja 설치

CMake 및 Ninja를 설치하려면 먼저 설치에 Kitware APT 리포지토리 를 추가하는 지침을 참조한 다음, 다음 명령을 사용합니다.

sudo apt-get install cmake ninja-build

참고

스냅을 사용하여 cmake 또는 ninja를 설치하지 마세요.

Visual Studio Code 대한 Azure Sphere 확장 설치

개발 환경으로 Visual Studio Code 사용하려면 해당 환경과 Azure Sphere 확장을 설치해야 합니다.

  1. 아직 설치하지 않은 경우 Visual Studio Code 다운로드의 링크를 사용하여 Visual Studio Code 설치합니다.

  2. Azure Sphere 확장을 설치하려면 브라우저 또는 Visual Studio Code 내 확장 Marketplace에서 "Azure Sphere"를 검색합니다. Azure SphereAzure Sphere UI의 두 가지 결과가 표시됩니다. 설치를 선택합니다. 다른 은 자동으로 설치되어야 합니다.

  3. 설치 후 Visual Studio Code IDE의 ENABLED 확장 창에 Azure Sphere, C/C++, CMake Tools 확장이 표시됩니다.

설치가 완료되면 확장에 대한 추가 정보 페이지가 열립니다. 추가 정보 페이지는 Visual Studio Code 구성 및 요구 사항에 대한 유용한 정보를 제공하며 확장과 함께 업데이트됩니다. 확장 창을 열고 Azure Sphere를 선택하여 언제든지 추가 정보 페이지를 볼 수 있습니다.

다음 단계