共用方式為


快速入門:安裝適用於 Windows 的 Azure 球體 SDK

若要開始在 Windows 上使用 Azure 球體開發工具包,您必須設定開發工具包、安裝 SDK,以及安裝開發環境所需的任何其他軟體。

先決條件

  • Azure 球體開發工具包
  • Windows 11 或 Windows 10 年度更新版 (或更新版本的電腦)
  • 未使用的 USB 埠,如果您執行的是虛擬機,則支援 USB 傳遞

在 Windows 電腦上設定您的開發工具組

透過USB將 Azure 球體開發工具包連接到您的電腦。 插入電源時,裝置會顯示四個USB串行轉換程式。

第一次插入裝置時,驅動程式應該會自動下載並安裝。 安裝速度可能很慢。 如果沒有自動安裝驅動程式,請以滑鼠右鍵按兩下 裝置管理員中的裝置名稱,然後選取 [更新驅動程式]。 或者,您可以從 Future Technology Devices International (FTDI) 下載驅動程式。 選擇符合您 Windows 安裝 (32 位或 64 位) 的驅動程式。

若要驗證安裝,請開啟 裝置管理員。 在 [通用串行總線控制器] 底下,尋找四個 USB 串行轉換器。 裝置管理員 有四個 USB 序列轉換程式

注意

如果您先前已使用此面板並啟用 RTApp 開發,您會看到三個轉換程式,而非四個。 這是正常現象,並不代表錯誤。

如果發生其他錯誤,請參閱 Azure 球體問題疑難解答 以取得協助。

安裝 Azure 球體 SDK

  1. 下載 SDK。 將下載的檔案儲存在計算機上。

  2. 執行下載的 .exe 來安裝 SDK。 同意授權條款,然後選取 [ 下一步]

  3. 選取 [安裝 ] 以開始安裝。

  4. 如果出現提高許可權提示,請接受此提示。

  5. 設定完成時,如果安裝應用程式要求,請重新啟動電腦。

如果安裝程式傳回錯誤,請嘗試卸載然後重新安裝 SDK 套件。

提示

Azure 球體 SDK 授權安裝在 c:\Program Files (x86) \Microsoft Azure 球體 SDK\license.rtf。

SDK 包含用於應用程式開發的文件庫,以及 Azure 球體 CLI 和 Azure 球體傳統 CLI 版本的 CLI 文檔庫。 您不需要卸載目前的版本,因為安裝將會更新任何現有的版本。 Azure 球體 CLI 安裝於 C:\Program Files (x86) \Microsoft Azure 球體 SDK\Tools_v2, 而 Azure 球體傳統 CLI 則安裝在 C:\Program Files (x86) \Microsoft Azure 球體 SDK\Tools 中。

您可以使用 Windows 命令提示字元或 PowerShell 的命令來執行 Azure 球體 CLI azsphere 。 建議您使用PowerShell,因為它提供Windows 命令提示字元中無法使用的索引 標籤完成 功能。 Azure 球體傳統 CLI 將繼續使用 Azure 球體傳統開發人員命令提示字元 (淘汰) ,此功能可在 Azure 球體下的 [開始] 功能表中取得。

第一次安裝 CLI 之後,請檢查是否已安裝,並執行以取得正確的版本 azsphere show-version

如果您嘗試執行 CLI,但收到錯誤訊息,指出 azsphere 這不是可辨識的命令,請將 Azure 球體 SDK 可執行路徑新增至 Windows 環境變數。 移至 控制台>系統和安全>性系統>進階系統設定]。 選取 [環境變數 ],並在 [ 系統變數 ] 中新增 azsphere.exe (路徑,例如 C:\Program Files (x86) \Microsoft Azure 球體 SDK\Tools_v2) 。

安裝 Visual Studio 的 Azure 球體擴充功能

您可以使用 Visual Studio Enterprise、專業版或社群 2022 (或 2019 版本 16.11 或更新版本) 來開發 Azure 球體應用程式。

  1. 如果您尚未這麼做,請安裝 Visual Studio:

  2. 移至 Visual Studio Marketplace 來安裝 Azure 球體的 Visual Studio 擴充功能:

Azure 球體 SDK 和 Visual Studio 的 Azure 球體擴充功能包含開發 Azure 球體應用程式所需的所有工具。

在 Windows 上安裝 CMake 和忍者

如果您打算使用 Visual Studio Code 或 Windows CLI,您必須手動安裝 CMake 和 Ninja。

  1. 若要安裝 CMake,請從 CMake 下載頁面下載並安裝適用於您開發環境的 CMake 版本。

  2. 下載 「忍者」。 下載是小型 zip 檔案。 若要安裝忍者,請開啟 zip 檔案,選取 [解壓縮全部],然後記下解壓縮檔案 ninja.exe 的檔案位置。

  3. 一般 (新增 CMake bin 目錄,C:\Program Files\CMake\bin) ,以及包含 ninja.exe 的目錄至 PATH 環境變數。 若要尋找在 Windows 中設定此環境變數的相關信息,請在 [搜尋] 方塊中輸入「路徑」。

提示

在修改環境變數之後將電腦重新啟動,以確保所有程式都能接聽變更。

安裝適用於 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 球體],隨時檢視 [已讀取] 頁面。

後續步驟