创建支持实时的应用程序
重要
这是 Azure Sphere(旧版)文档。 Azure Sphere(旧版)将于 2027 年 9 月 27 日停用,用户此时必须迁移到 Azure Sphere(集成)。 使用位于 TOC 上方的版本选择器查看 Azure Sphere(集成)文档。
创建新的支持实时的应用程序的最简单方法是从 Visual Studio Code Azure Sphere 扩展使用空白模板开始,并按照以下步骤调整项目配置:
启动 Visual Studio Code。 选择“查看>命令”面板,然后键入 Azure Sphere:生成新项目。
从“模板”菜单中选择 RTCore 空白。
然后,Visual Studio Code 会显示文件资源管理器窗口。 导航到要放置空白应用程序的文件夹,并为项目指定名称,例如 NewRTApp。 Visual Studio Code 会在所选位置创建 NewRTApp 文件夹,并为空白应用程序生成生成文件。 你应可看到来自 CMake 的消息。
还可以从任何支持实时的 Azure Sphere 示例创建新的支持实时的应用程序:
如果还没有克隆示例存储库,则克隆它。 复制其中一个高级应用程序文件夹,并将其重命名为项目。
在 CMakeLists.txt 文件中,将项目名称更改为新文件夹的名称。 例如:
PROJECT(NewRTApp C)
创建新的支持实时的应用程序的最简单方法是从 Visual Studio Azure Sphere 扩展开始使用空白模板,并按照以下步骤调整项目配置:
启动 Visual Studio 并选择“创建新项目”。
键入
Azure Sphere
标记为“搜索模板”的搜索框。 从返回的列表中选择“Azure Sphere RTCore 空白”,然后选择“下一步”。指定项目名称(例如 NewRTApp)、项目文件位置和解决方案名称(可以与项目名称相同),然后选择“ 创建”。 Visual Studio 会在所选位置创建 NewRTApp 文件夹,并为空白应用程序生成生成文件。 你应可看到来自 CMake 的消息。
还可以从任何高级 Azure Sphere 示例创建新的支持实时的应用程序:
如果还没有克隆示例存储库,则克隆它。 复制支持实时的应用程序文件夹之一,并将其重命名为项目。
在 CMakeLists.txt 文件中,将项目名称更改为新文件夹的名称。 例如:
PROJECT(NewRTApp C)
创建新的支持实时应用程序的最简单方法是从 HelloWorld_RTApp_MT3620_BareMetal 示例开始,然后按照以下步骤调整项目的配置:
如果还没有克隆示例存储库,则克隆它。 复制 HelloWorld_RTApp_MT3620_BareMetal 文件夹并将其重命名为你的项目。
在 CMakeLists.txt 文件中,将项目名称更改为新文件夹的名称。 例如:
PROJECT(NewRTApp C)
支持实时的应用程序的基本文件结构
无论如何创建应用程序,所有 Azure Sphere 应用程序都共享以下核心文件:
- 一个或多个文件中的应用程序源代码。 目前,仅支持 C 语言源代码。
- CMake 生成文件。 需要CMakeLists.txt。 CMake 与 ninja 轻型生成实用工具一起用于控制 Azure Sphere 应用程序生成过程。
- 描述 应用程序可用的功能的应用清单 文件。
支持实时的应用程序至少添加一个其他文件:linker.ld 文件,用于指定应用程序的各个组件在实时核心上加载的位置。
编写代码
- 使用 Azure Sphere RTApp 示例编写应用程序代码作为指南。 以下主题介绍了特定的实现方案:
- 在 app_manifest.json文件中:
- 将
Name
设置为项目名称。 - 将
ApplicationType
设置为"RealTimeCapable"
- 添加代码所需的任何特定于应用程序的功能,例如硬件资源或连接。 如果 RTApp 与高级应用程序通信,请将高级应用程序的组件 ID 添加到
AllowedApplicationConnections
功能。
- 将
如果要将 RTApp 与高级合作伙伴应用一起部署,请将合作伙伴的组件 ID 添加到 launch.vs.json (Visual Studio) 或 .vscode/launch.json (Visual Studio Code) 文件“配置”部分的 partnerComponents 字段中:
"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]