次の方法で共有

クイック スタート: Azure Sphere SDK for Linux をインストールする

  • [アーティクル]

重要

これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に 再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。

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 公開キーフィンガープリントと一致することを確認します。 2 つのフィンガープリントが一致しない場合は、続行しないでください。

    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)

    Y選択して Azure Sphere CLI を既定の CLI として設定するか、N Azure Sphere クラシック CLI を既定の CLI として設定します。

    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 CLI と Azure Sphere クラシック CLI CLI の両方のバージョンをインストールします。 インストールによって既存のバージョンが更新されるため、現在のバージョンをアンインストールする必要はありません。 Azure Sphere CLI は /opt/azurespheresdk/Tools_v2 にインストールされ、Azure Sphere クラシック CLI は /opt/azurespheresdk/Tools にインストールされます。

Linux では、 azsphere_v2 を使用してターミナルから Azure Sphere CLI を実行し、インストール中に既定の CLI として選択されている場合は azsphere できます。

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 を使用して、インストール スクリプトを実行します。 SDK バンドルへのパスを指定する -i パラメーターと、キーへのパスを指定する -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 のインストールに関するページの説明に従ってインストールを続行します。

開発環境を設定する

Linux 上で Azure Sphere アプリを開発するには、Visual Studio Code またはコマンドライン インターフェイス (CLI) のいずれかを使用します。 どちらを使用する場合でも、CMake と Ninja をまだインストールしていない場合は、開発マシンにインストールする必要があります。 インストールに Kitware APT リポジトリ を追加する手順を参照してください。

CMake と Ninja のインストール

CMake と Ninja をインストールするには、まずインストールに Kitware APT リポジトリ を追加する手順を参照してから、次のコマンドを使用します。

sudo apt-get install cmake ninja-build

Note

snap を使用して cmake または ninja をインストールしないでください。

Visual Studio Code 用の Azure Sphere 拡張機能をインストールする

開発環境として Visual Studio Code を使用する場合は、それをインストールし、Azure Sphere 拡張機能をインストールする必要があります。

  1. ダウンロード Visual Studio Code のリンクを使用して、Visual Studio Code をインストールします (まだインストールしていない場合)。

  2. Azure Sphere 拡張機能をインストールするには、 Extension Marketplace で ブラウザーまたは Visual Studio Code 内で "Azure Sphere" を検索します。 Azure Sphere と Azure Sphere UI の 2 つの結果が表示されます。 いずれかの Install を選択します。もう 1 つは自動的にインストールされます。

  3. インストールが完了すると、Visual Studio Code IDE の [ENABLED Extensions]\(有効な拡張機能\) ペインに、Azure Sphere、C/C++、CMake ツールの拡張機能が表示されます。

インストールが完了すると、拡張機能の Readme ページが開きます。 Readme ページには、Visual Studio Code の構成と要件に関する有用な情報が表示され、拡張機能と共に更新されます。 Extensions ペインを開き、Azure Sphere を選択すると、いつでも Readme ページを表示できます。

次のステップ

デバイスを要求します