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

아티클
10/17/2024

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 설치

다음 단계를 수행합니다.

설치 스크립트를 다운로드합니다.
압축된 파일을 다운로드한 폴더로 이동합니다.
압축된 파일의 내용을 추출합니다. 예들 들어 tar xvfz install_azure_sphere_sdk_<version>.tar.gz입니다. .tar.gz 파일에는 install_azure_sphere_sdk.sh 파일이 포함되어 있습니다.
다음과 같이 설치 스크립트를 sudo 실행합니다.
```
sudo ./install_azure_sphere_sdk.sh
```
스크립트를 실행할 때 오류가 command not found 표시되면 다음 명령을 사용하여 설치 스크립트 실행을 사용하도록 설정합니다.
```
chmod +x install_azure_sphere_sdk.sh
```

설치하는 동안 스크립트는 확인 메시지를 표시합니다. 플래그를 사용하여 스크립트 -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)

azsphere 그룹을 설정하고 udev 규칙을 만들려면 선택합니다Y.

설치가 완료되면 데스크톱 애플리케이션 또는 로그인 셸에 다시 로그인하여 Azure Sphere(레거시) CLI를 초기화해야 합니다.

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

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

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

Linux에서 설치하는 동안 기본 CLI로 선택된 경우 터미널 azsphere_v2 azsphere 에서 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를 설치하는 컴퓨터에 인터넷 연결이 없는 경우 인터넷에 연결된 컴퓨터에 파일을 다운로드하여 설치 컴퓨터로 전송해야 합니다.

다음 파일을 다운로드하여 설치 컴퓨터로 전송합니다.
- Linux용 Azure Sphere SDK: Ubuntu 24.04(시험판) 또는 Ubuntu 22.04 LTS 또는 Ubuntu 20.04 LTS 중에서 선택합니다.
  
  다운로드한 파일은 이름이 Azure_Sphere_SDK_Bundle 시작하는 압축된 tar 파일(.tar.gz 파일)입니다.
- 설치 스크립트: 이름이 install_azure_sphere_sdk 시작하는 압축된 tar 파일(.tar.gz 파일)입니다.
- Microsoft의 GPG 공개 키: ASCII 텍스트 파일입니다.
설치 컴퓨터에서 파일을 전송한 폴더로 이동합니다.
압축된 설치 스크립트 파일의 내용을 추출합니다. 예들 들어 tar xvfz install_azure_sphere_sdk_<version>.tar.gz입니다. .tar.gz 파일에는 install_azure_sphere_sdk.sh 파일이 포함되어 있습니다. Azure Sphere SDK 번들을 압축된 tar 파일(tar.gz 파일)로 둡니다.
를 사용하여 설치 스크립트를 실행합니다 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 설치에 설명된 대로 설치를 진행합니다.

Azure CLI용 Azure Sphere 확장 설치

Azure Sphere 연결된 디바이스 및 클라우드 배포를 관리하기 위한 명령줄 도구는 Azure CLI 확장으로 배포됩니다. 확장을 추가하거나 업데이트하려면 다음 단계를 수행합니다.

아직 설치하지 않은 경우 Azure CLI 를 설치합니다.

Azure Sphere 확장을 추가하려면 다음 명령을 실행합니다.
```
az extension add --name azure-sphere
```
Azure Sphere 확장을 업데이트하려면 다음 명령을 실행합니다.
```
az extension udpate --name azure-sphere
```

Azure Sphere 디바이스를 관리하는 데 사용하려는 Azure 구독에 로그인하려면 Azure CLI로 로그인해야 합니다.

자세한 내용은 Azure Sphere 확장 다운로드 및 실행을 참조하세요.

개발 환경 설정

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를 개발 환경으로 사용하려면 Visual Studio Code와 Azure Sphere 확장을 설치해야 합니다.

아직 설치하지 않은 경우 Visual Studio Code 다운로드의 링크를 사용하여 Visual Studio Code를 설치합니다.
Azure Sphere 확장을 설치하려면 브라우저 또는 Visual Studio Code 내에서 확장 Marketplace에서 "Azure Sphere"를 검색합니다. Azure Sphere 및 Azure Sphere UI의 두 가지 결과가 표시됩니다. 둘 중 하나에 대해 설치를 선택하고, 다른 하나는 자동으로 설치해야 합니다.
설치 후 Visual Studio Code IDE의 ENABLED 확장 창에 Azure Sphere, C/C++및 CMake Tools 확장이 표시됩니다.

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

다음 단계

디바이스 클레임