快速入門：安裝適用於Linux的 Azure Sphere SDK

重要

這是 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 的計算機。 僅支援 Intel 相容的 x86-64 處理器;不支援其他架構，例如 ARM（包括 Raspberry Pi）、Itanium 或 SPARC。 x86-64 架構也稱為 x64、x86_64、AMD64 和 Intel 64。
• Linux sudo 許可權。
• 因特網連線或從具有因特網連線的計算機傳輸檔案的方式。 如需詳細資訊，請參閱 在沒有因特網連線的情況下安裝SDK。

新增必要的 Linux 套件

執行 SDK 安裝文稿之前，如果尚未安裝必要的 Linux 套件，您必須將必要的 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的公鑰指紋 網站，並確認安裝期間顯示的十六進位指紋值符合頁面上顯示的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)
   
   

   選取 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 group 並建立 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，並在 azsphere 安裝期間選取 Azure Sphere CLI 作為預設 CLI。

第一次安裝 CLI 之後，請執行 azsphere show-version 來確認它是否已安裝，且您已取得正確的版本。

Udev 規則

Azure Sphere SDK 會 udev 指定電腦裝置信息的規則。 SDK 會建立名為 azsphere 的新群組，並將目前登入的使用者新增至該群組。 此 udev 規則會授與符合 Azure Sphere 裝置描述的 USB 裝置擁有權。 安裝 SDK 並重新啟動電腦之後，您就不需要用於 sudo 裝置復原或 ARM Cortex-M4 偵錯。

會 azsphere 新增群組，以使用 udev 規則來授與許可權。 請勿手動修改群組。

在沒有因特網連線的情況下安裝 SDK

如果您在安裝 SDK 的電腦上沒有因特網連線，您必須將這些檔案下載到連線到因特網的電腦，並將其傳輸至安裝電腦。

1. 下載這些檔案，並將其傳輸至安裝電腦：

   • 適用於 Linux 的 Azure Sphere SDK：從 Ubuntu 24.04（發行前版本）、Ubuntu 22.04 LTS 或 Ubuntu 20.04 LTS 中選擇。

     下載的檔案是壓縮的 tar 檔案（.tar.gz 檔案），名稱開頭 為 Azure_Sphere_SDK_Bundle。

   • 安裝腳本：這是名稱開頭為install_azure_sphere_sdk的壓縮 tar 檔案（.tar.gz檔案）。

   • 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 中所述。

設定開發環境

您可以使用 Visual Studio Code 或命令行介面 （CLI） 在 Linux 上開發 Azure Sphere 應用程式。 無論您使用哪一種，如果您還沒有 CMake 和 Ninja，則必須在開發電腦上安裝 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 擴充功能，請在擴充功能 Marketplace 中從瀏覽器或 Visual Studio Code 中搜尋 “Azure Sphere”。 您應該會看到兩個結果： Azure Sphere 和 Azure Sphere UI。 選取 [安裝 ] 做為其中一個;另一個應該自動安裝。

3. 安裝之後，您應該會在 Visual Studio Code IDE 的 [ENABLED 擴充功能] 窗格中看到 Azure Sphere、 C/C++ 和 CMake Tools 擴充功能。

安裝完成時， 延伸模組的自述檔 頁面將會開啟。 自 述文件 頁面提供有關 Visual Studio Code 組態和需求的實用資訊，並隨著延伸模組一起更新。 您可以開啟 [延伸模組] 窗格並選取 [Azure Sphere]，隨時檢視自述檔頁面。

下一步

宣告您的裝置