./trace_streamer trace文件路径名 -e 导出db路径名.db

当前时间戳:执行结果（数字）  
应用运行时间  

0 代表执行成功 1 表示输入文件不匹配， 2 表示解析错误， 3其他错误。

extern "C" {
/* 初始化wasm，在JS中注册回调函数，并返回一段可复用的内存空间，由JS调用
 * 
 * @ replyFunction: 回调函数，返回json格式的数据。
 * @ reqBufferSize: js在wasm中申请的内存大小。
 * @ replyTLVFunction: 回调函数，返回proto格式的sql查询结果。
 * @ ffrtConvertedReply: 回调函数，返回ffrt转换后生成的新trace文件。
 * return: 返回一段内存地址给JS
*/
EMSCRIPTEN_KEEPALIVE uint8_t *Initialize(uint32_t reqBufferSize,
                                         ReplyFunction replyFunction,
                                         TLVReplyFunction replyTLVFunction,
                                         ReplyFunction ffrtConvertedReply)

extern "C" {
/* 初始化wasm，在JS中注册大文件切割或按时间切割文件的回调函数，并返回一段可复用的内存空间，由JS调用
 * 
 * @ splitFileFunction: 回调函数, 返回大文件切割，或者按时间切割后生成的数据。 
 * @ reqBufferSize: js在wasm中申请的内存大小。
 * return: 返回一段内存地址给JS
*/
EMSCRIPTEN_KEEPALIVE uint8_t *InitializeSplitFile(SplitFileFunction splitFileFunction, uint32_t reqBufferSize)

/* 通知wasm,按时间切割文件的时间信息已发送，并且通知时间信息大小为dataLen字节
 * 
 * @ dataLen 切割文件的时间信息长度。 时间数据保存在InitializeSplitFile接口申请的内存中。数据格式:"startTS;endTS;"。
 * return: bool类型。解析切割时间信息成功返回true,否则返回false。
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerSplitFileEx(int dataLen)

/* 通知wasm,按时间切割的文件信息已发送，并且通知发送的文件信息大小为dataLen字节
 * 
 * @ dataLen 已经发送的被切割的文件数据长度，数据内容保存在InitializeSplitFile接口申请的内存中。 
 * @ isFinish bool类型， 被切割的文件数据发送完成为true, 否则为false。
 * return: 切割成功返回0,否则返回-1。
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerReciveFileEx(int32_t dataLen, int32_t isFinish)

/* JS在wasm中申请一段内存，用于传输config配置信息。如： ffrt convert开关，animation开关，taskpool开关等
 * 
 * @ reqBufferSize JS准备申请的内存大小。 
 * return: 返回一段内存地址给JS。
*/
EMSCRIPTEN_KEEPALIVE uint8_t *InitializeParseConfig(uint32_t reqBufferSize)

/* JS通知wasm已经发送了config信息，并通知发送的数据大小。 wasm解析config信息。
 * 
 * @ dataLen JS发送config信息大小， 数据内容保存在InitializeParseConfig接口申请的内存中。
 * return: wasm解析config信息成功返回0，否则返回-1。
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerParserConfigEx(int dataLen)

/* JS通知wasm已经发送大文件切割的时间信息，并通知发送的数据大小。 wasm解析大文件切割的时间信息。
 * 
 * @ dataLen JS发送大文件切割时间信息长度。时间信息格式为proto数据的1024头，保存在InitializeSplitFile接口申请的内存中。
 * return: wasm解析大文件切割时间信息成功返回0，否则返回-1。
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerGetLongTraceTimeSnapEx(int dataLen)

/* JS通知wasm已经发送大文件切割的文件数据，并通知发送的数据大小。
 * 
 * @ dataLen JS发送大文件切割文件数据大小。
 * @ isFinish JS发送数据是否结束。
 * @ pageNum  准备按照第pageNum个文件的时间范围，切割大文件。
 * return: wasm解析大文件切割时间信息成功返回0，否则返回-1。
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerLongTraceSplitFileEx(int dataLen, int32_t isFinish, uint32_t pageNum)

/* 导入so重新符号化业务，JS通知wasm申请内存保存导入so的文件名称，并设置导入so重新符号化的回调函数。
 * 
 * @ parseELFCallback 回调函数
 * @ reqBufferSize 申请的文件大小
 * return: 返回一段内存给JS。
*/
EMSCRIPTEN_KEEPALIVE uint8_t *InitFileName(ParseELFFunction parseELFCallback, uint32_t reqBufferSize)

/* 更新起始结束时间,由JS调用
 * 
 * @ len: 起始和结束时间组成的字符串长度
 * return: 成功返回0。
*/
EMSCRIPTEN_KEEPALIVE int UpdateTraceTime(int len)

/* 设置TraceStreamer和第三方wasm通信的回调函数,并返回一段内存，由JS调用
 * 
 * @ sendDataCallBack:与第三方wasm通信的回调函数
* @ reqBufferSize: 返回的内存长度
* return: 成功返回0
*/
EMSCRIPTEN_KEEPALIVE uint8_t* TraceStreamerSetThirdPartyDataDealer(SendDataCallBack sendDataCallBack, uint32_t reqBufferSize)

/* 设置TraceStreamer可以打印的日志级别，由JS调用
 * 
 * @ level: 允许打印日志的最低级别。
*/
EMSCRIPTEN_KEEPALIVE void TraceStreamerSetLogLevel(uint32_t level)

/* TraceStreamer的数据解析接口，由JS调用
 * 
* @ dataLen: 需要解析的数据源长度
* return: 成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerParseDataEx(int dataLen, bool isFinish)

/* 导入so重新符号化业务的下载so文件接口，由JS调用
 * 
 * @ totalLen: 传输的文件总长度。
 * @ fileNameLen: 传输的文件名长度。
 * @ dataLen: 当前调用传输的文件数据长度。 
 * @ finish: 当前文件是否传输结束。
 * return: wasm下载并保存该文件成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int32_t TraceStreamerDownloadELFEx(int32_t totalLen,
                                                        int32_t fileNameLen,
                                                        int32_t dataLen,
                                                        int32_t finish)

/* TraceStreamer停止解析数据，由JS调用
 * 
* return: 成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerParseDataOver()

/* 数据库操作接口，由JS调用，返回json格式的sql查询结果。
 * 
* @ sqlLen: 需要执行的操作类sql语句长度
* return: 成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerSqlOperateEx(int sqlLen)

/*清空wasm内存中的内容，由JS调用
 * 
* return: 成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerReset()

/*执行查询类sql语句，由JS调用
 * 
* @ sqlLen: 需要执行的查询类sql语句长度
* return: 成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerSqlQueryEx(int sqlLen)

/*取消sql查询，由JS调用。
 * 
* return: 成功返回0。
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerCancel()

/*执行查询类sql语句，由JS调用。返回proto格式的sql查询结果。
 * 
* @ sqlLen: 需要执行的查询类sql语句长度
* return: 成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int32_t TraceStreamerSqlQueryToProtoCallback(int32_t sqlLen)
/*执行metrics数据查询
 * 
* @ sqlLen: 需要执行的查询类sql语句长度
* return: 成功返回0，失败返回-1
*/
EMSCRIPTEN_KEEPALIVE int32_t TraceStreamerSqlMetricsQuery(int32_t sqlLen)

/*发送数据给第三方wasm解析，由TraceStreamer调用
 * 
* @ pluginData: 第三方插件的数据源
* @ len: 数据源长度
* @ componentName: 第三方插件名称
* return: 成功返回0
*/
int TraceStreamerPluginOutSendData(const char* pluginData, int len, const std::string componentName)

/*返回解析数据库
 * 
 * @ fun: 回调函数，负责返回解析生成的数据库。
 * return: 成功返回0
*/
EMSCRIPTEN_KEEPALIVE int32_t WasmExportDatabase(ExportDBCallback fun)

/* 初始化配置接口，由JS调用
 * 
* @ dataLen: 配置字符串的长度
* return: 成功返回0
*/
EMSCRIPTEN_KEEPALIVE int TraceStreamerInitThirdPartyConfig(int dataLen)

} // extern "C"

在通用操作系统中，进程号（pid/tgid）和线程号（tid）可能会被重复用于标识不同的进程或者线程。所以在trace数据源中，进程号（pid）和线程号（tid）也可能被重用。
TraceStreamer在解析数据过程中，使用ipid(internal pid)唯一标识进程， itid(internal tid)唯一标识线程。

./build.sh linux
./build.sh macx

./build.sh wasm