awtk踩坑记录三:移植awtk-mvvm到Awtk Designer项目

  • 从github下载并编译awtk, awtk-mmvm

    awtk: https://github.com/zlgopen/awtk/tree/master

    awtk-mvvm: https://github.com/zlgopen/awtk-mvvm

  • 用awtk-designer新建项目并打开项目目录

  • 首先修改project.json,使其awtk和awtk-mvvm指向上个步骤下载的路径,这样做的目的是使得designer编译调用正确的awtk路径,我的路径是转到d/devtools, 应根据情况自行修改:

{
  "name": "awtk_mvvm_practice_review2",
  "entry": "home_page",
  "awtkRoot": "d:/Devtools/awtk",
  "awtkMvvmRoot": "d:/Devtools/awtk-mvvm",
 ...
}
  • 修改Sconstruct,通过ARGUMENTS启用mvvm:
import os
import scripts.app_helper as app

CUSTOM_WIDGET_LIBS = []

DEPENDS_LIBS = CUSTOM_WIDGET_LIBS + []

ARGUMENTS['WITH_MVVM'] = 'true'
helper = app.Helper(ARGUMENTS)
APP_SRC = os.path.normpath(os.path.join(os.getcwd(), 'src'))
APP_CPPPATH = [
  os.path.join(APP_SRC, 'common'),
  os.path.join(APP_SRC, 'view_models'),
]

helper.set_deps(DEPENDS_LIBS).add_cpppath(APP_CPPPATH).call(DefaultEnvironment)

SConscriptFiles = ['src/SConscript', 'tests/SConscript']
helper.SConscript(SConscriptFiles)

  • 在src新建view_models文件夹,并将gen脚本放入,原版是sh脚本,这里照顾我windows上powershell的需要改成了ps脚本,这个脚本用于生成view_model代码,需要指定index.js, gen_vm_array.js和gen_vm.js的路径,index.js在awtk目录下,而gen_vm_array.js和gen_vm.js在awtk-mvvm目录下:

gen.ps1

node D:/Devtools/awtk/tools/idl_gen/index.js idl.json ../common
node D:/Devtools/awtk-mvvm/tools/view_model_gen/gen_vm_array.js idl.json
node D:/Devtools/awtk-mvvm/tools/view_model_gen/gen_vm.js idl.json

原版gen.sh

