AWTK Designer

AWTK Designer简介

答：AWTK Desiger是专门用来制作AWTK应用程序UI界面的实用工具，只要通过拖拽和点击就可以完成复杂的界面设计，操作简单；可以随时预览效果，所见即所得。

如需了解更多或下载AWTK Designer，请前往 AWTK云平台。

AWTK Designer支持什么操作系统？

答：AWTK Designer目前支持Windows x64、Windows x86、Ubuntu等操作系统，如需了解更多或下载AWTK Designer，请前往 AWTK云平台。

AWTK Designer如何续期？

答：AWTK Designer许可证有使用期限，如果许可证到期，将无法继续使用AWTK Designer。如需继续使用AWTK Designer，可按以下步骤，完成许可证续期：

（1）前往 AWTK云平台；

（2）登录帐号后进入"个人信息"页面，绑定公司邮箱并完整填写真实有效的公司信息。

通过管理员审核后将会定期获赠续期卡劵，可用于许可续期，类似Visual Studio社区版。

AWTK Designer安装后有文件缺失？

答：安装AWTK Designer后出现文件缺失的情况，请查看是否有应用程序占用安装目录所在文件夹的资源，确保无资源占用后，再重新安装。

在Ubuntu上安装AWTK Designer提示xxx依赖包无法获取导致安装失败？

答：这可能国内访问是Ubuntu官方源网络不佳导致的，请更换 阿里源 后再重新安装。

运行AWTK Designer提示：获取设备ID失败，错误代码:7？

答：如果在VMware虚拟机中使用AWTK Designer，创建虚拟机时，硬件设置中需要选用IDE硬盘类型，才能获取到设备ID。

另外一种可能性是系统找不到powershell.exe，可以尝试以下两种解决方案（任选一种即可）：

1. 把C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe拷贝到C:/Windows目录下；
2. 把以下的路径加入系统环境变量Path中。

C:\Windows;
C:\Windows\system32;
C:\Windows\System32\Wbem;
C:\Windows\System32\WindowsPowerShell\v1.0;

打开AWTK Designer提示：初始化失败？

答：删除"%appdata%/AWTK Designer/resources/config"目录下的user.json文件，再重新打开AWTK Designer。"%appdata%"通常为C:/Users/【计算机用户名】/AppData/Roaming。

打开AWTK Designer，弹出命令行窗口，然后闪退？

答：请运行AWTK Designer帮助菜单栏中的"检测AWTK开发环境"工具，检查OpenGL驱动，若不符合要求，可以尝试以下两种解决方案（任选一种即可）：

1. 打开Windows系统右下角的"开始"菜单，在"所有程序"->"AWStudio"中选择"切换为兼容模式"，再重新打开AWTK Designer。
2. 升级OpenGL驱动（>=2.0.0），再重新打开AWTK Designer。

打开AWTK Designer，提示：由于找不到VCRUNTIME140.dll，无法继续执行代码？

答：这是由于电脑缺少对应版本的 VC 运行时组件导致的，请前往微软官方提供的 下载链接，下载并安装 Visual C++ Redistributable Package for Visual Studio 2015，安装完成后重启电脑再启动 AWTK Designer。

如何实现多国语言？

答：使用AWTK Designer实现多国语言翻译的具体步骤请查阅《AWTK Designer用户手册》中的"5.1 如何实现多国语言"章节。

edit编辑框控件中的tips属性是否支持多国语言互译？

答：edit控件的tips属性支持多国语言互译，在AWTK Designer的控件属性编辑器的值分组中，点击tips属性右侧的按钮将其设置为"翻译的"即可，也可以直接修改UI文件（.xml），将tips属性改为tr_tips。

如何实现多主题？

答：AWTK Designer在新建项目时会在该项目的design目录下生成default主题文件夹，当单一主题无法满足项目需求时，通过AWTK Designer导航栏中项目设置的"主题"选项页面可快速实现多主题，并可以在项目运行中实时切换。

创建主题的方法请查阅《AWTK Designer用户手册》中的"2.4.1 项目设置"章节。使用多主题时需要注意以下几点：

• default主题必须存在，其他主题是可选的；
• default主题必须具有完整的资源文件，其他主题中只需存放其特有文件即可。
• AWTK项目运行时先在当前主题中查找资源，若不存在，则在default主题中查找，这样可以在最大程度上共享资源数据。

怎么将图片生成.data的位图格式？

答：在AWTK Designer中将资源打包设置中的资源常量格式设置为"位图数据"即可在打包资源的时候生成".data"格式的位图资源。步骤如下：

• 点击导航栏左下角的设置按钮 项目设置 常规；
• 点击"资源的常量格式"右侧的下拉框，选择"位图数据"选项
• 点击确定按钮。

如何设置image控件中图片的旋转角度？

答：在AWTK Designer中可通过修改image控件的rotation属性设置图片的旋转角度，但实现图片的旋转或缩放效果有一个前提条件，即图片的draw_type需设置为icon或center，确保满足该条件后，设置图片旋转角度的步骤如下：

