建立高階應用程式

  • 發行項

建立新高階應用程式最簡單的方法是從 Visual Studio Code Azure 球體擴充功能的空白範本開始，並依照下列步驟調整專案設定：

  1. 開始Visual Studio Code。 選取 [檢視>命令調色盤]，然後輸入 Azure 球體：產生新專案。

    Visual Studio 程式碼中的命令列

  2. 從 [範本] 功能表中選擇 [HL 空白]。

    含有範本名稱的快顯功能表

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

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

    下列說明如何新增 Seeed Azure 球體 MT3620 開發工具組的範例硬體定義：

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

    應該會在最終命令開頭 azsphere_target_add_image_package 之前插入此行。

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

  1. 如果您尚未複製 樣本檢視 ，請複製該批註。 複製其中一個高階應用程式資料夾，並為專案重新命名。

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

    PROJECT(NewHLApp C)

建立新高階應用程式最簡單的方法是從 Visual Studio Azure 球體擴充功能的空白範本開始，並依照下列步驟調整專案設定：

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

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

  3. 指定專案名稱 (例如 NewHLApp) 、專案檔案位置和解決方案名稱 (可以與專案名稱) 相同，然後選取 [ 建立]。 Visual Studio 會在您選取的位置建立 NewHLpp 資料夾，並產生空白應用程式的組建檔案。 您應該會看到來自 CMake 的郵件。

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

    下列說明如何新增 Seeed Azure 球體 MT3620 開發工具組的範例硬體定義：

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

    應該會在最終命令開頭 azsphere_target_add_image_package 之前插入此行。

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

  1. 如果您尚未複製 樣本檢視 ，請複製該批註。 複製其中一個高階應用程式資料夾，並為專案重新命名。

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

    PROJECT(NewHLApp C)

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

  1. 如果您尚未複製 樣本檢視 ，請複製該批註。 複製其中一個高階應用程式資料夾，並為專案重新命名。

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

    PROJECT(NewHLApp C)

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

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

  • 一或多個檔案中的應用程式原始程式碼。 目前僅支援 C 語言原始程式碼。
  • CMake 組建檔案。 CMakeLists.txt 為必要專案。 CMake 與忍者輕量型組建公用程式搭配使用，用來控制 Azure 球體應用程式組建程式。
  • 說明應用程式可用功能的 應用程式資訊清單 檔案。

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

  • 指定各種 Azure 球體 API 版本層級的 applibs-version.h 檔案
  • 兩個硬體定義檔 (JSON 格式的可編輯版本，而 C 語言包含從中產生的檔案，) 提供方便的方式來參照程式碼中的硬體元件。 透過一組一致的硬體定義檔案，您可以撰寫硬體獨立原始程式碼，然後只要在 CMakeLists.txt 檔案中重新設定適當的硬體定義檔目標，即可建置特定硬體的應用程式映射。

撰寫您的程式碼

  1. 使用 Azure 球體高層級應用程式範例撰寫應用程式代碼做為指南。 下列主題說明特定的實作案例：
  2. 在 CMakeLists.txt 檔案中：
    • 指定 Azure 球體 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" ]

另請參閱