resourceschedule_ffrt/README.md

并发编程框架FFRT

• 简介
• 目录
• 约束
• 编译构建
  • linux编译

简介

FFRT: Function Flow Runtime， 一种并发编程框架，提供以数据依赖的方式构建异步并发任务的能力；包括数据依赖管理、任务执行器、系统事件处理等。并采用基于协程的任务执行方式，可以提高任务并行度、提升线程利用率、降低系统线程总数；充分利用多核平台的计算资源，保证系统对所有资源的集约化管理。最终解决系统线程资源滥用问题，打造极致用户体验。

功能介绍详见： FFRT用户指南（docs/user_guide.md）

目录

├── benchmarks                  # 性能对比测试用例
├── docs                        # 用户指南
├── examples                    # 使用案例
├── interfaces                  # 对外接口目录
│   └── kits
│       ├── c
│       └── cpp
├── scripts
├── src
│   ├── core                    # 依赖管理模块
│   ├── dfx                     # 维测功能
│   │   ├── bbox                # 黑匣子功能实现
│   │   ├── log                 # 日志功能
│   │   └── trace               # trace功能
│   ├── eu                      # 执行单元
│   ├── internal_inc            # 对内接口目录
│   ├── queue
│   ├── sched
│   ├── sync
│   └── util
├── test
└── tools
    └── ffrt_trace_process

约束

编译构建

Linux编译

当前ffrt编译依赖三方安全库的功能，需要把三方安全库的代码一并下载到本地。 三方安全库代码仓：https://gitee.com/openharmony/third_party_bounds_checking_function 注意：在ffrt代码同目录新建文件夹third_party,再将安全库代码放到third_party下，文件夹命名要求为bounds_checking_function. 文件结构示意如下：

├── resourceschedule_ffrt
├── third_party
│   └── bounds_checking_function

再进入到ffrt代码路径下，执行scripts下的sh脚本(sh scripts/run_example.sh)。

LOG配置

1. LOG输出函数可以查看头文件ffrt_log_api.h
2. 提供4个日志级别: FFRT_LOG_ERROR = 0, FFRT_LOG_WARN = 1, FFRT_LOG_INFO = 2, FFRT_LOG_DEBUG = 3, 可通过静态编译宏FFRT_LOG_LEVEL来设置日志级别，默认为ERROR
3. 可通过环境变量FFRT_LOG_LEVEL动态设置ffrt日志级别。示例,设置日志DEBUG级别:

    export FFRT_LOG_LEVEL=3  //3为FFRT_LOG_DEBUG的值

Benchmarks

测试场景

1. fork_join：通过构造fork/join执行时间，模拟线程创建和堵塞场景；
2. fib：通过构造斐波那契序列，模拟嵌套调用场景；
3. face_story：通过构造人脸数据，模拟人脸检测场景；

测试方法

    cd benchmarks
    ./benchmarks count //count表明执行次数

测试结果

1. 测试数据和分析归档到benchmarks/output/tag_${stamp}/benchmark_${stamp}.svg，其中stamp是最近一次commit提交时间
2. 测试结果已取平均