1# 并发编程框架FFRT 2 - [简介](#简介) 3 - [目录](#目录) 4 - [约束](#约束) 5 - [编译构建](#编译构建) 6 - [linux编译](#linux编译) 7## 简介 8FFRT: Function Flow Runtime， 一种并发编程框架，提供以数据依赖的方式构建异步并发任务的能力；包括数据依赖管理、任务执行器、系统事件处理等。并采用基于协程的任务执行方式，可以提高任务并行度、提升线程利用率、降低系统线程总数；充分利用多核平台的计算资源，保证系统对所有资源的集约化管理。最终解决系统线程资源滥用问题，打造极致用户体验。 9 10功能介绍详见： [FFRT用户指南（docs/user_guide.md）](docs/user_guide.md) 11## 目录 12``` 13 14├── benchmarks # 性能对比测试用例 15├── docs # 用户指南 16├── examples # 使用案例 17├── interfaces # 对外接口目录 18│ └── kits 19│ ├── c 20│ └── cpp 21├── scripts 22├── src 23│ ├── core # 依赖管理模块 24│ ├── dfx # 维测功能 25│ │ ├── bbox # 黑匣子功能实现 26│ │ ├── log # 日志功能 27│ │ └── trace # trace功能 28│ ├── eu # 执行单元 29│ ├── internal_inc # 对内接口目录 30│ ├── queue 31│ ├── sched 32│ ├── sync 33│ └── util 34├── test 35└── tools 36 └── ffrt_trace_process 37``` 38 39## 约束 40 41## 编译构建 42 43### Linux编译: 44快速编译执行example用例： 45```c 46 ./scripts/run_example.sh 47``` 48## LOG配置 491. LOG输出函数可以查看头文件ffrt_log_api.h 502. 提供4个日志级别: FFRT_LOG_ERROR = 0, FFRT_LOG_WARN = 1, FFRT_LOG_INFO = 2, FFRT_LOG_DEBUG = 3, 可通过静态编译宏FFRT_LOG_LEVEL来设置日志级别，默认为ERROR 513. 可通过环境变量FFRT_LOG_LEVEL动态设置ffrt日志级别。示例,设置日志DEBUG级别: 52```c 53 export FFRT_LOG_LEVEL=3 //3为FFRT_LOG_DEBUG的值 54``` 55 56## Benchmarks 57### 测试场景 581. fork_join：通过构造fork/join执行时间，模拟线程创建和堵塞场景； 592. fib：通过构造斐波那契序列，模拟嵌套调用场景； 603. face_story：通过构造人脸数据，模拟人脸检测场景； 61### 测试方法 62```c 63 cd benchmarks 64 ./benchmarks count //count表明执行次数 65``` 66### 测试结果 671. 测试数据和分析归档到benchmarks/output/tag_${stamp}/benchmark_${stamp}.svg，其中stamp是最近一次commit提交时间 682. 测试结果已取平均 69