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

您可以在執行 Linux 作業系統的電腦上安裝 Azure 球體 SDK，以開發、部署和偵錯 Azure 球體應用程式。

先決條件

Azure 球體 SDK 安裝需要下列先決條件：

• Azure 球體開發工具包。
• 配備 x86-64 型處理器且執行 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終端機中輸入下列行。 您可以省略已安裝的套件。

sudo apt-get update
sudo apt-get install -y net-tools curl

安裝 Azure 球體 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 球體 CLI 設為預設 CLI，或 N 將 Azure 球體傳統 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 (Azure 球體。

安裝之後，azsphere 命令位於 PATH 上，而您裝置的新 udev 規則 位於 /etc/udev/rules.d/。

腳本會將 SDK 安裝到 /opt/azurespheresdk，並將工具鏈安裝到 /opt/azurespheresdk/Sysroots/sysroot-version/tools，其中 sysroot-version 可識別 SDK 支援應用程式開發的 sysroot 。

安裝程式會安裝 Azure 球 (舊版) CLI 版本的 CLI。 您不需要卸載目前的版本，因為安裝將會更新任何現有的版本。 Azure 球體 (舊版) CLI 安裝於 /opt/azurespheresdk/Tools_v2，而 Azure 球體 (舊版) 傳統 CLI 則安裝在 /opt/azurespheresdk/Tools 中。

在 Linux 上，您可以從終端機執行 azsphere_v2 Azure 球 (舊版) CLI，並在 azsphere 安裝期間選取為預設 CLI。

第一次安裝 CLI 之後，請檢查是否已安裝，並執行 azsphere 播放版本以取得正確的版本。

Udev 規則

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

新增 azsphere 群組是為了使用 udev 規則授與許可權。 請勿手動修改群組。

安裝沒有因特網連線的 SDK

如果您安裝 SDK 的電腦上沒有因特網連線，您必須將檔案下載到連線到因特網的電腦，然後傳輸到安裝電腦。

1. 下載這些檔案並將它們傳輸到安裝電腦：

   • Azure 球體 SDK for Linux：從 Ubuntu 24.04 (發行前版本) 或 Ubuntu 22.04 LTS 或 Ubuntu 20.04 LTS 中選擇。

     下載的檔案是壓縮的 tar 檔案， (.tar.gz 檔) 開頭 Azure_Sphere_SDK_Bundle名稱。

   • 安裝腳本：這是壓縮的 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 球體 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 球體 SDK 中所述，繼續進行安裝。

安裝 Azure CLI 的 Azure 球體擴充功能

用於管理 Azure 球體連接裝置和雲端部署的命令行工具會以 Azure CLI 擴充功能發佈。 請採取下列步驟來新增或更新擴充功能：

1. 如果您尚未安裝 Azure CLI，請安裝它。

• 若要新增 Azure 球體擴充功能，請執行下列命令：

  az extension add --name azure-sphere
  

• 若要更新 Azure 球體擴充功能，請執行下列命令：

  az extension udpate --name azure-sphere
  

您必須 使用 Azure CLI 登入，才能登入您想要用來管理 Azure 球體裝置的 Azure 訂閱。

如需詳細資訊，請參閱 下載並執行 Azure 球體擴充功能。

設定您的開發環境

您可以使用 Visual Studio Code 或命令行介面 (CLI) ，在 Linux 上開發 Azure 球體應用程式。 無論您使用哪一種功能，如果您還沒有 CMake 和 Ninja，都需要在開發電腦上安裝。 請參閱將 Kitware APT 存放庫 新增至安裝的指示。

安裝 CMake 和忍者

若要安裝 CMake 和 Ninja，請先參閱將 Kitware APT 存放庫 新增至安裝的指示，然後使用下列命令：

sudo apt-get install cmake ninja-build

注意

請勿使用 snap 安裝 cmake 或忍者。

安裝適用於 Visual Studio Code的 Azure 球體擴充功能

如果您想要使用 Visual Studio Code 做為您的開發環境，您必須安裝它和 Azure 球體擴充功能。

1. 如果您尚未安裝，請使用下載 Visual Studio Code 中的連結來安裝 Visual Studio Code。

2. 若要安裝 Azure 球體擴充功能，請從瀏覽器或 Visual Studio Code 內，在擴充服務商場中搜尋「Azure 球體」。 您應該會看到兩個結果： Azure 球體 和 Azure 球體 UI。 選取任一裝置的 [安裝 ];另一個應該會自動安裝。

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

安裝完成時，將會開啟擴充功能的 [已讀取] 頁面。 [已讀取] 頁面提供有關 Visual Studio Code 設定和需求的實用資訊，並隨著擴充功能一併更新。 您可以開啟 [擴充功能] 窗格並選取 [Azure 球體]，隨時檢視 [已讀取] 頁面。

後續步驟

宣告您的裝置

注意

請勿使用 snap 安裝 cmake 或忍者。