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

Linux オペレーティング システムを実行しているコンピューターに Azure Sphere SDK をインストールして、Azure Sphere アプリケーションの開発、配置、およびデバッグを行うことができます。

前提条件

Azure Sphere SDK のインストールには、次の前提条件が必要です。

• Azure Sphere 開発キット。
• 64 ビット Ubuntu 24.04 LTS または Ubuntu 22.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)
   

   Yを選択してインストールを開始します。

   Microsoft のパブリック キー フィンガープリント サイトに移動し、インストール時に表示される 16 進数の指紋値が、ページに表示されている Microsoft 公開キーフィンガープリントと一致することを確認します。 2 つのフィンガープリントが一致しない場合は、続行しないでください。

   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.
   

   ヒント

   Yを選択してazsphere グループを設定し、udev ルールを作成します。

6. インストールが完了したら、もう一度デスクトップ アプリケーションまたはログイン シェルにログインして、Azure Sphere (レガシ) 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 は、/opt/azurespheresdk/Tools_v2 にインストールされます。

Udev ルール

Azure Sphere SDK を使うと、コンピューターのデバイス情報に関する udev ルールを指定できます。 SDK によって azsphere という名前の新しいグループが作成され、現在ログインしているユーザーがグループに追加されます。 udev ルールを使うと、Azure Sphere デバイスの説明に一致する USB デバイスの所有権を付与できます。 SDK をインストールしてコンピューターを再起動した後、デバイスの回復や ARM Cortex-M4 のデバッグに sudo を使用する必要はありません。

azsphere グループは、udev ルールを使用してアクセス許可を付与するために追加されます。 このグループを手動で変更しないでください。

インターネットに接続せずに SDK をインストールする

SDK をインストールするコンピューターにインターネット接続がない場合は、インターネットに接続されているコンピューターにファイルをダウンロードし、インストール コンピューターに転送する必要があります。

1. これらのファイルをダウンロードし、インストール コンピューターに転送します。

   • Azure Sphere SDK for Linux: Ubuntu 24.04 LTS または Ubuntu 22.04 LTS から選択します。

     ダウンロードしたファイルは、Azure_Sphere_SDK_Bundleで始まる名前の圧縮 tar ファイル (.tar.gz ファイル) です。

   • インストール スクリプト: これは圧縮された tar ファイル (.tar.gz ファイル) であり、名前は install_azure_sphere_sdk。

   • Microsoft の GPG 公開キー: これは ASCII テキスト ファイルです。

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 のインストールに関するページの説明に従ってインストールを続行します。

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

Azure Sphere に接続されたデバイスとクラウドのデプロイを管理するためのコマンド ライン ツールは、Azure CLI 拡張機能として配布されます。 拡張機能を追加または更新するには、次の手順を実行します。

1. まだインストールしていない場合は Azure CLI をインストールします。

• Azure Sphere 拡張機能を追加するには、次のコマンドを実行します。

  az extension add --name azure-sphere
  

• Azure Sphere 拡張機能を更新するには、次のコマンドを実行します。

  az extension update --name azure-sphere
  

Azure CLI でサインイン Azure Sphere デバイスの管理に使用する Azure サブスクリプションにログインする必要があります。

詳細については、「 ダウンロードして Azure Sphere 拡張機能を実行するを参照してください。

開発環境を設定する

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

CMake と Ninja のインストール

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

sudo apt-get install cmake ninja-build

注

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 ページを表示できます。

次のステップ

デバイスを要求します

注

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