共用方式為

什麼是元件標識碼？

  • 發行項

重要

這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。

每個 Azure Sphere 應用程式都必須有唯 一的元件標識碼 ，才能輕鬆識別。 元件識別碼是通用唯一標識碼（UUID），也稱為全域唯一標識元（GUID），這是包含一組十六進位數位的字串。 例如，02ce3860-3126-42af-8ac7-c2a661134129。 每個應用程式都有不同的元件標識碼，以避免可能發生衝突。

產生元件標識碼

第一次在Visual Studio或Visual Studio Code 中開啟 CMake 專案時，CMakeLists 產生會自動執行，並在app_manifest.json檔案中設定應用程式的元件標識符。 如果您執行的應用程式沒有元件標識碼，則組建會失敗。 如有需要，您可以手動產生 GUID/UUID 並更新應用程式指令清單設定。

若要產生 GUID 或 UUID：

  1. 在 [ 工具 ] 功能表上選擇 [ 建立 GUID]。
  2. 在 [ GUID 產生器 ] 程式中，選擇 [ 登錄格式 ] 選項按鈕，選擇 [ 複製 ] 按鈕，然後選擇 [ 結束 ] 按鈕。

將產生的 GUID/UUID 貼到 ComponentId 應用程式 app_manifest.json 檔案的欄位中。 例如："ComponentId": "a5e23798-9bef-4bb0-9ae9-45643e788cb7"

尋找元件標識碼

識別應用程式需要應用程式的元件標識碼。 您可以透過下列任何方式尋找應用程式的元件識別碼：

  • 檢查應用程式app_manifest.json檔案欄位中的元件ComponentId標識碼。
  • 使用 azsphere device app show-status 命令，列出附加裝置上應用程式的狀態和元件標識符。
  • 使用已安裝 azsphere device image list-installed 命令來列出目前鏈接裝置上的映像。 記下必要應用程式的元件標識碼。