• 在窗体编辑器中选中要设置的image控件 控件属性编辑器 杂项分组；
• 在rotation属性右侧的编辑框中可设置image的初始角度，单位为弧度。

备注：旋转角度以image控件的锚点坐标为中心进行旋转。锚点坐标由anchor_x和anchor_y属性控制，这两个属性在控件属性编辑器的值分组中，取值范围为0~1（0为控件左边或顶部，0.5为控件中间，1为为控件右边或底部）。

如何设置容器控件中的子控件不可见时是否占位？

答：子控件不可见时占位，即为子控件不可见时依然保留其在界面上的布局位置，反之则不保留，在AWTK Designer的控件属性编辑器的布局分组中设置父控件的children_layout属性，步骤如下：

• 在窗体编辑器中选中要设置的容器 控件属性编辑器 布局分组；
• 点击children_layout属性右侧的编辑框，弹出"设置子控件的排版"对话框；
• 点击"不可见的控件"右侧的"占位"单选按钮；
• 点击确定按钮。

该功能在在AWTK中的实现原理如下：

• 设置子控件不可见时不占位，AWTK则跳过不可见子控件的绘制，且不保留其布局位置，直接将下一个可见的子控件绘制该位置上。
• 设置子控件不可见时占位，AWTK同样会跳过不可见子控件的绘制，但保留其布局位置，将下一个可见子控件绘制在原本位置上。

导入自定义控件，激活时提示：AttributeError: AppHelperBase instance has no attribute 'SConscript'

答：由于编译脚本使用了新版本 AWTK 的 scripts/app_helper_base.py 的 API，导致编译失败。请打开控件的 SConstruct 文件，修改 "helpter.SConscript" 为 "SConscript" 之后重新激活即可。

如何在项目工程中引用第三方库？

答：AWTK 项目工程中有 SConstruct 文件，该文件是 SCons 的编译脚本。当开发者需要在程序中使用依赖库或者进行自定义预处理时，需要遵循 Python 语法编写 SConstruct 文件，详见以下文档：

• 如何引用第三方库
• 利用 app_helper 编写 SConstruct

编译项目时，是如何搜索AWTK SDK的？搜索的顺序是什么样的？

答：安装 AWStudio 时会自动添加环境变量 AWTK_SDK_PATH，并将其设置为 AWStudio 内置的 AWTK SDK，它放在 AWStudio 安装目录的 AWTK/SDK 中。编译项目有以下两种方法：

方法一：在 AWTK Designer 中点击"编译"按钮编译项目，此时会去项目设置的指定路径中查找 AWTK SDK（默认为AWTK_SDK_PATH），如果找不到，则编译失败。

方法二：在项目目录下打开终端，执行scons命令编译项目，此时查找 AWTK SDK 目录的顺序如下：

1. 先去上一层目录查找（../awtk），找不到则下一步；
2. 去上两层目录查找（../../awtk），找不到则下一步；
3. 查找环境变量 AWTK_SDK_PATH 设置的目录，如果仍然找不到 AWTK SDK 则编译失败。

资源管理器中图片的"x1、x2、x3、xx"是什么意思？

答：AWTK Designer 项目创建后，design 目录默认有一个名称为"default"的主题目录，其中"images"目录用于存放该主题使用的图片，它包含以下子目录：

• x1：存放普通密度屏幕上使用的图片；
• x2：存放2倍密度屏幕上使用的图片；
• x3：存放3倍密度屏幕上使用的图片；
• xx：存放与屏幕密度无关的图片；

AWTK 运行时会优先在 x1、x2、x3 目录中的其中一个查找图片（比如LCD的DPR=1，则在x1目录），如果找不到，则在xx目录中查找。

备注：设备像素比（DPR）=设备像素（又称物理像素）/设备独立像素（又称密度无关像素或逻辑像素，可以认为是计算机坐标系统中的一个点，代表一个可以由程序使用的虚拟像素），比如DPR=2，则表示1逻辑像素等于2物理像素。

如何裁剪字体

答：如果字库文件过大，可以使用 AWTK Designer 对字库进行裁剪，操作步骤如下：

1. 选择资源管理器中的字体页面，点击"裁剪设置"。

2. 输入想要保留的字体，点击"确定"。

3. 对想要裁剪的字库点击"裁剪字体"。

如何使用点阵字

答：AWTK Designer中提供了工具可以直接生成字体的位图文件供程序使用，操作步骤如下：

1. 点击左下角的"设置"按钮后再点击"项目设置"进入项目设置页面中的常规页面。

2. 将项目设置中的资源打包方式改为"文件+常量"，资源的常量格式修改为带"位图数据"的选项。

3. 点击左侧的"主题"按钮进入主题页面，将裁剪格式修改为"Bitmap"，并根据需要选择字模每像素的位数、保留的字号、以及保留的字符后，点击确定。

4. 完成设置后使用AWTK Designer进行打包就可以生成字体的位图文件。