AWTK 界面库如何封装

沉默流星

官网如下：


不过他编译代码使用的scons构建工具进行编译。

沉默流星

1. # 特殊平台编译配置
   
2. 
   
3. 有些平台编译比较特殊，不能使用 scons 编译，也不能使用 keil 编译。我们用一个配置文件描述项目，然后用脚本来编译或生成项目模板。目前有 web、ios 和 android 版本使用这种方式。
   
4. 
   
5. 配置文件采用 JSON 格式，位置放在项目的根目录下，推荐命名为 build.json。
   
6. 
   
7. ## 一、通用选项
   
8. 
   
9. * name 应用程序名称（不支持中文和特殊符号）。
   
10. * vendor 开发商。
    
11. * version 版本号。
    
12. * assets 资源所在的目录（相对于配置文件所在的目录，android/ios 一般使用"res/assets", web 一般使用 design）。
    
13. * sources 源文件列表（相对于配置文件所在的目录）。文件名支持通配符如*.c。只要添加应用程序本身和使用的第三方库的源码即可，AWTK 本身用到的代码会自动添加。
    
14. * includes 头文件搜索路径列表（相对于配置文件所在的目录）。
    
15. 
    
16. > sources 虽然是通用选项，但是不同平台，包含的源文件可能并不相同，此时应该放到具体平台之下，如果两者都有，则对其进行合并。
    
17. 
    
18. ## 二、web 平台选项
    
19. 
    
20. web 平台选项放在 web 子键下面，目前支持以下选项：
    
21. 
    
22. * app_type 目前可选择的值有。"c" 表示用 C 语言开发的应用程序，"js"表示用 Javascript 开发的应用程序。
    
23. 
    
24. * romfs（可选） 用于指定配置文件的目录，编译脚本将该目录打包成 romfs，在 AWTK-WEB 中可以通过 os_fs 访问。
    
25.   
    
26. * config 用于指定一些运行参数。
    
27.   * width 如果应用开发时没有做自适应性布局，可以用 width 参数指定画布的宽度。
    
28.   * height 如果应用开发时没有做自适应性布局，可以用 height 参数指定画布的高度。
    
29.   * defaultFont 缺省字体。缺省为"sans"。
    
30.   * fontScale 字体的缩放比例。缺省为 1。
    
31. 
    
32. * depends 依赖自定义控件的目录（该目录下需要提供 export.json，具体描述见后面）
    
33.   
    
34. 
    
35. > config 中的参数也可以直接在 URL 中指定。如：
    
36. 
    
37. ```
    
38. http://192.168.1.117:8080/demoui/index.html?width=480&height=800&fontScale=0.8&defaultFont=serif
    
39. ```
    
40. 
    
41. 如：
    
42. 
    
43. 用 C 语言写的 demoui 的配置文件：
    
44. 
    
45. ```
    
46.   "web": {
    
47.     "app_type": "c",
    
48.     "assets": "design",
    
49.     "romfs": "data",
    
50.     "depends":["../awtk-widget-html-view"],
    
51.     "sources": [
    
52.       "demos/*.c"
    
53.     ],  
    
54.     "config": {
    
55.       "fontScale": "0.8",
    
56.       "defaultFont": "sans"
    
57.     }   
    
58.   }
    
59. ```
    
60. 
    
61. 用 Javascript 写的 demoui 的配置文件：
    
62. 
    
63. ```
    
64. {
    
65.   "name":"demouijs",
    
66.   "version":"1.0",
    
67.   "app_type":"js",
    
68.   "assets": "design",  
    
69.   "sources":["./design/default/scripts/basic.js"]
    
70. }
    
71. ```
    
72. 
    
73. ## 三、android 平台选项
    
74. 
    
75. android 平台选项放在 android 子键下面，目前支持以下选项：
    
76. 
    
77. * app_name 应用程序的完整名称。如：org.zlgopen.demoui
    
78. * cflags C 代码额外的编译参数。
    
79. * cppflags C++代码额外的编译参数。
    
80. * linkflags 额外的链接参数。
    
81. * features 平台专用特性。目前支持：
    
82.   * fullscreen 是否全屏。true 表示全屏，false 表示不全屏。
    
83. 
    
84. 示例：
    
85. 
    
86. ```
    
87.   "android": {
    
88.     "features": {
    
89.       "fullscreen":true
    
90.     },   
    
91.     "app_name": "org.zlgopen.demoui",
    
92.     "sources": [
    
93.       "demos/assets.c",
    
94.       "demos/demo_ui_app.c",
    
95.       "demos/vg_common.inc",
    
96.       "res/assets.inc",
    
97.       "res/assets/__assets_default.inc"
    
98.     ]
    
99.   },
    
100. ```
     
101. 
     
102. ## 四、 ios 平台选项
     
103. 
     
104. * app_name 应用程序的完整名称。如：org.zlgopen.demoui
     
105. * defines 宏定义。ios 和 android 定义方式有些不同，宏定义要放到 defines 中，而不能放到 cflags 和 cppflags。格式也有些不同，如：
     
106. 
     
107. ```
     
108. "defines":" HAVE_CONFIG_H=1 BUILDING_LIBCURL=1 WITH_CURL=1 ",
     
109. ```
     
110. 
     
111. ```
     
112.   "ios": {
     
113.     "app_name": "org.zlgopen.demoui",
     
114.     "sources": [
     
115.       "demos/assets.c",
     
116.       "demos/demo_ui_app.c",
     
117.       "demos/vg_common.inc",
     
118.       "res/assets.inc",
     
119.       "res/assets/__assets_default.inc"
     
120.     ]
     
121.   }
     
122. ```
     
