ACE开发框架

    目录

    轻量ACE 框架源代码在/foundation/ace下，目录结构如下图所示：

    • 语言版本
      • C++11版本或以上
      • JavaScript ES5.1+

    • 框架运行内存通常分为如下组成部分：

        1. 运行时引擎的预分配内存，该内存值可调，取决于具体设备应用复杂度，通常建议64K~512K
        1. 框架本身内存，在百K级的内存设备上，通常通过预分配一个内存池进行管理，可以和UIKit共用一个内存池，包含了对象和堆内存统一管理

    • 框架针对不同的芯片平台和底层OS能力，规格有所区别

      • Cortex-M RAM/ROM：

        • JS引擎内存池: 建议大于48K
        • RAM：建议大于80K
        • ROM: > 300K （包含ACE，UIKit及引擎等强相关子系统）

      • Cortex-A RAM/ROM:

        • JS引擎内存池: 建议大于128K
        • ROM：> 2M （包含ACE，UIKit及引擎等强相关子系统）

    使用targets

    ACE框架通过一些特性宏来定制不同平台上参与编译的功能代码，该部分代码位于 foundation/ace/frameworks/lite/targets 目录下，目录结构如下：

    2. ├── default/
    3. │   └── acelite_config.h
    4. ├── linux/ #linux环境配置文件目录
    5. │   └── acelite_config.h
    6. ├── liteos_a/ #LiteOS A核环境配置文件目录
    7. │   └── acelite_config.h
    8. ├── liteos_m/ #LiteOS M核环境配置文件目录
    9. │   └── acelite_config.h
    10. ├── platform_adapter.cpp
    11. ├── platform_adapter.h
    12. └── simulator/ #模拟器环境配置文件目录
    13.     └── win/

    在编译不同的平台目标时，需要使用对应平台目录下的acelite_config.h 头文件，这可以通过配置编译时的搜索路径来进行，以下以 ninja和cmake 构建工具为例进行示例：

    ninja：

    cmake：

    1. ......
    2. set(ACE_LITE_CONFIG_PATH "${CMAKE_CURRENT_SOURCE_DIR}/targets/simulator/win")
    3. set(JSFWK_INCLUDE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/include")
    4. set(JSFWK_SOURCE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/src/core")
    5. set(UIKIT_PATH "${CMAKE_CURRENT_SOURCE_DIR}/../ui")
    6. set(THIRTY_PATH "${CMAKE_CURRENT_SOURCE_DIR}/../../../third_party")
    7. set(JS_API_PATH "${CMAKE_CURRENT_SOURCE_DIR}/../../api/emui_band/MoltenCore/application/framework/ace/api")
    8. set(JSFWK_SIMULATOR_PATH "${CMAKE_CURRENT_SOURCE_DIR}/../tools/simulator")
    9. set(AAFWK_PATH "${CMAKE_CURRENT_SOURCE_DIR}/../../../aafwk")
    11. # header files
    13.     ${ACE_LITE_CONFIG_PATH}
    14.     ${JSFWK_INCLUDE_PATH}/async
    15.     ${JSFWK_INCLUDE_PATH}/base
    16.     ${JSFWK_INCLUDE_PATH}/context
    17.     ${JSFWK_INCLUDE_PATH}/jsi
    18.     ${JSFWK_SOURCE_PATH}
    19.     ......

    acelite_config.h主要用于对应平台的特性宏开关，也可用来进行一些屏蔽平台差异的定义，如不同平台由于使用的文件系统不一致，可能存在一些固定目录路径名不一样的情况，这些有区别的常量可以放在这里进行定义，如下：

    liteos-a/acelite_config.h

    1. #define JS_FRAMEWORK_PATH "..\\..\\..\\jsfwk\\packages\\runtime-core\\build"

    为了实现单向数据绑定机制，轻量ACE 框架使用JavaScript语言实现了一套简单的数据劫持框架，称之为runtime-core，目录结构如下所示：

    支持的NPM 命令有：

    • npm run build

      ACE 所集成的JS 引擎仅支持ES5.1语法，runtime-core源代码是使用ES6源码书写的。因此选择使用rollup做为打包工具，配合babel实现对JavaScript语法进行降级处理。只要命令行中执行命令npm run build，会在build目录下输出打包结果，输出结果如下所示：

      1. build/
      2. ├── framework-dev.js // 开发环境使用的框架代码（未压缩混淆）
      3. ├── framework-dev.min.js // 开发环境使用的框架代码（已压缩混淆）
      4. ├── framework.js // 生产环境使用的框架代码（未压缩混淆）

    • npm run test

      runtime-core使用jest进行单元测试，在命令行中执行npm run test即可触发。

    涉及仓

    ace_interfaces_innerkits_builtin