クイック スタート: Azure Sphere SDK for Linux をインストールする
重要
これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に廃止され、ユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の 上にあるバージョン セレクターを使用して、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 をインストールする
次のステップを実行します。
インストール スクリプトをダウンロードします。
圧縮ファイルをダウンロードしたフォルダーに移動します。
圧縮ファイルの内容を抽出します。 たとえば、
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 公開キーフィンガープリントと一致することを確認します。 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
YSphere CLI を既定の CLI として設定するか、AzureNSphere クラシック 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)azsphere
Yグループを設定し、udev ルールを作成します。インストールが完了したら、デスクトップ アプリケーションまたはログイン シェルに再度ログインして 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 では、インストール時に既定の CLI として選択されている場合は、azsphereターミナルazsphere_v2から Azure Sphere 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 をインストールするコンピューターにインターネット接続がない場合は、インターネットに接続されているコンピューターにこれらのファイルをダウンロードし、インストール コンピューターに転送する必要があります。
これらのファイルをダウンロードし、インストール コンピューターに転送します。
Azure Sphere SDK for Linux: 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を使用して、インストール スクリプトを実行します。 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 拡張機能をインストールする必要があります。
Visual Studio Code をまだインストールしていない場合は、「Visual Studio Code のダウンロード」のリンクを使用して Visual Studio Code をインストールします。
Azure Sphere 拡張機能をインストールするには、ブラウザーまたは Visual Studio Code から拡張機能 Marketplace で "Azure Sphere" を検索します。 Azure Sphere と Azure Sphere UI の 2 つの結果が表示されます。 いずれかの場合は [インストール] を選択します。もう 1 つは自動的にインストールされます。
インストールが完了すると、Visual Studio Code IDE の [ENABLED Extensions]\(有効な拡張機能\) ペインに、Azure Sphere、C/C++、CMake ツールの拡張機能が表示されます。
インストールが完了すると、拡張機能の Readme ページが開きます。 Readme ページには、Visual Studio Code の構成と要件に関する有用な情報が表示され、拡張機能と共に更新されます。 [拡張機能] ウィンドウを開き、[Azure Sphere] を選択すると、いつでも Readme ページを表示できます。