123. 
     
124. ## 五、harmonyos 平台选项
     
125. 
     
126. harmonyos 平台选项放在 harmonyos 子键下面。
     
127. 
     
128. * icon 图标。
     
129. * title 标题，下面包含不同语言的翻译。
     
130. 
     
131. ```  
     
132.   "title": {
     
133.     "en_US": "DemoUI",
     
134.     "zh_CN": "控件演示"
     
135.   },
     
136. ```
     
137. 
     
138. ## 六、完整示例
     
139. 
     
140. 下面是 demoui 的完整示例
     
141. 
     
142. ```
     
143. {
     
144.   "name": "demoui",
     
145.   "version": "1.0",
     
146.   "assets": "res/assets",
     
147.   "vendor": "zlgopen",
     
148.   "app_name": "org.zlgopen.demoui",
     
149.   "author": "xianjimli@hotmail.com",
     
150.   "copyright": "Guangzhou ZHIYUAN Electronics Co.,Ltd.",
     
151.   "themes":["default", "dark"],
     
152.   "sources": [
     
153.      "demos/assets.c",
     
154.      "demos/vg_common.inc",
     
155.      "demos/demo_ui_app.c",
     
156.      "res/assets.inc",
     
157.      "res/assets/__assets_dark.inc",
     
158.      "res/assets/__assets_default.inc"
     
159.   ],
     
160.   "web": {
     
161.     "app_type": "c",
     
162.     "assets": "design",
     
163.     "config": {
     
164.       "fontScale": "0.8",
     
165.       "defaultFont": "sans"
     
166.     }
     
167.   },
     
168.   "harmonyos": {
     
169.     "icon": "design/default/images/xx/awtk_icon.png",
     
170.     "title": {
     
171.       "en_US": "DemoUI",
     
172.       "zh_CN": "控件演示"
     
173.     },
     
174.     "sources": [
     
175.     ]
     
176.   },
     
177.   "android": {
     
178.     "sources": [
     
179.     ]
     
180.   },
     
181.   "ios": {
     
182.     "sources": [
     
183.     ]
     
184.   }
     
185. }
     
186. ```
     
187. 
     
188. ## 七、export.json 的用法
     
189. 
     
190. > 为了方便引用自定义控件，自定义控件（包括无界面的库）需要提供一个 export.json 的配置文件，用于声明对外提供的源文件和编译参数。
     
191. 
     
192. * sources 源文件列表（相对于配置文件所在的目录）。文件名支持通配符如*.c。
     
193.   
     
194. * includes 头文件搜索路径列表（相对于配置文件所在的目录）。
     
195. 
     
196. * cflags C 语言的编译参数。
     
197. 
     
198. * cxxflags C++语言的编译参数。
     
199.   
     
200. * depends 依赖其它自定义控件的目录。
     
201. 
     
202. 示例：
     
203. 
     
204. ```json
     
205. {
     
206.   "cflags":["-DLITEHTML_UTF8=1"],
     
207.   "cxxflags":[""],
     
208.   "includes":[
     
209.     "src",
     
210.     "src/litehtml",
     
211.     "src/litehtml/src",
     
212.     "src/litehtml/include",
     
213.     "src/litehtml/src/gumbo/include",
     
214.     "src/litehtml/src/gumbo/include/gumbo",
     
215.     "src/litehtml/include/litehtml"
     
216.   ],  
     
217.   "sources":[
     
218.     "src/*.c",
     
219.     "src/*.cpp",
     
220.     "src/litehtml/src/*.cpp",
     
221.     "src/litehtml/src/gumbo/*.c",
     
222.     "src/html_view/*.cpp",
     
223.     "src/html_view/*.c"
     
224.   ]
     
225. }
     
226. ```
     
227. 
     
228. ## 八、示例与参考
     
229. 
     
230. * [awtk-http-client 的配置文件](https://github.com/zlgopen/awtk-http-client/blob/master/build.json)
     
231. 
     
232. * [awtk-hello 的配置文件](https://github.com/zlgopen/awtk-hello/blob/master/build.json)
     
233. 
     
234. * [Android/IOS 插件的配置文件](https://github.com/zlgopen/awtk-mobile-plugins/blob/master/build.json)
     
235. 
     
236. * [awtk-web-js 的配置文件](https://github.com/zlgopen/awtk-jerryscript/blob/master/build_web.json)
     

复制代码

沉默流星

小小小小鸟

有没有静态库，编译出来文件体积会增大多少？如果是动态库，dll大小是多少？

沉默流星

小小小小鸟 发表于 2025-10-2 18:49
有没有静态库，编译出来文件体积会增大多少？如果是动态库，dll大小是多少？ ...

有没有静态库取决你自己编译源码，这个是开源的可以自己编译，不过不能使用cmake编译，而是使用scons

C++的开源界面库没有几个，好用的更没几个。
吴总就算封装也不好挑

朕的

沉默流星 发表于 2025-10-2 18:58
有没有静态库取决你自己编译源码，这个是开源的可以自己编译，不过不能使用cmake编译，而是使用scons

C+ ...

这个GUI是咋授权的？收费的吧？

67564226

这个确实看起来不错.

沉默流星

朕的 发表于 2025-10-2 19:12
这个GUI是咋授权的？收费的吧？

社区版是免费的，专业版需要付费。

adm

这个可以哦！刚好精益在转型，吴总封装上UI界面库能吸引数不胜数的易用户来@飞扬工作室

Xelloss0618

这个主要是做单片机之类的嵌入式界面，不知道在桌面平台怎样，估计控件不会太多