如何新增一个应用目录

新增一个内置应用

应用注册

在solution/example/xxx/application中添加应用目录,目录里添加源代码和SConscript脚本,SConscript语法参考RT-Thread官网。 内置应用注册参考"UI应用笔记-应用-如何创建一个内置应用及子页面"章节创建应用

资源添加

在solution/example/xxx/resource/images路径里添加资源目录,目录名一般建议和应用目录名保持一致,便于对应查找资源。

  • 内置应用默认支持两种风格的缩略图,图标放置到内置资源应用目录内,如sport应用,则放置到solution/example/xxx/resource/images/sport目录,放置规则参考"快速入门-图片资源"章节图片资源

  • 默认风格缩略图名需要和"APPLICATION_REGISTER"注册接口中的资源名相同

  • 第二种风格名称需要在默认风格名后添加2,如:sport应用的的默认缩略图名是"img_sport.png",第二种风格名称则必须是"img_sport2.png"(以此类推,第三种是img_sport3.png…), 应用注册接口"APPLICATION_REGISTER"中的资源名称则是"img_sport"。

注意:

  • 主菜单显示的设置的子页面图标,默认风格图标是放置到solution/example/xxx/resource/images/mainmenu目录,第二种风格图标放到solution/example/xxx/resource/images/mainmenu2目录。

新增一个外置应用

应用注册

在solution/example/_dynamic_app/c/app/中加添应用目录,在应用目录里添加resource资源目录,src代码目录,readme.ini编译依赖,Sconscript连接脚本 外置应用注册参考动态app编写

资源添加

外置应用资源放置到resource目录

  1. 缩略图添加
    外置应用默认支持两种风格的缩略图(和主代码保持一致),默认风格缩略图命名固定为tn.png,放置在thumbnails目录,第二种风格命名固定为tn2.png,放置在images目录(以此类推,第三种是tn3.png…)。

  2. 其他资源添加
    多语言翻译表放置在lang目录, bitmap字体放置在font_bitmap种。其余图片资源放置在images目录。 具体可以参考外置应用目录结构

新增应用分辨率支持

通过butterfli工具"转换"功能可以将应用目录下源分辨率的资源转换成目标分辨率,如以下步骤:

  1. 打开butterfli工具右上角"转换"功能。

  2. 填入"搜索路径",“源分辨率”,"目标分辨率"参数,点击转换。

  3. 查看转换结果,如果成功将会在有源分辨率的目录下生成目标分辨率目录。

注意:

  1. common目录不会参与转换

  2. 使用前需要安装ImageMagic转换工具

  3. 对于外置应用,还需要修改readme.ini来增加分辨率支持

  4. apng资源暂不支持自动转换,需要手动转换

应用全分辨支持

  1. common目录是所有分辨率共用的图片资源, 将应用的资源都放到对应的common目录中即可支持全分辨率。 参考"快速入门-图片资源"章节说明图片资源

  2. 对于外置应用,在.INI配置中将RES_NUM置为0,参考动态应用编译依赖