共用方式為

建立高階應用程式

  • 發行項

重要

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

若要建立新的高階應用程式，最簡單的方式是從Visual Studio Code Azure Sphere 延伸模組的空白範本開始，並遵循下列步驟來調整專案的組態：

  1. 啟動 Visual Studio Code。 選取 [檢視>命令選擇區]，然後輸入 Azure Sphere：產生新專案。

    Visual Studio 程式代碼中的命令行

  2. 從 [範本] 選單選擇 [HL 空白]。

    具有範本名稱的快捷功能表

  3. Visual Studio Code 接著會顯示 檔案總管 視窗。 流覽至您要放置空白應用程式的資料夾，並指定項目的名稱，例如 NewHLApp。 Visual Studio Code 會在您選取的位置建立 NewHLApp 資料夾，併產生空白應用程式的組建檔案。 您應該會看到來自 CMake 的訊息。

  4. 開啟CMakeLists.txt檔案，並指定包含您所使用硬體定義的資料夾。 根據預設，HL 空白應用程式不包含任何硬體定義。 您可以在 Azure Sphere 範例存放庫中找到範例硬體定義，或建立一個硬體定義，如硬體定義中所述。

    下列示範如何新增 Seeed Azure Sphere MT3620 開發工具包的硬體定義範例：

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    這個行應該插入到最後一個命令開頭 azsphere_target_add_image_package之前。

您也可以從任何高階 Azure Sphere 範例建立新的高階應用程式：

  1. 如果您尚未這麼做， 請複製範例存放庫 。 複製其中一個高階應用程式資料夾，然後為您的專案重新命名。

  2. 在CMakeLists.txt檔案中，將專案名稱變更為新資料夾的名稱。 例如：

    PROJECT(NewHLApp C)

若要建立新的高階應用程式，最簡單的方式是從Visual Studio Azure Sphere延伸模組的空白範本開始，並遵循下列步驟來調整專案的組態：

  1. 啟動 Visual Studio 並選取 [建立新專案]。

  2. 在標示為 [搜尋範本] 的搜尋方塊中輸入 Azure Sphere 。 從傳回的清單選取 [Azure Sphere HLCore 空白 ]，然後選取 [ 下一步]。

  3. 指定專案名稱（例如 NewHLApp）、項目檔位置和方案名稱（這與專案名稱相同），然後選取 [ 建立]。 Visual Studio 會在您選取的位置建立 NewHLpp 資料夾，並產生空白應用程式的組建檔案。 您應該會看到來自 CMake 的訊息。

  4. 開啟CMakeLists.txt檔案，並指定包含您所使用硬體定義的資料夾。 根據預設，HL 空白應用程式不包含任何硬體定義。 您可以在 Azure Sphere 範例存放庫中找到範例硬體定義，或建立一個硬體定義，如硬體定義中所述。

    下列示範如何新增 Seeed Azure Sphere MT3620 開發工具包的硬體定義範例：

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    這個行應該插入到最後一個命令開頭 azsphere_target_add_image_package之前。

您也可以從任何高階 Azure Sphere 範例建立新的高階應用程式：

  1. 如果您尚未這麼做， 請複製範例存放庫 。 複製其中一個高階應用程式資料夾，然後為您的專案重新命名。

  2. 在CMakeLists.txt檔案中，將專案名稱變更為新資料夾的名稱。 例如：

    PROJECT(NewHLApp C)

建立新高階應用程式最簡單的方式，就是從任何高階 Azure Sphere 範例開始：

  1. 如果您尚未這麼做， 請複製範例存放庫 。 複製其中一個高階應用程式資料夾，然後為您的專案重新命名。

  2. 在CMakeLists.txt檔案中，將專案名稱變更為新資料夾的名稱。 例如：

    PROJECT(NewHLApp C)

高階應用程式的基本檔案結構

無論您如何建立應用程式，所有 Azure Sphere 應用程式都會共用下列核心檔案：

  • 一或多個檔案中的應用程式原始程式碼。 目前僅支援 C 語言原始程式碼。
  • CMake 組建檔案。 需要CMakeLists.txt。 CMake 與 ninja 輕量型建置公用程式一起使用，可用來控制 Azure Sphere 應用程式建置程式。
  • 應用程式 指令清單 檔案，描述應用程式可用的功能。

高階應用程式通常至少有三個其他檔案：

  • applibs-versions.h 檔案，指定各種 Azure Sphere API 的版本層級
  • 兩個硬體定義檔案（JSON 格式的可編輯版本，以及從中產生的 C 語言包含檔案），提供方便的方式來參考程式碼中的硬體元件。 使用一組一致的硬體定義檔案，您可以撰寫與硬體無關的原始程式碼，然後直接將CMakeLists.txt檔案中的適當硬體定義檔重新設為目標，以建置特定硬體的應用程式映像。

撰寫您的程式碼

  1. 使用 Azure Sphere 高階應用程式範例作為指南，撰寫應用程式程式代碼。 下列主題描述特定的實作案例：
  2. 在CMakeLists.txt檔案中：
    • 指定 Azure Sphere SDK 工具修訂
    • 指定目標 API 集合
    • 指定目標硬體
  3. 在app_manifest.json檔案中：
    • 將 Name 設為專案名稱。
    • 新增程式代碼所需的任何應用程式特定功能，例如硬體資源或連線。 如果高階應用程式與 RTApp 通訊，請將高階應用程式的元件標識元新增至 AllowedApplicationConnections 功能。

如果您想要將高階應用程式與即時可用的合作夥伴應用程式一起部署，請將合作夥伴的元件標識符新增至 launch.vs.json （Visual Studio） 或 .vscode/launch.json （Visual Studio Code） 檔案之 [組態] 區段的 partnerComponents 字段：

"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

另請參閱