Azure RTOS GUIX Studio 快速入门指南

本指南简要介绍了 Azure RTOS GUIX Studio 的用法。 GUIX Studio 是基于 Windows 的 UI 设计应用程序,专门用于与 Microsoft 提供的 Azure RTOS GUIX 运行时库配合使用。

本指南适用于使用 ThreadX 实时操作系统 (RTOS) 和 Azure RTOS GUIX UI 运行时库的嵌入式实时软件开发人员。 开发人员应熟悉标准的 Azure RTOS ThreadX 和 Azure RTOS GUIX 概念。

总结

Azure RTOS GUIX Studio 包含创建、生成和运行自己的图形界面设计所需的一切。 如果你正在评估 GUIX Studio,则可使用评估工具包,将其作为独立的 Windows 桌面应用程序生成和运行 GUIX 设计,用于测试和评估目的。 由于 GUIX 设计用于在几乎任何能够提供图形输出的嵌入式目标上使用,因此,你始终可以在自己的嵌入式目标上编译和运行你在桌面上所做的工作以及创建的设计,无需更改任何应用程序软件。 GUIX Studio 安装程序在开发系统上安装多个组件:

  • GUIX Studio 应用程序。
  • 几个 GUIX 示例项目。
  • 示例项目中使用的所有图形资源和字体。
  • 使用 Microsoft Visual Studio IDE 在 Windows 桌面环境中生成的解决方案文件和项目文件。
  • 用于 Win32 的预建 GUIX 和 ThreadX 库,允许你在电脑上生成和运行自己的应用程序。
  • GUIX 和 ThreadX API 标头文件。

先决条件

Azure RTOS GUIX Studio 安装程序包含几个简单的示例项目,我们希望你在了解如何使用 GUIX Studio 应用程序时,从修改、生成和运行这些示例开始。 若要在 Windows 桌面上生成并运行示例,需要使用 Microsoft Visual Studio 编译器。 这些工具可从以下位置下载:

https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_4

如果尚未安装 Microsoft 开发人员工具,仍可以检查并使用 GUIX Studio 应用程序,以创建自己的接口设计并检查生成的源代码。 但你无法以独立应用程序的形式生成和运行你的设计。

运行示例

运行 GUIX Studio 安装程序后,你会发现已安装的内容中包含几个示例 Studio 项目和生成文件。 若要验证桌面工具是否已安装且正常工作,我们建议你从按原样生成和运行提供的每个示例开始。 我们将你的安装目录称为 <root>,在这种情况下,你应该使用文件浏览器并浏览到 <root>/GUIX_Studio_6.x/examples。 在此目录中,你应该会看到一些简单的示例程序,如 demo_guix_calculator、demo_guix_car_infotainment、demo_guix__home_automation、demo_guix_widget_types 和其他程序。

生成示例

你应该会在每个示例文件夹内找到名为 build 的子目录。 此目录包含为每个受支持的工具链预配置的项目。 例如,你可以浏览到 <root>/GUIX_Studio_6.x/examples/thermometer/build/vs_2019,你会发现预配置的 Microsoft Visual Studio 解决方案文件和项目文件可以立即在 Visual STUDIO IDE 中加载和运行。 如果要使用不同的工具链,请联系 azure_rtos_support

建议你启动 Microsoft Visual C++ IDE,并至少打开其中一个示例。 按 <F7> 键生成示例项目,成功生成程序后按 <F5> 键可运行该程序。 现在应该会看到在 Microsoft Windows 窗口中运行的 GUIX 用户界面。

设计和运行自己的用户界面

本快速入门指南不能替代 GUIX Studio 用户指南或 GUIX 用户指南,但我们将为你提供足够的入门信息,并建议你继续参阅 GUIX Studio 用户指南以了解更多详细信息。

可以通过两种方法创建和修改你自己的用户界面。 你可以学习 GUIX 库编程手册,并直接在应用程序软件中使用 GUIX API 来完全实现你的设计。 更常见的情况是,您将使用 GUIX Studio 应用程序来完成屏幕元素设计和布局的大部分工作,然后完成事件处理以及让用户界面执行实际工作所需的其他应用程序逻辑。

提供的每个示例都是使用 GUIX Studio 界面设计应用程序创建的。 运行 GUIX Studio 安装程序后,你应该在桌面上为 GUIX Studio 6.x.x.x 创建一个图标。 立即启动 GUIX Studio,然后打开名为“demo_guix_widget_types\guix_widget_types.gxp”的项目。 widget_types 演示是一个示例项目,该项目演示了最常见的 GUIX 小组件类型的几个变体。

现在,你已经打开了一个项目,单击“+”在 IDE 左上角的“项目”视图中打开名为“Primary”的树节点,然后单击名为“Menu_Screen”的文件夹中的顶级窗口。 你的项目不应该如下所示:

打开项目的 Studio 的屏幕截图。

GUIX Studio 视图

GUIX Studio IDE 由多个“视图”组成。 每个视图旨在帮助您在设计中进行导航,并对该设计进行更改。

