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

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)
   
   

   Azure Sphere CLI を既定の CLI として設定するか、Azure N 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. インストールが完了したら、もう一度デスクトップ アプリケーションまたはログイン シェルにログインして、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 バージョンの CLI をインストールします。 インストールでは既存のバージョンが更新されるため、現在のバージョンをアンインストールする必要はありません。 Azure Sphere (レガシ) CLI は /opt/azurespheresdk/Tools_v2 にインストールされ、Azure Sphere (レガシ) クラシック CLI は /opt/azurespheresdk/Tools にインストールされます。

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

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. これらのファイルをダウンロードし、インストール コンピューターに転送します。

   • Azure Sphere SDK for Linux: Ubuntu 24.04 (プレリリース) または Ubuntu 22.04 LTS または Ubuntu 20.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実行します。 -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 拡張機能として配布されます。 拡張機能を追加または更新するには、次の手順を実行します。

1. まだインストールしていない場合は、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 拡張機能をダウンロードして実行する」を参照してください。

開発環境を設定する

Azure Sphere アプリは、Visual Studio Code またはコマンド ライン インターフェイス (CLI) を使用して Linux 上で開発できます。 どのコンピューターを使用する場合でも、まだインストールしていない場合は、開発用コンピューターに 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 Sphere と Azure Sphere UI の 2 つの結果が表示されます。 いずれかの [インストール] を選択します。もう一方は自動的にインストールされます。

3. インストール後、Visual Studio Code IDE の [ENABLED Extensions] ペインに Azure Sphere、 C/C++、 および CMake Tools 拡張機能が表示されます。

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

次の手順

デバイスを要求する

メモ

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