# 2. 使用自定义控件

# 2.1 安装自定义控件

Designer 的插件管理页面提供了一些推荐的自定义控件,用户可以直接安装到项目当中使用,安装完成后使用步骤与其他的内置控件一样,非常方便。

此处在插件管理页面安装 number_label 控件,安装成功后控件会被添加到"已安装"分组,并且 Designer 右下角会弹出安装成功提示框,点击"刷新"按钮后,就可以在控件列表的"自定义"分组中找到安装的 number_label 控件了,后续的使用步骤与其他内置的普通控件一样。

图2.1 安装自定义控件
图2.1 安装自定义控件

自定义控件会被安装在项目的 3rd 目录下,比如此处的 3rd/awtk-widget-number-label,并且 Designer 会自动完成以下工作:

  1. 在项目的编译脚本(SConstruct)中引用自定义控件的动态链接库。
  2. 在项目的 src/application.c 中添加自定义控件的注册代码。

# 2.2 卸载自定义控件

如果不想在当前的项目中继续使用某个自定义控件,可以在 Designer 插件管理页面的"已安装"分组中将其卸载,卸载成功后 Designer 会删除 3rd 目录下的本地文件并清除安装时自动添加的代码,并且右下角会弹出卸载成功提示框,点击"刷新"按钮后,控件列表的"自定义"分组就会清除该控件,如下图所示:

图2.2 卸载自定义控件
图2.2 卸载自定义控件

自定义控件被卸载后,原自定义控件将识别为虚拟的占位控件。如果后续没有另行注册同名的自定义控件,那么运行时会出现断言错误,关于占位控件的更多信息,请查阅本文第四章。

# 2.3 导入自定义控件

安装 Designer 中的提供的推荐自定义控件需要联网下载,如果电脑处于离线状态,本地有下载好的且符合规范的自定义控件,那么可以直接在 Designer 的插件管理页面中导入这些自定义控件,如下图所示,导入完成后,安装和使用的步骤与其他推荐的自定义控件一样。

图2.3 导入第三方自定义控件
图2.3 导入第三方自定义控件

这些本地的自定义控件可以是 AWTK 团队开发的,也可以是第三方开发的,只要符合 AWTK 自定义控件规范 (opens new window) 就能正常导入并使用。