项目视图

左上方的视图称为“项目视图”。 此视图显示项目中包含的每个物理显示器(大多数项目只有一个显示器),以及设计为在该显示器上运行的屏幕和子小组件。

属性视图

“项目视图”下面是“属性视图”。 顾名思义,你可在“属性视图”中通过更改与小组件关联的各种属性来修改这些小组件。

目标视图

中央显示区域称为“目标视图”。 此视图是用户界面的所见即所得 (WYSIWYG) 显示。 由于 GUIX 库在目标视图中进行绘制,因此,此视图能在你对嵌入式目标执行操作时用精确的像素呈现你的设计外观。 如果单击“项目视图”或中心“目标视图”中的不同小组件,则会看到“属性视图”中显示的值变为显示所选小组件的属性。

资源视图

最后,你可在右侧看到所谓的“资源视图”。 通过此视图,你可以选择、添加、删除和修改项目中包含的颜色、字体、像素图和字符串。

修改示例

GUIX Studio 采用直观的设计。 若要移动上面所示的小组件之一,只需在“目标视图”中单击该小组件,并将其拖到新位置即可。 若要更改小组件颜色,请单击所需的小组件,并更改“属性视图”中显示的颜色。 若要更改文本显示小组件使用的字体,只需在“资源视图”中单击所需的字体,然后将该字体拖放到所需的目标小组件。 将鼠标悬停在工具栏按钮上,可查看有关每个按钮所执行操作的快速帮助。

请自行尝试,并对示例进行一些小更改。 例如,您可以将小组件拖到新位置、更改窗口背景色或调整按钮大小。 在你获得更多 GUIX 使用经验之前,我们不建议你删除该示例中的任何小组件,因为删除小组件可能需要对应用程序源代码进行相关的修改。

在 Studio 中运行应用程序

您可以使用“编辑|运行应用程序”菜单命令(或按钮栏上的“运行应用程序”按钮),在新的桌面窗口中立即运行应用程序。 使用此方法不会调用自定义绘制函数和其他应用程序代码,但你可以利用该方法快速浏览 UI 设计,并大致了解应用程序的外观,包括从一个屏幕到下一屏幕的导航。

生成源文件

进行更改之后,需要调用 GUIX Studio 菜单命令来生成项目的新源文件。 然后,你可以重新生成示例程序,以查看你在操作中所做的更改。 若要生成源文件,请使用 GUIX Studio 菜单命令“项目|生成资源文件”和“项目|生成规范文件”,您还可以在“项目视图”中右键单击显示来执行这些命令。

生成这些新源文件后,你应该会看到一条确认消息,告诉你与项目相关的源文件已更新。 如果未看到此确认消息,请检查以确保你对项目所在的目录具有写入权限。 现在可以关闭 GUIX Studio 应用程序。 如果已对项目进行了更改,GUIX Studio 会询问你是否要保存这些更改。 继续操作并保存更改,你在学习使用 GUIX Studio 时,可借助这些示例了解如何使用并进行尝试。

生成和运行应用程序

现在,GUIX Studio 已经生成了项目输出文件,你可以通过编译和链接来创建独立的 Win32 可执行文件。 另外,若要合并你在应用程序中定义的任何自定义绘图或事件处理,则需使用你自己的应用程序软件编译和链接由 GUIX Studio 生成的输出文件。 我们将使用 Microsoft Visual C++ 工具链作为示例,如果要为预定目标生成并运行,也可采用完全相同的过程。

  • 启动 MSVC IDE,然后打开解决方案 <root>/GUIX_Studio_5.x/examples/demo_guix_widget_types/build/vs_2019/guix_widget_types.sln。

  • 使用 <F7> 键可重新生成解决方案。

  • 使用 <F5> 键可运行该项目。

现在,你应该会看到正在运行的程序,以及你使用 Studio 做出的更改!

了解更多

《GUIX Studio 用户指南》可从 azrtos-guix-studio-user-guide 获取。 《GUIX Studio 用户指南》是介绍如何使用 GUIX Studio 的更全面的指南。

此外,《GUIX 用户指南》可在 azrtos-guix-user-guide 获取。 本指南为你提供了有关 GUIX 应用程序执行时“程序内部”所发生的情况的更多详细信息。 若要充分利用 GUIX 运行时库和 GUIX Studio 的功能,你需要参考这两个指南。

客户支持中心

请按照此处介绍的步骤,在 Azure 门户中提交支持票证,以进行提问或获取帮助。 请在电子邮件中提供以下信息,以便我们可以更高效地解决你的支持请求:

  • 问题的详细说明,包括发生频率以及如何可靠地重现该问题。
  • 附加造成问题的跟踪文件。
  • 你使用的 Azure RTOS GUIX Studio 的版本(在屏幕左上角显示)。
  • 你使用的 Azure RTOS GUIX 的版本包含 _gx_version_idstring 和 _gx_build_options 变量。