node ../../../awtk/tools/idl_gen/index.js idl.json ../common
node ../../../awtk-mvvm/tools/gen_vm_array.js idl.json
node ../../../awtk-mvvm/tools/gen_vm.js idl.json
  • 修改src, 将common下的navigator.hnavigator.c删掉, src下其他所有文件删除对navigator.h头文件引用, 因为mvvm库里也有和窗口导航有关的重名API, 容易引发冲突

  • 8.7 add: 之前做法是直接在application.c自己写函数定义mvvm_app_init和mvvm_app_deinit分别封装mvvm_init和mvvm_deinit, 后来发现这样就没法用jerryscript了,其实awtk-mvvm是有官方的对这两个函数的封装了,这里已经修改,Sorry.

    将mvvm/src下的mvvm_app.inc拷贝到designer项目的src下,在application.c引用:

    mvvm_app.inc

    #include "mvvm/mvvm.h"
    
    #ifndef APP_SCRIPT_MAIN
    #define APP_SCRIPT_MAIN "app"
    #endif
    
    #ifndef APP_SCRIPT_VALUE_CONVERTER
    #define APP_SCRIPT_VALUE_CONVERTER "value_converter"
    #endif
    
    #ifndef APP_SCRIPT_VALUE_VALIDATOR
    #define APP_SCRIPT_VALUE_VALIDATOR "value_validator"
    #endif
    
    #ifndef MVVM_APP_GLOBAL_INIT
    #define MVVM_APP_GLOBAL_INIT()
    #endif /*MVVM_APP_GLOBAL_INIT*/
    
    #ifndef MVVM_APP_GLOBAL_DEINIT
    #define MVVM_APP_GLOBAL_DEINIT()
    #endif /*MVVM_APP_GLOBAL_DEINIT*/
    
    static inline ret_t mvvm_app_run_default_scripts(void) {
    #ifdef WITH_JERRYSCRIPT
      if (mvvm_jerryscript_run(APP_SCRIPT_MAIN) != RET_OK) {
        mvvm_jerryscript_run(APP_SCRIPT_VALUE_CONVERTER);
        mvvm_jerryscript_run(APP_SCRIPT_VALUE_VALIDATOR);
      }
    #endif /*WITH_JERRYSCRIPT*/
    
      return RET_OK;
    }
    
    static ret_t mvvm_app_init(void) {
      mvvm_init();
    
    #ifdef WITH_IOTJS
      mvvm_iotjs_init();
    #endif /*WITH_IOTJS*/
    
    #ifdef WITH_JERRYSCRIPT
      mvvm_jerryscript_init();
    #endif /*WITH_JERRYSCRIPT*/
    
      return RET_OK;
    }
    
    static ret_t mvvm_app_deinit(void) {
    #ifdef WITH_JERRYSCRIPT
      mvvm_jerryscript_deinit();
    #endif /*WITH_JERRYSCRIPT*/
    
    #ifdef WITH_IOTJS
      mvvm_iotjs_deinit();
    #endif /*WITH_IOTJS*/
    
      mvvm_deinit();
    
      return RET_OK;
    }
    
    

    并在application_initapplication_deinit引用:

    #include "awtk.h"
    #include "mvvm/mvvm.h"
    #include "mvvm_app.inc"
    
    ret_t application_init(void) {
      mvvm_app_init();
      return navigator_to("books13");
    }
    
    ret_t application_exit(void) {
      log_debug("application_exit\n");
      mvvm_app_deinit();
      return RET_OK;
    }
    
    
  • 自此移植就差不多了, 现在尝试放一个数据绑定的例子, 修改home_page.xml:

    <window v-model="temperature" v-on:window_open="{fscript, Args=print(&quot;window_open&quot;)}" v-on:window_close="{fscript, Args=print(&quot;window_close&quot;)}" name="home_page">
      <slider name="slider" x="133" y="179" w="214" h="16" v-data:value="{value}" value="40"/>
      <label name="label" x="160" y="124" w="160" h="28" v-data:text="{value}" text="Label"/>
    </window>
    

    在src文件夹的common里写一个Temperature.h:

    /**
     * File:   temperature.h
     * Author: AWTK Develop Team
     * Brief:  temperature
     *
     * Copyright (c) 2020 - 2020  Guangzhou ZHIYUAN Electronics Co.,Ltd.
     *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * License file for more details.
     *
     */
    
    /**
     * History:
     * ================================================================
     * 2020-01-23 Li XianJing <xianjimli@hotmail.com> created
     *
     */
    
    #ifndef TEMPERATURE_H
    #define TEMPERATURE_H
    
    #include "tkc/types_def.h"
    
    BEGIN_C_DECLS
    
    /**
     * @class temperature_t
     *
     * @annotation ["model"]
     * 温度控制器。
     *
     */
    typedef struct _temperature_t {
      /**
       * @property {double} value
       * @annotation ["readable", "writable"]
       * 值。
       */
      double value;
    } temperature_t;
    
    END_C_DECLS
    
    #endif /*TEMPERATURE_H*/
    
    

    跳转到view_models文件夹执行gen脚本, 生成temperature_view_model.htemperature_view_model.c, 以及idl.json.

application.c 中 include mmvm.h 并在application_init中注册temperature的model:

#include "mvvm/mvvm.h"
#include "./view_models/temperature_view_model.h"
...
ret_t application_init(void) {
  mvvm_app_init();
  custom_widgets_register();
  application_on_launch();

  if (strlen(APP_SYSTEM_BAR) > 0) {
    navigator_to(APP_SYSTEM_BAR);
  }

  if (strlen(APP_BOTTOM_SYSTEM_BAR) > 0) {
    navigator_to(APP_BOTTOM_SYSTEM_BAR);
  }
  view_model_factory_register("temperature", temperature_view_model_create);
  return navigator_to(APP_START_PAGE);
}

编写完成, 编译运行:

python ./scripts/update_res.py all
scons AWTK_ROOT='d:/devtools/awtk'
bin/demo.exe

部署到web的build.json:

