建立即時可用的應用程式

重要

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

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

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

   

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

   

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

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

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

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

   PROJECT(NewRTApp C)

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

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

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

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

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

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

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

   PROJECT(NewRTApp C)

建立新即時可用的應用程式最簡單的方式，就是從HelloWorld_RTApp_MT3620_BareMetal範例開始，並遵循下列步驟來調整專案的組態：

1. 如果您尚未這麼做， 請複製範例存放庫 。 複製HelloWorld_RTApp_MT3620_BareMetal資料夾，然後為您的專案重新命名。

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

   PROJECT(NewRTApp C)

即時可用的應用程式的基本檔案結構

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

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

即時可用的應用程式至少會新增一個其他檔案：linker.ld 檔案，以精確指定應用程式的各種元件要載入即時核心的位置。

撰寫您的程式碼

1. 使用 Azure Sphere RTApp 範例作為指南，撰寫應用程式程式代碼。 下列主題描述特定的實作案例：
   • 在即時可用的應用程式中使用周邊
   • 管理記憶體和延遲考慮
2. 在app_manifest.json檔案中：
   • 將 Name 設定為您的專案名稱。
   • 將 ApplicationType (API 定義來源) 設定為 ["RealTimeCapable"]
   • 新增程式代碼所需的任何應用程式特定功能，例如硬體資源或連線。 如果 RTApp 與高階應用程式通訊，請將高階應用程式的元件標識元新增至 AllowedApplicationConnections 功能。

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

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

另請參閱

• 建置即時可用的應用程式。

• 對即時可用的應用程式進行偵錯。