{
    "name": "awtk_mvvm_project_template",
    "version": "1.0",
    "assets": "res/assets",
    "author": "AWTK Develop Team",
    "copyright": "Guangzhou ZHIYUAN Electronics Co.,Ltd.",
    "themes":["default"],
    "web": {
      "app_type": "c",
      "assets": "design",
      "includes":[
        ".",
        "src",
        "src/common",
        "src/view_models",
        "D:/Devtools/awtk-mvvm/",
        "D:/Devtools/awtk-mvvm/src"
      ],
      "sources": [
        "src/*.c",
        "src/*/*.c",
        "D:/Devtools/awtk-mvvm/src/mvvm/*.c",
        "D:/Devtools/awtk-mvvm/src/mvvm/base/*.c",
        "D:/Devtools/awtk-mvvm/src/mvvm/awtk/*.c",
        "D:/Devtools/awtk-mvvm/src/mvvm/view_models/*.c"
      ],
      "config": {
        "fontScale": "0.8",
        "defaultFont": "sans"
      }
    }
  }
  

8.7 add: 如果要启用jerryscript, 比如用来写一些model脚本,直接在designer项目Sconstruct下加这么一行即可,不需要CV任何文件过去。

ARGUMENTS['WITH_JERRYSCRIPT'] = 'true'
AWTK开发手册-AWTK开发实践指南-中文手册.pdf AWTK = Toolkit AnyWhere 随着手机、智能手表等便携式设备的普及,用户对 GUI 的要求越来越高,嵌入式系统对高性能、高可靠性、低功耗、美观炫酷的 GUI 的需求也越来越迫切,ZLG开源 GUI 引擎 AWTK 应运而生。AWTK 全称为 Toolkit AnyWhere,是 ZLG 倾心打造的一套基于 C 语言开发的 GUI 框架。旨在为用户提供一个功能强大、高效可靠、简单易用、可轻松做出炫酷效果的 GUI 引擎,并支持跨平台同步开发,一次编程,终生使用。 最终目标: 支持开发嵌入式软件。 支持开发Linux应用程序。 支持开发MacOS应用程序。 支持开发Windows应用程序。 支持开发Android应用程序。 支持开发iOS应用程序。 支持开发2D游戏。 其主要特色有: 小巧。在精简配置下,不依赖第方软件包,仅需要32K RAM + 256K FLASH即可开发一些简单的图形应用程序。 高效。采用脏矩形裁剪算法,每次只绘制和更新变化的部分,极大提高运行效率和能源利用率。 稳定。通过良好的架构设计和编程风格、单元测试、动态(valgrind)检查和Code Review保证其运行的稳定性。 丰富的GUI组件。提供窗口、对话框和各种常用的组件(用户可以配置自己需要的组件,降低对运行环境的要求)。 支持多种字体格式。内置位图字体(并提供转换工具),也可以使用stb_truetype或freetype加载ttf字体。 支持多种图片格式。内置位图图片(并提供转换工具),也可以使用stb_image加载png/jpg等格式的图片。 紧凑的二进制界面描述格式。可以手工编辑的XML格式的界面描述文件,也可以使用Qt Designer设计界面,然后转换成紧凑的二进制界面描述格式,提高运行效率,减小内存开销。 支持主题并采用紧凑的二进制格式。开发时使用XML格式描述主题,然后转换成紧凑的二进制格式,提高运行效率,减小内存开销。 支持裸系统,无需OS和文件系统。字体、图片、主题和界面描述数据都编译到代码中,以常量数据的形式存放,运行时无需加载到内存。 内置nanovg实现高质量的矢量动画,并支持SVG矢量图。 支持窗口动画、控件动画、滑动动画和高清LCD等现代GUI常见特性。 支持国际化(Unicode、字符串翻译和输入法等)。 可移植。支持移植到各种RTOS和嵌入式Linux系统,并通过SDL在各种流行的PC/手机系统上运行。 脚本化。从API注释中提取API的描述信息,通过这些信息可以自动生成各种脚本的绑定代码。 支持硬件2D加速(目前支持STM32的DMA2D和NXP的PXP)和GPU加速(OpenGL/OpenGLES/DirectX/Metal),充分挖掘硬件潜能。 丰富的文档和示例代码。 采用LGPL协议开源发布,在商业软件中使用时无需付费。 目前核心功能已经完成,内部开始在实际项目中使用了,欢迎有兴趣的朋友评估和尝试,期待您的反馈。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值